Vendor packages updated

vendor/sabberworm/php-css-parser/src/Settings.php

@@ -0,0 +1,124 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Sabberworm\CSS;
+
+/**
+ * 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.
+     *
+     * @var bool
+     */
+    private $multibyteSupport;
+
+    /**
+     * The default charset for the CSS if no `@charset` declaration is found. Defaults to utf-8.
+     *
+     * @var non-empty-string
+     */
+    private $defaultCharset = 'utf-8';
+
+    /**
+     * Whether the parser silently ignore invalid rules instead of choking on them.
+     *
+     * @var bool
+     */
+    private $lenientParsing = true;
+
+    private function __construct()
+    {
+        $this->multibyteSupport = \extension_loaded('mbstring');
+    }
+
+    public static function create(): self
+    {
+        return new Settings();
+    }
+
+    /**
+     * Enables/disables 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.
+     *
+     * @return $this fluent interface
+     */
+    public function withMultibyteSupport(bool $multibyteSupport = true): self
+    {
+        $this->multibyteSupport = $multibyteSupport;
+
+        return $this;
+    }
+
+    /**
+     * Sets the charset to be used if the CSS does not contain an `@charset` declaration.
+     *
+     * @param non-empty-string $defaultCharset
+     *
+     * @return $this fluent interface
+     */
+    public function withDefaultCharset(string $defaultCharset): self
+    {
+        $this->defaultCharset = $defaultCharset;
+
+        return $this;
+    }
+
+    /**
+     * Configures whether the parser should silently ignore invalid rules.
+     *
+     * @return $this fluent interface
+     */
+    public function withLenientParsing(bool $usesLenientParsing = true): self
+    {
+        $this->lenientParsing = $usesLenientParsing;
+
+        return $this;
+    }
+
+    /**
+     * Configures the parser to choke on invalid rules.
+     *
+     * @return $this fluent interface
+     */
+    public function beStrict(): self
+    {
+        return $this->withLenientParsing(false);
+    }
+
+    /**
+     * @internal
+     */
+    public function hasMultibyteSupport(): bool
+    {
+        return $this->multibyteSupport;
+    }
+
+    /**
+     * @return non-empty-string
+     *
+     * @internal
+     */
+    public function getDefaultCharset(): string
+    {
+        return $this->defaultCharset;
+    }
+
+    /**
+     * @internal
+     */
+    public function usesLenientParsing(): bool
+    {
+        return $this->lenientParsing;
+    }
+}