[CLEANUP] Use common ancestor Value in type specifications (#507)

Replace the list of various possible sub-types with the common ancestor.

Update the class diagram to indicate that `ValueList::$aComponents` no longer
has a dependency on the sub-types definitions.

Resolves #499. 
Supersedes and closes #506.

Author: JakeQZ

README.md

@@ -813,12 +813,7 @@ classDiagram
     RuleSet --> "*" Comment : aComments
     RuleSet --> "*" Rule : aRules
     URL --> "1" CSSString : oURL
-    ValueList --> "*" CSSFunction : aComponents
-    ValueList --> "*" CSSString : aComponents
-    ValueList --> "*" LineName : aComponents
-    ValueList --> "*" RuleValueList : aComponents
-    ValueList --> "*" Size : aComponents
-    ValueList --> "*" URL : aComponents
+    ValueList --> "*" Value : aComponents
 ```
 
 ## Contributors/Thanks to

src/Value/CSSFunction.php

@@ -18,7 +18,7 @@ class CSSFunction extends ValueList
 
     /**
      * @param string $sName
-     * @param RuleValueList|array<int, RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string> $aArguments
+     * @param RuleValueList|array<int, Value|string> $aArguments
      * @param string $sSeparator
      * @param int $iLineNo
      */
@@ -72,7 +72,7 @@ public function setName($sName)
     }
 
     /**
-     * @return array<int, RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string>
+     * @return array<int, Value|string>
      */
     public function getArguments()
     {

src/Value/Color.php

@@ -14,7 +14,7 @@
 class Color extends CSSFunction
 {
     /**
-     * @param array<int, RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string> $aColor
+     * @param array<int, Value|string> $aColor
      * @param int $iLineNo
      */
     public function __construct(array $aColor, $iLineNo = 0)
@@ -125,15 +125,15 @@ private static function mapRange($fVal, $fFromMin, $fFromMax, $fToMin, $fToMax)
     }
 
     /**
-     * @return array<int, RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string>
+     * @return array<int, Value|string>
      */
     public function getColor()
     {
         return $this->aComponents;
     }
 
     /**
-     * @param array<int, RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string> $aColor
+     * @param array<int, Value|string> $aColor
      *
      * @return void
      */

src/Value/LineName.php

@@ -10,7 +10,7 @@
 class LineName extends ValueList
 {
     /**
-     * @param array<int, RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string> $aComponents
+     * @param array<int, Value|string> $aComponents
      * @param int $iLineNo
      */
     public function __construct(array $aComponents = [], $iLineNo = 0)

src/Value/Value.php

@@ -30,14 +30,14 @@ public function __construct($iLineNo = 0)
     /**
      * @param array<array-key, string> $aListDelimiters
      *
-     * @return RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string
+     * @return Value|string
      *
      * @throws UnexpectedTokenException
      * @throws UnexpectedEOFException
      */
     public static function parseValue(ParserState $oParserState, array $aListDelimiters = [])
     {
-        /** @var array<int, RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string> $aStack */
+        /** @var array<int, Value|string> $aStack */
         $aStack = [];
         $oParserState->consumeWhiteSpace();
         //Build a list of delimiters and parsed values

src/Value/ValueList.php

@@ -13,7 +13,7 @@
 abstract class ValueList extends Value
 {
     /**
-     * @var array<int, RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string>
+     * @var array<int, Value|string>
      */
     protected $aComponents;
 
@@ -23,8 +23,7 @@ abstract class ValueList extends Value
     protected $sSeparator;
 
     /**
-     * phpcs:ignore Generic.Files.LineLength
-     * @param array<int, RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string>|RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string $aComponents
+     * @param array<int, Value|string>|Value|string $aComponents
      * @param string $sSeparator
      * @param int $iLineNo
      */
@@ -39,7 +38,7 @@ public function __construct($aComponents = [], $sSeparator = ',', $iLineNo = 0)
     }
 
     /**
-     * @param RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string $mComponent
+     * @param Value|string $mComponent
      *
      * @return void
      */
@@ -49,15 +48,15 @@ public function addListComponent($mComponent)
     }
 
     /**
-     * @return array<int, RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string>
+     * @return array<int, Value|string>
      */
     public function getListComponents()
     {
         return $this->aComponents;
     }
 
     /**
-     * @param array<int, RuleValueList|CSSFunction|CSSString|LineName|Size|URL|string> $aComponents
+     * @param array<int, Value|string> $aComponents
      *
      * @return void
      */