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
@@ -2,53 +2,88 @@

 namespace Sabberworm\CSS;

-use Sabberworm\CSS\Rule\Rule;
-
 /**
 * Parser settings class.
 *
 * Configure parser behaviour here.
 */
-class Settings {
-	/**
-	* Multi-byte string support. If true (mbstring extension must be enabled), will use (slower) mb_strlen, mb_convert_case, mb_substr and mb_strpos functions. Otherwise, the normal (ASCII-Only) functions will be used.
-	*/
-	public $bMultibyteSupport;
+class Settings
+{
+    /**
+     * Multi-byte string support.
+     * If true (mbstring extension must be enabled), will use (slower) `mb_strlen`, `mb_convert_case`, `mb_substr`
+     * and `mb_strpos` functions. Otherwise, the normal (ASCII-Only) functions will be used.
+     *
+     * @var bool
+     */
+    public $bMultibyteSupport;

-	/**
-	* The default charset for the CSS if no `@charset` rule is found. Defaults to utf-8.
-	*/
-	public $sDefaultCharset = 'utf-8';
+    /**
+     * The default charset for the CSS if no `@charset` rule is found. Defaults to utf-8.
+     *
+     * @var string
+     */
+    public $sDefaultCharset = 'utf-8';

-	/**
-	* Lenient parsing. When used (which is true by default), the parser will not choke on unexpected tokens but simply ignore them.
-	*/
-	public $bLenientParsing = true;
+    /**
+     * Lenient parsing. When used (which is true by default), the parser will not choke
+     * on unexpected tokens but simply ignore them.
+     *
+     * @var bool
+     */
+    public $bLenientParsing = true;

-	private function __construct() {
-		$this->bMultibyteSupport = extension_loaded('mbstring');
-	}
+    private function __construct()
+    {
+        $this->bMultibyteSupport = extension_loaded('mbstring');
+    }

-	public static function create() {
-		return new Settings();
-	}
-	
-	public function withMultibyteSupport($bMultibyteSupport = true) {
-		$this->bMultibyteSupport = $bMultibyteSupport;
-		return $this;
-	}
-	
-	public function withDefaultCharset($sDefaultCharset) {
-		$this->sDefaultCharset = $sDefaultCharset;
-		return $this;
-	}
-	
-	public function withLenientParsing($bLenientParsing = true) {
-		$this->bLenientParsing = $bLenientParsing;
-		return $this;
-	}
-	
-	public function beStrict() {
-		return $this->withLenientParsing(false);
-	}
-}
+    /**
+     * @return self new instance
+     */
+    public static function create()
+    {
+        return new Settings();
+    }
+
+    /**
+     * @param bool $bMultibyteSupport
+     *
+     * @return self fluent interface
+     */
+    public function withMultibyteSupport($bMultibyteSupport = true)
+    {
+        $this->bMultibyteSupport = $bMultibyteSupport;
+        return $this;
+    }
+
+    /**
+     * @param string $sDefaultCharset
+     *
+     * @return self fluent interface
+     */
+    public function withDefaultCharset($sDefaultCharset)
+    {
+        $this->sDefaultCharset = $sDefaultCharset;
+        return $this;
+    }
+
+    /**
+     * @param bool $bLenientParsing
+     *
+     * @return self fluent interface
+     */
+    public function withLenientParsing($bLenientParsing = true)
+    {
+        $this->bLenientParsing = $bLenientParsing;
+        return $this;
+    }
+
+    /**
+     * @return self fluent interface
+     */
+    public function beStrict()
+    {
+        return $this->withLenientParsing(false);
+    }
+}