| @@ -1,126 +1,0 @@ | ||
| 1 | -<?php | |
| 2 | - | |
| 3 | -declare(strict_types=1); | |
| 4 | - | |
| 5 | -namespace AcyMailing\Libraries\Sabberworm\CSS; | |
| 6 | - | |
| 7 | -/** | |
| 8 | - * version 9.1.0 | |
| 9 | - * | |
| 10 | - * Parser settings class. | |
| 11 | - * | |
| 12 | - * Configure parser behaviour here. | |
| 13 | - */ | |
| 14 | -class Settings | |
| 15 | -{ | |
| 16 | - /** | |
| 17 | - * Multi-byte string support. | |
| 18 | - * | |
| 19 | - * If `true` (`mbstring` extension must be enabled), will use (slower) `mb_strlen`, `mb_convert_case`, `mb_substr` | |
| 20 | - * and `mb_strpos` functions. Otherwise, the normal (ASCII-Only) functions will be used. | |
| 21 | - * | |
| 22 | - * @var bool | |
| 23 | - */ | |
| 24 | - private $multibyteSupport; | |
| 25 | - | |
| 26 | - /** | |
| 27 | - * The default charset for the CSS if no `@charset` declaration is found. Defaults to utf-8. | |
| 28 | - * | |
| 29 | - * @var non-empty-string | |
| 30 | - */ | |
| 31 | - private $defaultCharset = 'utf-8'; | |
| 32 | - | |
| 33 | - /** | |
| 34 | - * Whether the parser silently ignore invalid rules instead of choking on them. | |
| 35 | - * | |
| 36 | - * @var bool | |
| 37 | - */ | |
| 38 | - private $lenientParsing = true; | |
| 39 | - | |
| 40 | - private function __construct() | |
| 41 | - { | |
| 42 | - $this->multibyteSupport = \extension_loaded('mbstring'); | |
| 43 | - } | |
| 44 | - | |
| 45 | - public static function create(): self | |
| 46 | - { | |
| 47 | - return new Settings(); | |
| 48 | - } | |
| 49 | - | |
| 50 | - /** | |
| 51 | - * Enables/disables multi-byte string support. | |
| 52 | - * | |
| 53 | - * If `true` (`mbstring` extension must be enabled), will use (slower) `mb_strlen`, `mb_convert_case`, `mb_substr` | |
| 54 | - * and `mb_strpos` functions. Otherwise, the normal (ASCII-Only) functions will be used. | |
| 55 | - * | |
| 56 | - * @return $this fluent interface | |
| 57 | - */ | |
| 58 | - public function withMultibyteSupport(bool $multibyteSupport = true): self | |
| 59 | - { | |
| 60 | - $this->multibyteSupport = $multibyteSupport; | |
| 61 | - | |
| 62 | - return $this; | |
| 63 | - } | |
| 64 | - | |
| 65 | - /** | |
| 66 | - * Sets the charset to be used if the CSS does not contain an `@charset` declaration. | |
| 67 | - * | |
| 68 | - * @param non-empty-string $defaultCharset | |
| 69 | - * | |
| 70 | - * @return $this fluent interface | |
| 71 | - */ | |
| 72 | - public function withDefaultCharset(string $defaultCharset): self | |
| 73 | - { | |
| 74 | - $this->defaultCharset = $defaultCharset; | |
| 75 | - | |
| 76 | - return $this; | |
| 77 | - } | |
| 78 | - | |
| 79 | - /** | |
| 80 | - * Configures whether the parser should silently ignore invalid rules. | |
| 81 | - * | |
| 82 | - * @return $this fluent interface | |
| 83 | - */ | |
| 84 | - public function withLenientParsing(bool $usesLenientParsing = true): self | |
| 85 | - { | |
| 86 | - $this->lenientParsing = $usesLenientParsing; | |
| 87 | - | |
| 88 | - return $this; | |
| 89 | - } | |
| 90 | - | |
| 91 | - /** | |
| 92 | - * Configures the parser to choke on invalid rules. | |
| 93 | - * | |
| 94 | - * @return $this fluent interface | |
| 95 | - */ | |
| 96 | - public function beStrict(): self | |
| 97 | - { | |
| 98 | - return $this->withLenientParsing(false); | |
| 99 | - } | |
| 100 | - | |
| 101 | - /** | |
| 102 | - * @internal | |
| 103 | - */ | |
| 104 | - public function hasMultibyteSupport(): bool | |
| 105 | - { | |
| 106 | - return $this->multibyteSupport; | |
| 107 | - } | |
| 108 | - | |
| 109 | - /** | |
| 110 | - * @return non-empty-string | |
| 111 | - * | |
| 112 | - * @internal | |
| 113 | - */ | |
| 114 | - public function getDefaultCharset(): string | |
| 115 | - { | |
| 116 | - return $this->defaultCharset; | |
| 117 | - } | |
| 118 | - | |
| 119 | - /** | |
| 120 | - * @internal | |
| 121 | - */ | |
| 122 | - public function usesLenientParsing(): bool | |
| 123 | - { | |
| 124 | - return $this->lenientParsing; | |
| 125 | - } | |
| 126 | -} | |