create-berna-stencil 1.0.47 → 1.0.49

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (176) hide show
  1. package/bin/create.js +1 -0
  2. package/docs/Assistant CLI.md +36 -0
  3. package/docs/Components.md +63 -0
  4. package/docs/Creating pages.md +46 -0
  5. package/docs/Head and SEO.md +44 -0
  6. package/docs/Javascript.md +53 -0
  7. package/docs/Styling with SCSS.md +138 -0
  8. package/package.json +3 -15
  9. package/src/backend/_core/vendor/composer/autoload_static.php +10 -10
  10. package/src/backend/_core/vendor/composer/installed.json +6 -6
  11. package/src/backend/_core/vendor/composer/installed.php +2 -2
  12. package/src/backend/_core/vendor/graham-campbell/result-type/LICENSE +21 -21
  13. package/src/backend/_core/vendor/graham-campbell/result-type/composer.json +33 -33
  14. package/src/backend/_core/vendor/graham-campbell/result-type/src/Error.php +121 -121
  15. package/src/backend/_core/vendor/graham-campbell/result-type/src/Result.php +69 -69
  16. package/src/backend/_core/vendor/graham-campbell/result-type/src/Success.php +120 -120
  17. package/src/backend/_core/vendor/phpoption/phpoption/LICENSE +200 -200
  18. package/src/backend/_core/vendor/phpoption/phpoption/composer.json +50 -50
  19. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/LazyOption.php +175 -175
  20. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/None.php +136 -136
  21. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/Option.php +434 -434
  22. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/Some.php +169 -169
  23. package/src/backend/_core/vendor/symfony/polyfill-ctype/Ctype.php +232 -232
  24. package/src/backend/_core/vendor/symfony/polyfill-ctype/LICENSE +19 -19
  25. package/src/backend/_core/vendor/symfony/polyfill-ctype/README.md +12 -12
  26. package/src/backend/_core/vendor/symfony/polyfill-ctype/bootstrap.php +50 -50
  27. package/src/backend/_core/vendor/symfony/polyfill-ctype/bootstrap80.php +46 -46
  28. package/src/backend/_core/vendor/symfony/polyfill-ctype/composer.json +38 -38
  29. package/src/backend/_core/vendor/symfony/polyfill-mbstring/LICENSE +19 -19
  30. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Mbstring.php +1077 -1077
  31. package/src/backend/_core/vendor/symfony/polyfill-mbstring/README.md +13 -13
  32. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/caseFolding.php +119 -119
  33. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/lowerCase.php +1397 -1397
  34. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/titleCaseRegexp.php +5 -5
  35. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/upperCase.php +1489 -1489
  36. package/src/backend/_core/vendor/symfony/polyfill-mbstring/bootstrap.php +171 -171
  37. package/src/backend/_core/vendor/symfony/polyfill-mbstring/bootstrap80.php +167 -167
  38. package/src/backend/_core/vendor/symfony/polyfill-mbstring/composer.json +39 -39
  39. package/src/backend/_core/vendor/symfony/polyfill-php80/LICENSE +19 -19
  40. package/src/backend/_core/vendor/symfony/polyfill-php80/Php80.php +115 -115
  41. package/src/backend/_core/vendor/symfony/polyfill-php80/PhpToken.php +106 -106
  42. package/src/backend/_core/vendor/symfony/polyfill-php80/README.md +25 -25
  43. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/Attribute.php +31 -31
  44. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/PhpToken.php +16 -16
  45. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/Stringable.php +20 -20
  46. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/UnhandledMatchError.php +16 -16
  47. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/ValueError.php +16 -16
  48. package/src/backend/_core/vendor/symfony/polyfill-php80/bootstrap.php +42 -42
  49. package/src/backend/_core/vendor/symfony/polyfill-php80/composer.json +37 -37
  50. package/src/backend/_core/vendor/vlucas/phpdotenv/LICENSE +30 -30
  51. package/src/backend/_core/vendor/vlucas/phpdotenv/composer.json +60 -60
  52. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Dotenv.php +267 -267
  53. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/ExceptionInterface.php +12 -12
  54. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/InvalidEncodingException.php +12 -12
  55. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/InvalidFileException.php +12 -12
  56. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/InvalidPathException.php +12 -12
  57. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/ValidationException.php +12 -12
  58. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Loader/Loader.php +48 -48
  59. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Loader/LoaderInterface.php +20 -20
  60. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Loader/Resolver.php +65 -65
  61. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Entry.php +59 -59
  62. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/EntryParser.php +299 -299
  63. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Lexer.php +58 -58
  64. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Lines.php +127 -127
  65. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Parser.php +53 -53
  66. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/ParserInterface.php +19 -19
  67. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Value.php +88 -88
  68. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/AdapterInterface.php +15 -15
  69. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ApacheAdapter.php +89 -89
  70. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ArrayAdapter.php +80 -80
  71. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/EnvConstAdapter.php +88 -88
  72. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/GuardedWriter.php +85 -85
  73. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ImmutableWriter.php +110 -110
  74. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiReader.php +48 -48
  75. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiWriter.php +64 -64
  76. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/PutenvAdapter.php +91 -91
  77. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReaderInterface.php +17 -17
  78. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReplacingWriter.php +104 -104
  79. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ServerConstAdapter.php +88 -88
  80. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/WriterInterface.php +27 -27
  81. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/AdapterRepository.php +107 -107
  82. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/RepositoryBuilder.php +272 -272
  83. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/RepositoryInterface.php +51 -51
  84. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/File/Paths.php +44 -44
  85. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/File/Reader.php +81 -81
  86. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/FileStore.php +72 -72
  87. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/StoreBuilder.php +141 -141
  88. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/StoreInterface.php +17 -17
  89. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/StringStore.php +37 -37
  90. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Util/Regex.php +112 -112
  91. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Util/Str.php +108 -108
  92. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Validator.php +207 -207
  93. package/src/frontend/data/site.json +43 -43
  94. package/src/frontend/scss/modules/_root.scss +2 -4
  95. package/src/frontend/scss/modules/frameworks/_bootstrap.scss +0 -1
  96. package/src/frontend/scss/modules/frameworks/_bulma.scss +0 -1
  97. package/src/frontend/scss/modules/frameworks/_foundation.scss +0 -1
  98. package/src/frontend/scss/modules/frameworks/_uikit.scss +0 -1
  99. package/src/backend/_core/vendor/graham-campbell/result-type/.gitattributes +0 -9
  100. package/src/backend/_core/vendor/graham-campbell/result-type/.github/CODE_OF_CONDUCT.md +0 -132
  101. package/src/backend/_core/vendor/graham-campbell/result-type/.github/CONTRIBUTING.md +0 -31
  102. package/src/backend/_core/vendor/graham-campbell/result-type/.github/FUNDING.yml +0 -2
  103. package/src/backend/_core/vendor/graham-campbell/result-type/.github/SECURITY.md +0 -14
  104. package/src/backend/_core/vendor/graham-campbell/result-type/.github/workflows/stale.yml +0 -11
  105. package/src/backend/_core/vendor/graham-campbell/result-type/.github/workflows/tests.yml +0 -40
  106. package/src/backend/_core/vendor/graham-campbell/result-type/CHANGELOG.md +0 -53
  107. package/src/backend/_core/vendor/graham-campbell/result-type/README.md +0 -42
  108. package/src/backend/_core/vendor/graham-campbell/result-type/phpunit.xml.dist +0 -13
  109. package/src/backend/_core/vendor/graham-campbell/result-type/tests/ResultTest.php +0 -95
  110. package/src/backend/_core/vendor/phpoption/phpoption/.gitattributes +0 -13
  111. package/src/backend/_core/vendor/phpoption/phpoption/.github/CODE_OF_CONDUCT.md +0 -132
  112. package/src/backend/_core/vendor/phpoption/phpoption/.github/CONTRIBUTING.md +0 -30
  113. package/src/backend/_core/vendor/phpoption/phpoption/.github/FUNDING.yml +0 -2
  114. package/src/backend/_core/vendor/phpoption/phpoption/.github/SECURITY.md +0 -14
  115. package/src/backend/_core/vendor/phpoption/phpoption/.github/workflows/static.yml +0 -40
  116. package/src/backend/_core/vendor/phpoption/phpoption/.github/workflows/tests.yml +0 -40
  117. package/src/backend/_core/vendor/phpoption/phpoption/Makefile +0 -17
  118. package/src/backend/_core/vendor/phpoption/phpoption/README.md +0 -201
  119. package/src/backend/_core/vendor/phpoption/phpoption/phpstan-baseline.neon +0 -44
  120. package/src/backend/_core/vendor/phpoption/phpoption/phpstan.neon.dist +0 -7
  121. package/src/backend/_core/vendor/phpoption/phpoption/phpunit.xml.dist +0 -13
  122. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/EnsureTest.php +0 -72
  123. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/LazyOptionTest.php +0 -357
  124. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/NoneTest.php +0 -153
  125. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/OptionTest.php +0 -166
  126. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/SomeTest.php +0 -194
  127. package/src/backend/_core/vendor/phpoption/phpoption/tests/bootstrap.php +0 -8
  128. package/src/backend/_core/vendor/phpoption/phpoption/vendor-bin/phpstan/composer.json +0 -8
  129. package/src/backend/_core/vendor/vlucas/phpdotenv/.editorconfig +0 -15
  130. package/src/backend/_core/vendor/vlucas/phpdotenv/.gitattributes +0 -15
  131. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/CODE_OF_CONDUCT.md +0 -132
  132. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/CONTRIBUTING.md +0 -30
  133. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/FUNDING.yml +0 -2
  134. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/SECURITY.md +0 -14
  135. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/workflows/static.yml +0 -40
  136. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/workflows/tests.yml +0 -70
  137. package/src/backend/_core/vendor/vlucas/phpdotenv/Makefile +0 -17
  138. package/src/backend/_core/vendor/vlucas/phpdotenv/README.md +0 -370
  139. package/src/backend/_core/vendor/vlucas/phpdotenv/UPGRADING.md +0 -196
  140. package/src/backend/_core/vendor/vlucas/phpdotenv/phpstan-baseline.neon +0 -157
  141. package/src/backend/_core/vendor/vlucas/phpdotenv/phpstan.neon.dist +0 -7
  142. package/src/backend/_core/vendor/vlucas/phpdotenv/phpunit.xml.dist +0 -13
  143. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/DotenvTest.php +0 -387
  144. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Loader/LoaderTest.php +0 -86
  145. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/EntryParserTest.php +0 -234
  146. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/LexerTest.php +0 -40
  147. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/LinesTest.php +0 -53
  148. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/ParserTest.php +0 -98
  149. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/ArrayAdapterTest.php +0 -57
  150. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/EnvConstAdapterTest.php +0 -75
  151. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/PutenvAdapterTest.php +0 -52
  152. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/ServerConstAdapterTest.php +0 -75
  153. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/RepositoryTest.php +0 -305
  154. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Store/StoreTest.php +0 -141
  155. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/ValidatorTest.php +0 -479
  156. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/.env +0 -5
  157. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/assertions.env +0 -18
  158. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/booleans.env +0 -33
  159. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/commented.env +0 -15
  160. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/empty.env +0 -1
  161. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/example.env +0 -1
  162. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/exported.env +0 -7
  163. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/immutable.env +0 -1
  164. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/integers.env +0 -17
  165. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/large.env +0 -2
  166. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/multibyte.env +0 -3
  167. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/multiline.env +0 -14
  168. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/multiple.env +0 -4
  169. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/mutable.env +0 -1
  170. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/nested.env +0 -15
  171. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/quoted.env +0 -11
  172. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/specialchars.env +0 -8
  173. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/unicodevarnames.env +0 -2
  174. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/utf8-with-bom-encoding.env +0 -3
  175. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/windows.env +0 -1
  176. package/src/backend/_core/vendor/vlucas/phpdotenv/vendor-bin/phpstan/composer.json +0 -15
@@ -1,17 +1,17 @@
1
- <?php
2
-
3
- declare(strict_types=1);
4
-
5
- namespace Dotenv\Store;
6
-
7
- interface StoreInterface
8
- {
9
- /**
10
- * Read the content of the environment file(s).
11
- *
12
- * @throws \Dotenv\Exception\InvalidEncodingException|\Dotenv\Exception\InvalidPathException
13
- *
14
- * @return string
15
- */
16
- public function read();
17
- }
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ namespace Dotenv\Store;
6
+
7
+ interface StoreInterface
8
+ {
9
+ /**
10
+ * Read the content of the environment file(s).
11
+ *
12
+ * @throws \Dotenv\Exception\InvalidEncodingException|\Dotenv\Exception\InvalidPathException
13
+ *
14
+ * @return string
15
+ */
16
+ public function read();
17
+ }
@@ -1,37 +1,37 @@
1
- <?php
2
-
3
- declare(strict_types=1);
4
-
5
- namespace Dotenv\Store;
6
-
7
- final class StringStore implements StoreInterface
8
- {
9
- /**
10
- * The file content.
11
- *
12
- * @var string
13
- */
14
- private $content;
15
-
16
- /**
17
- * Create a new string store instance.
18
- *
19
- * @param string $content
20
- *
21
- * @return void
22
- */
23
- public function __construct(string $content)
24
- {
25
- $this->content = $content;
26
- }
27
-
28
- /**
29
- * Read the content of the environment file(s).
30
- *
31
- * @return string
32
- */
33
- public function read()
34
- {
35
- return $this->content;
36
- }
37
- }
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ namespace Dotenv\Store;
6
+
7
+ final class StringStore implements StoreInterface
8
+ {
9
+ /**
10
+ * The file content.
11
+ *
12
+ * @var string
13
+ */
14
+ private $content;
15
+
16
+ /**
17
+ * Create a new string store instance.
18
+ *
19
+ * @param string $content
20
+ *
21
+ * @return void
22
+ */
23
+ public function __construct(string $content)
24
+ {
25
+ $this->content = $content;
26
+ }
27
+
28
+ /**
29
+ * Read the content of the environment file(s).
30
+ *
31
+ * @return string
32
+ */
33
+ public function read()
34
+ {
35
+ return $this->content;
36
+ }
37
+ }
@@ -1,112 +1,112 @@
1
- <?php
2
-
3
- declare(strict_types=1);
4
-
5
- namespace Dotenv\Util;
6
-
7
- use GrahamCampbell\ResultType\Error;
8
- use GrahamCampbell\ResultType\Success;
9
-
10
- /**
11
- * @internal
12
- */
13
- final class Regex
14
- {
15
- /**
16
- * This class is a singleton.
17
- *
18
- * @codeCoverageIgnore
19
- *
20
- * @return void
21
- */
22
- private function __construct()
23
- {
24
- //
25
- }
26
-
27
- /**
28
- * Perform a preg match, wrapping up the result.
29
- *
30
- * @param string $pattern
31
- * @param string $subject
32
- *
33
- * @return \GrahamCampbell\ResultType\Result<bool, string>
34
- */
35
- public static function matches(string $pattern, string $subject)
36
- {
37
- return self::pregAndWrap(static function (string $subject) use ($pattern) {
38
- return @\preg_match($pattern, $subject) === 1;
39
- }, $subject);
40
- }
41
-
42
- /**
43
- * Perform a preg match all, wrapping up the result.
44
- *
45
- * @param string $pattern
46
- * @param string $subject
47
- *
48
- * @return \GrahamCampbell\ResultType\Result<int, string>
49
- */
50
- public static function occurrences(string $pattern, string $subject)
51
- {
52
- return self::pregAndWrap(static function (string $subject) use ($pattern) {
53
- return (int) @\preg_match_all($pattern, $subject);
54
- }, $subject);
55
- }
56
-
57
- /**
58
- * Perform a preg replace callback, wrapping up the result.
59
- *
60
- * @param string $pattern
61
- * @param callable(string[]): string $callback
62
- * @param string $subject
63
- * @param int|null $limit
64
- *
65
- * @return \GrahamCampbell\ResultType\Result<string, string>
66
- */
67
- public static function replaceCallback(string $pattern, callable $callback, string $subject, ?int $limit = null)
68
- {
69
- return self::pregAndWrap(static function (string $subject) use ($pattern, $callback, $limit) {
70
- return (string) @\preg_replace_callback($pattern, $callback, $subject, $limit ?? -1);
71
- }, $subject);
72
- }
73
-
74
- /**
75
- * Perform a preg split, wrapping up the result.
76
- *
77
- * @param string $pattern
78
- * @param string $subject
79
- *
80
- * @return \GrahamCampbell\ResultType\Result<string[], string>
81
- */
82
- public static function split(string $pattern, string $subject)
83
- {
84
- return self::pregAndWrap(static function (string $subject) use ($pattern) {
85
- /** @var string[] */
86
- return (array) @\preg_split($pattern, $subject);
87
- }, $subject);
88
- }
89
-
90
- /**
91
- * Perform a preg operation, wrapping up the result.
92
- *
93
- * @template V
94
- *
95
- * @param callable(string): V $operation
96
- * @param string $subject
97
- *
98
- * @return \GrahamCampbell\ResultType\Result<V, string>
99
- */
100
- private static function pregAndWrap(callable $operation, string $subject)
101
- {
102
- $result = $operation($subject);
103
-
104
- if (\preg_last_error() !== \PREG_NO_ERROR) {
105
- /** @var \GrahamCampbell\ResultType\Result<V,string> */
106
- return Error::create(\preg_last_error_msg());
107
- }
108
-
109
- /** @var \GrahamCampbell\ResultType\Result<V,string> */
110
- return Success::create($result);
111
- }
112
- }
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ namespace Dotenv\Util;
6
+
7
+ use GrahamCampbell\ResultType\Error;
8
+ use GrahamCampbell\ResultType\Success;
9
+
10
+ /**
11
+ * @internal
12
+ */
13
+ final class Regex
14
+ {
15
+ /**
16
+ * This class is a singleton.
17
+ *
18
+ * @codeCoverageIgnore
19
+ *
20
+ * @return void
21
+ */
22
+ private function __construct()
23
+ {
24
+ //
25
+ }
26
+
27
+ /**
28
+ * Perform a preg match, wrapping up the result.
29
+ *
30
+ * @param string $pattern
31
+ * @param string $subject
32
+ *
33
+ * @return \GrahamCampbell\ResultType\Result<bool, string>
34
+ */
35
+ public static function matches(string $pattern, string $subject)
36
+ {
37
+ return self::pregAndWrap(static function (string $subject) use ($pattern) {
38
+ return @\preg_match($pattern, $subject) === 1;
39
+ }, $subject);
40
+ }
41
+
42
+ /**
43
+ * Perform a preg match all, wrapping up the result.
44
+ *
45
+ * @param string $pattern
46
+ * @param string $subject
47
+ *
48
+ * @return \GrahamCampbell\ResultType\Result<int, string>
49
+ */
50
+ public static function occurrences(string $pattern, string $subject)
51
+ {
52
+ return self::pregAndWrap(static function (string $subject) use ($pattern) {
53
+ return (int) @\preg_match_all($pattern, $subject);
54
+ }, $subject);
55
+ }
56
+
57
+ /**
58
+ * Perform a preg replace callback, wrapping up the result.
59
+ *
60
+ * @param string $pattern
61
+ * @param callable(string[]): string $callback
62
+ * @param string $subject
63
+ * @param int|null $limit
64
+ *
65
+ * @return \GrahamCampbell\ResultType\Result<string, string>
66
+ */
67
+ public static function replaceCallback(string $pattern, callable $callback, string $subject, ?int $limit = null)
68
+ {
69
+ return self::pregAndWrap(static function (string $subject) use ($pattern, $callback, $limit) {
70
+ return (string) @\preg_replace_callback($pattern, $callback, $subject, $limit ?? -1);
71
+ }, $subject);
72
+ }
73
+
74
+ /**
75
+ * Perform a preg split, wrapping up the result.
76
+ *
77
+ * @param string $pattern
78
+ * @param string $subject
79
+ *
80
+ * @return \GrahamCampbell\ResultType\Result<string[], string>
81
+ */
82
+ public static function split(string $pattern, string $subject)
83
+ {
84
+ return self::pregAndWrap(static function (string $subject) use ($pattern) {
85
+ /** @var string[] */
86
+ return (array) @\preg_split($pattern, $subject);
87
+ }, $subject);
88
+ }
89
+
90
+ /**
91
+ * Perform a preg operation, wrapping up the result.
92
+ *
93
+ * @template V
94
+ *
95
+ * @param callable(string): V $operation
96
+ * @param string $subject
97
+ *
98
+ * @return \GrahamCampbell\ResultType\Result<V, string>
99
+ */
100
+ private static function pregAndWrap(callable $operation, string $subject)
101
+ {
102
+ $result = $operation($subject);
103
+
104
+ if (\preg_last_error() !== \PREG_NO_ERROR) {
105
+ /** @var \GrahamCampbell\ResultType\Result<V,string> */
106
+ return Error::create(\preg_last_error_msg());
107
+ }
108
+
109
+ /** @var \GrahamCampbell\ResultType\Result<V,string> */
110
+ return Success::create($result);
111
+ }
112
+ }
@@ -1,108 +1,108 @@
1
- <?php
2
-
3
- declare(strict_types=1);
4
-
5
- namespace Dotenv\Util;
6
-
7
- use GrahamCampbell\ResultType\Error;
8
- use GrahamCampbell\ResultType\Success;
9
- use PhpOption\Option;
10
-
11
- /**
12
- * @internal
13
- */
14
- final class Str
15
- {
16
- /**
17
- * This class is a singleton.
18
- *
19
- * @codeCoverageIgnore
20
- *
21
- * @return void
22
- */
23
- private function __construct()
24
- {
25
- //
26
- }
27
-
28
- /**
29
- * Convert a string to UTF-8 from the given encoding.
30
- *
31
- * @param string $input
32
- * @param string|null $encoding
33
- *
34
- * @return \GrahamCampbell\ResultType\Result<string, string>
35
- */
36
- public static function utf8(string $input, ?string $encoding = null)
37
- {
38
- if ($encoding !== null && !\in_array($encoding, \mb_list_encodings(), true)) {
39
- /** @var \GrahamCampbell\ResultType\Result<string, string> */
40
- return Error::create(
41
- \sprintf('Illegal character encoding [%s] specified.', $encoding)
42
- );
43
- }
44
-
45
- $converted = $encoding === null ?
46
- @\mb_convert_encoding($input, 'UTF-8') :
47
- @\mb_convert_encoding($input, 'UTF-8', $encoding);
48
-
49
- if (!is_string($converted)) {
50
- /** @var \GrahamCampbell\ResultType\Result<string, string> */
51
- return Error::create(
52
- \sprintf('Conversion from encoding [%s] failed.', $encoding ?? 'NULL')
53
- );
54
- }
55
-
56
- /**
57
- * this is for support UTF-8 with BOM encoding
58
- * @see https://en.wikipedia.org/wiki/Byte_order_mark
59
- * @see https://github.com/vlucas/phpdotenv/issues/500
60
- */
61
- if (\substr($converted, 0, 3) == "\xEF\xBB\xBF") {
62
- $converted = \substr($converted, 3);
63
- }
64
-
65
- /** @var \GrahamCampbell\ResultType\Result<string, string> */
66
- return Success::create($converted);
67
- }
68
-
69
- /**
70
- * Search for a given substring of the input.
71
- *
72
- * @param string $haystack
73
- * @param string $needle
74
- *
75
- * @return \PhpOption\Option<int>
76
- */
77
- public static function pos(string $haystack, string $needle)
78
- {
79
- /** @var \PhpOption\Option<int> */
80
- return Option::fromValue(\mb_strpos($haystack, $needle, 0, 'UTF-8'), false);
81
- }
82
-
83
- /**
84
- * Grab the specified substring of the input.
85
- *
86
- * @param string $input
87
- * @param int $start
88
- * @param int|null $length
89
- *
90
- * @return string
91
- */
92
- public static function substr(string $input, int $start, ?int $length = null)
93
- {
94
- return \mb_substr($input, $start, $length, 'UTF-8');
95
- }
96
-
97
- /**
98
- * Compute the length of the given string.
99
- *
100
- * @param string $input
101
- *
102
- * @return int
103
- */
104
- public static function len(string $input)
105
- {
106
- return \mb_strlen($input, 'UTF-8');
107
- }
108
- }
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ namespace Dotenv\Util;
6
+
7
+ use GrahamCampbell\ResultType\Error;
8
+ use GrahamCampbell\ResultType\Success;
9
+ use PhpOption\Option;
10
+
11
+ /**
12
+ * @internal
13
+ */
14
+ final class Str
15
+ {
16
+ /**
17
+ * This class is a singleton.
18
+ *
19
+ * @codeCoverageIgnore
20
+ *
21
+ * @return void
22
+ */
23
+ private function __construct()
24
+ {
25
+ //
26
+ }
27
+
28
+ /**
29
+ * Convert a string to UTF-8 from the given encoding.
30
+ *
31
+ * @param string $input
32
+ * @param string|null $encoding
33
+ *
34
+ * @return \GrahamCampbell\ResultType\Result<string, string>
35
+ */
36
+ public static function utf8(string $input, ?string $encoding = null)
37
+ {
38
+ if ($encoding !== null && !\in_array($encoding, \mb_list_encodings(), true)) {
39
+ /** @var \GrahamCampbell\ResultType\Result<string, string> */
40
+ return Error::create(
41
+ \sprintf('Illegal character encoding [%s] specified.', $encoding)
42
+ );
43
+ }
44
+
45
+ $converted = $encoding === null ?
46
+ @\mb_convert_encoding($input, 'UTF-8') :
47
+ @\mb_convert_encoding($input, 'UTF-8', $encoding);
48
+
49
+ if (!is_string($converted)) {
50
+ /** @var \GrahamCampbell\ResultType\Result<string, string> */
51
+ return Error::create(
52
+ \sprintf('Conversion from encoding [%s] failed.', $encoding ?? 'NULL')
53
+ );
54
+ }
55
+
56
+ /**
57
+ * this is for support UTF-8 with BOM encoding
58
+ * @see https://en.wikipedia.org/wiki/Byte_order_mark
59
+ * @see https://github.com/vlucas/phpdotenv/issues/500
60
+ */
61
+ if (\substr($converted, 0, 3) == "\xEF\xBB\xBF") {
62
+ $converted = \substr($converted, 3);
63
+ }
64
+
65
+ /** @var \GrahamCampbell\ResultType\Result<string, string> */
66
+ return Success::create($converted);
67
+ }
68
+
69
+ /**
70
+ * Search for a given substring of the input.
71
+ *
72
+ * @param string $haystack
73
+ * @param string $needle
74
+ *
75
+ * @return \PhpOption\Option<int>
76
+ */
77
+ public static function pos(string $haystack, string $needle)
78
+ {
79
+ /** @var \PhpOption\Option<int> */
80
+ return Option::fromValue(\mb_strpos($haystack, $needle, 0, 'UTF-8'), false);
81
+ }
82
+
83
+ /**
84
+ * Grab the specified substring of the input.
85
+ *
86
+ * @param string $input
87
+ * @param int $start
88
+ * @param int|null $length
89
+ *
90
+ * @return string
91
+ */
92
+ public static function substr(string $input, int $start, ?int $length = null)
93
+ {
94
+ return \mb_substr($input, $start, $length, 'UTF-8');
95
+ }
96
+
97
+ /**
98
+ * Compute the length of the given string.
99
+ *
100
+ * @param string $input
101
+ *
102
+ * @return int
103
+ */
104
+ public static function len(string $input)
105
+ {
106
+ return \mb_strlen($input, 'UTF-8');
107
+ }
108
+ }