MDL-75475 lib: Upgraded PHP CSS Parser to 8.4.0

2022-10-20 09:32:47 +11:00
parent f8d28e4ca6
commit c8ee3c9051
40 changed files with 5244 additions and 3086 deletions
@@ -4,38 +4,57 @@ namespace Sabberworm\CSS;

 use Sabberworm\CSS\CSSList\Document;
 use Sabberworm\CSS\Parsing\ParserState;
+use Sabberworm\CSS\Parsing\SourceException;

 /**
- * Parser class parses CSS from text into a data structure.
+ * This class parses CSS from text into a data structure.
 */
-class Parser {
-	private $oParserState;
+class Parser
+{
+    /**
+     * @var ParserState
+     */
+    private $oParserState;

-	/**
-	 * Parser constructor.
-	 * Note that that iLineNo starts from 1 and not 0
-	 *
-	 * @param $sText
-	 * @param Settings|null $oParserSettings
-	 * @param int $iLineNo
-	 */
-	public function __construct($sText, Settings $oParserSettings = null, $iLineNo = 1) {
-		if ($oParserSettings === null) {
-			$oParserSettings = Settings::create();
-		}
-		$this->oParserState = new ParserState($sText, $oParserSettings, $iLineNo);
-	}
+    /**
+     * @param string $sText
+     * @param Settings|null $oParserSettings
+     * @param int $iLineNo the line number (starting from 1, not from 0)
+     */
+    public function __construct($sText, Settings $oParserSettings = null, $iLineNo = 1)
+    {
+        if ($oParserSettings === null) {
+            $oParserSettings = Settings::create();
+        }
+        $this->oParserState = new ParserState($sText, $oParserSettings, $iLineNo);
+    }

-	public function setCharset($sCharset) {
-		$this->oParserState->setCharset($sCharset);
-	}
+    /**
+     * @param string $sCharset
+     *
+     * @return void
+     */
+    public function setCharset($sCharset)
+    {
+        $this->oParserState->setCharset($sCharset);
+    }

-	public function getCharset() {
-		$this->oParserState->getCharset();
-	}
-
-	public function parse() {
-		return Document::parse($this->oParserState);
-	}
+    /**
+     * @return void
+     */
+    public function getCharset()
+    {
+        // Note: The `return` statement is missing here. This is a bug that needs to be fixed.
+        $this->oParserState->getCharset();
+    }

+    /**
+     * @return Document
+     *
+     * @throws SourceException
+     */
+    public function parse()
+    {
+        return Document::parse($this->oParserState);
+    }
 }