diff --git a/CHANGELOG.md b/CHANGELOG.md index b6182da3a..ef216818f 100644 --- a/CHANGELOG.md +++ b/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) diff --git a/src/CSSList/CSSList.php b/src/CSSList/CSSList.php index 35791089d..9f1b9d0bd 100644 --- a/src/CSSList/CSSList.php +++ b/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 { diff --git a/src/CSSList/Document.php b/src/CSSList/Document.php index 51d87a4af..3177edfbb 100644 --- a/src/CSSList/Document.php +++ b/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 { diff --git a/src/Parsing/ParserState.php b/src/Parsing/ParserState.php index cb28cdb04..651c6d642 100644 --- a/src/Parsing/ParserState.php +++ b/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) { diff --git a/src/Rule/Rule.php b/src/Rule/Rule.php index ee15059b8..ad65ce896 100644 --- a/src/Rule/Rule.php +++ b/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 { diff --git a/src/RuleSet/DeclarationBlock.php b/src/RuleSet/DeclarationBlock.php index 2ca5de28f..446dbc282 100644 --- a/src/RuleSet/DeclarationBlock.php +++ b/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) { diff --git a/src/RuleSet/RuleSet.php b/src/RuleSet/RuleSet.php index 66a9043cf..ab0a5aca0 100644 --- a/src/RuleSet/RuleSet.php +++ b/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 { diff --git a/src/Value/CSSFunction.php b/src/Value/CSSFunction.php index 110c99075..b2a7d7e32 100644 --- a/src/Value/CSSFunction.php +++ b/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 { diff --git a/src/Value/CSSString.php b/src/Value/CSSString.php index b0c92e4cc..529e0f562 100644 --- a/src/Value/CSSString.php +++ b/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 { diff --git a/src/Value/CalcFunction.php b/src/Value/CalcFunction.php index 5d84a9a80..2cd9f6633 100644 --- a/src/Value/CalcFunction.php +++ b/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 { diff --git a/src/Value/Color.php b/src/Value/Color.php index 16e7dbd86..76b81a04c 100644 --- a/src/Value/Color.php +++ b/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 { diff --git a/src/Value/LineName.php b/src/Value/LineName.php index 6caa86173..d9874a819 100644 --- a/src/Value/LineName.php +++ b/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 { diff --git a/src/Value/Size.php b/src/Value/Size.php index ad38de1d9..495c098a0 100644 --- a/src/Value/Size.php +++ b/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 { diff --git a/src/Value/URL.php b/src/Value/URL.php index 1608d12dc..5f80b3eb2 100644 --- a/src/Value/URL.php +++ b/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 { diff --git a/src/Value/Value.php b/src/Value/Value.php index 4e27b668c..4410551a1 100644 --- a/src/Value/Value.php +++ b/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) {