diff --git a/CHANGELOG.md b/CHANGELOG.md index 08eb305a..e0b95a16 100644 --- a/CHANGELOG.md +++ b/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) diff --git a/src/CSSList/CSSList.php b/src/CSSList/CSSList.php index d0a8bbbc..5b8f41d5 100644 --- a/src/CSSList/CSSList.php +++ b/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) { diff --git a/src/CSSList/Document.php b/src/CSSList/Document.php index 7d9c6ec0..f74c8964 100644 --- a/src/CSSList/Document.php +++ b/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) { diff --git a/src/Parsing/ParserState.php b/src/Parsing/ParserState.php index 2427c5e1..574f60f3 100644 --- a/src/Parsing/ParserState.php +++ b/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) { diff --git a/src/Rule/Rule.php b/src/Rule/Rule.php index ae3c595f..fe706191 100644 --- a/src/Rule/Rule.php +++ b/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) { diff --git a/src/RuleSet/DeclarationBlock.php b/src/RuleSet/DeclarationBlock.php index be22760b..60d0b0c4 100644 --- a/src/RuleSet/DeclarationBlock.php +++ b/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) { diff --git a/src/RuleSet/RuleSet.php b/src/RuleSet/RuleSet.php index e90694ae..0cf7ac95 100644 --- a/src/RuleSet/RuleSet.php +++ b/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) { diff --git a/src/Value/CSSFunction.php b/src/Value/CSSFunction.php index c7024ea5..de8e558f 100644 --- a/src/Value/CSSFunction.php +++ b/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) { diff --git a/src/Value/CSSString.php b/src/Value/CSSString.php index c19b238f..0251dc7c 100644 --- a/src/Value/CSSString.php +++ b/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) { diff --git a/src/Value/CalcFunction.php b/src/Value/CalcFunction.php index a3db2710..70f2f458 100644 --- a/src/Value/CalcFunction.php +++ b/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) { diff --git a/src/Value/Color.php b/src/Value/Color.php index a002760b..fbbf11a1 100644 --- a/src/Value/Color.php +++ b/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) { diff --git a/src/Value/LineName.php b/src/Value/LineName.php index 588cb4cb..5b59fce5 100644 --- a/src/Value/LineName.php +++ b/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) { diff --git a/src/Value/Size.php b/src/Value/Size.php index 8907526a..2e45d272 100644 --- a/src/Value/Size.php +++ b/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) { diff --git a/src/Value/URL.php b/src/Value/URL.php index 92da9726..7d5bd8e8 100644 --- a/src/Value/URL.php +++ b/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) { diff --git a/src/Value/Value.php b/src/Value/Value.php index 6232d126..3816289d 100644 --- a/src/Value/Value.php +++ b/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) {