create-berna-stencil 1.0.49 → 1.0.51

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 (177) hide show
  1. package/_tools/modules/updateIncludes.js +1 -1
  2. package/bin/create.js +2 -2
  3. package/docs/Components.md +54 -33
  4. package/docs/Head and SEO.md +33 -6
  5. package/docs/Styling with SCSS.md +8 -6
  6. package/package.json +58 -62
  7. package/src/backend/_core/vendor/composer/autoload_static.php +10 -10
  8. package/src/backend/_core/vendor/composer/installed.json +6 -6
  9. package/src/backend/_core/vendor/composer/installed.php +2 -2
  10. package/src/backend/_core/vendor/graham-campbell/result-type/.gitattributes +9 -0
  11. package/src/backend/_core/vendor/graham-campbell/result-type/.github/CODE_OF_CONDUCT.md +132 -0
  12. package/src/backend/_core/vendor/graham-campbell/result-type/.github/CONTRIBUTING.md +31 -0
  13. package/src/backend/_core/vendor/graham-campbell/result-type/.github/FUNDING.yml +2 -0
  14. package/src/backend/_core/vendor/graham-campbell/result-type/.github/SECURITY.md +14 -0
  15. package/src/backend/_core/vendor/graham-campbell/result-type/.github/workflows/stale.yml +11 -0
  16. package/src/backend/_core/vendor/graham-campbell/result-type/.github/workflows/tests.yml +40 -0
  17. package/src/backend/_core/vendor/graham-campbell/result-type/CHANGELOG.md +53 -0
  18. package/src/backend/_core/vendor/graham-campbell/result-type/LICENSE +21 -21
  19. package/src/backend/_core/vendor/graham-campbell/result-type/README.md +42 -0
  20. package/src/backend/_core/vendor/graham-campbell/result-type/composer.json +33 -33
  21. package/src/backend/_core/vendor/graham-campbell/result-type/phpunit.xml.dist +13 -0
  22. package/src/backend/_core/vendor/graham-campbell/result-type/src/Error.php +121 -121
  23. package/src/backend/_core/vendor/graham-campbell/result-type/src/Result.php +69 -69
  24. package/src/backend/_core/vendor/graham-campbell/result-type/src/Success.php +120 -120
  25. package/src/backend/_core/vendor/graham-campbell/result-type/tests/ResultTest.php +95 -0
  26. package/src/backend/_core/vendor/phpoption/phpoption/.gitattributes +13 -0
  27. package/src/backend/_core/vendor/phpoption/phpoption/.github/CODE_OF_CONDUCT.md +132 -0
  28. package/src/backend/_core/vendor/phpoption/phpoption/.github/CONTRIBUTING.md +30 -0
  29. package/src/backend/_core/vendor/phpoption/phpoption/.github/FUNDING.yml +2 -0
  30. package/src/backend/_core/vendor/phpoption/phpoption/.github/SECURITY.md +14 -0
  31. package/src/backend/_core/vendor/phpoption/phpoption/.github/workflows/static.yml +40 -0
  32. package/src/backend/_core/vendor/phpoption/phpoption/.github/workflows/tests.yml +40 -0
  33. package/src/backend/_core/vendor/phpoption/phpoption/LICENSE +200 -200
  34. package/src/backend/_core/vendor/phpoption/phpoption/Makefile +17 -0
  35. package/src/backend/_core/vendor/phpoption/phpoption/README.md +201 -0
  36. package/src/backend/_core/vendor/phpoption/phpoption/composer.json +50 -50
  37. package/src/backend/_core/vendor/phpoption/phpoption/phpstan-baseline.neon +44 -0
  38. package/src/backend/_core/vendor/phpoption/phpoption/phpstan.neon.dist +7 -0
  39. package/src/backend/_core/vendor/phpoption/phpoption/phpunit.xml.dist +13 -0
  40. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/LazyOption.php +175 -175
  41. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/None.php +136 -136
  42. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/Option.php +434 -434
  43. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/Some.php +169 -169
  44. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/EnsureTest.php +72 -0
  45. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/LazyOptionTest.php +357 -0
  46. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/NoneTest.php +153 -0
  47. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/OptionTest.php +166 -0
  48. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/SomeTest.php +194 -0
  49. package/src/backend/_core/vendor/phpoption/phpoption/tests/bootstrap.php +8 -0
  50. package/src/backend/_core/vendor/phpoption/phpoption/vendor-bin/phpstan/composer.json +8 -0
  51. package/src/backend/_core/vendor/symfony/polyfill-ctype/Ctype.php +232 -232
  52. package/src/backend/_core/vendor/symfony/polyfill-ctype/LICENSE +19 -19
  53. package/src/backend/_core/vendor/symfony/polyfill-ctype/README.md +12 -12
  54. package/src/backend/_core/vendor/symfony/polyfill-ctype/bootstrap.php +50 -50
  55. package/src/backend/_core/vendor/symfony/polyfill-ctype/bootstrap80.php +46 -46
  56. package/src/backend/_core/vendor/symfony/polyfill-ctype/composer.json +38 -38
  57. package/src/backend/_core/vendor/symfony/polyfill-mbstring/LICENSE +19 -19
  58. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Mbstring.php +1077 -1077
  59. package/src/backend/_core/vendor/symfony/polyfill-mbstring/README.md +13 -13
  60. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/caseFolding.php +119 -119
  61. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/lowerCase.php +1397 -1397
  62. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/titleCaseRegexp.php +5 -5
  63. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/upperCase.php +1489 -1489
  64. package/src/backend/_core/vendor/symfony/polyfill-mbstring/bootstrap.php +171 -171
  65. package/src/backend/_core/vendor/symfony/polyfill-mbstring/bootstrap80.php +167 -167
  66. package/src/backend/_core/vendor/symfony/polyfill-mbstring/composer.json +39 -39
  67. package/src/backend/_core/vendor/symfony/polyfill-php80/LICENSE +19 -19
  68. package/src/backend/_core/vendor/symfony/polyfill-php80/Php80.php +115 -115
  69. package/src/backend/_core/vendor/symfony/polyfill-php80/PhpToken.php +106 -106
  70. package/src/backend/_core/vendor/symfony/polyfill-php80/README.md +25 -25
  71. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/Attribute.php +31 -31
  72. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/PhpToken.php +16 -16
  73. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/Stringable.php +20 -20
  74. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/UnhandledMatchError.php +16 -16
  75. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/ValueError.php +16 -16
  76. package/src/backend/_core/vendor/symfony/polyfill-php80/bootstrap.php +42 -42
  77. package/src/backend/_core/vendor/symfony/polyfill-php80/composer.json +37 -37
  78. package/src/backend/_core/vendor/vlucas/phpdotenv/.editorconfig +15 -0
  79. package/src/backend/_core/vendor/vlucas/phpdotenv/.gitattributes +15 -0
  80. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/CODE_OF_CONDUCT.md +132 -0
  81. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/CONTRIBUTING.md +30 -0
  82. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/FUNDING.yml +2 -0
  83. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/SECURITY.md +14 -0
  84. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/workflows/static.yml +40 -0
  85. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/workflows/tests.yml +70 -0
  86. package/src/backend/_core/vendor/vlucas/phpdotenv/LICENSE +30 -30
  87. package/src/backend/_core/vendor/vlucas/phpdotenv/Makefile +17 -0
  88. package/src/backend/_core/vendor/vlucas/phpdotenv/README.md +370 -0
  89. package/src/backend/_core/vendor/vlucas/phpdotenv/UPGRADING.md +196 -0
  90. package/src/backend/_core/vendor/vlucas/phpdotenv/composer.json +60 -60
  91. package/src/backend/_core/vendor/vlucas/phpdotenv/phpstan-baseline.neon +157 -0
  92. package/src/backend/_core/vendor/vlucas/phpdotenv/phpstan.neon.dist +7 -0
  93. package/src/backend/_core/vendor/vlucas/phpdotenv/phpunit.xml.dist +13 -0
  94. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Dotenv.php +267 -267
  95. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/ExceptionInterface.php +12 -12
  96. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/InvalidEncodingException.php +12 -12
  97. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/InvalidFileException.php +12 -12
  98. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/InvalidPathException.php +12 -12
  99. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/ValidationException.php +12 -12
  100. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Loader/Loader.php +48 -48
  101. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Loader/LoaderInterface.php +20 -20
  102. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Loader/Resolver.php +65 -65
  103. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Entry.php +59 -59
  104. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/EntryParser.php +299 -299
  105. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Lexer.php +58 -58
  106. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Lines.php +127 -127
  107. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Parser.php +53 -53
  108. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/ParserInterface.php +19 -19
  109. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Value.php +88 -88
  110. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/AdapterInterface.php +15 -15
  111. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ApacheAdapter.php +89 -89
  112. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ArrayAdapter.php +80 -80
  113. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/EnvConstAdapter.php +88 -88
  114. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/GuardedWriter.php +85 -85
  115. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ImmutableWriter.php +110 -110
  116. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiReader.php +48 -48
  117. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiWriter.php +64 -64
  118. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/PutenvAdapter.php +91 -91
  119. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReaderInterface.php +17 -17
  120. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReplacingWriter.php +104 -104
  121. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ServerConstAdapter.php +88 -88
  122. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/WriterInterface.php +27 -27
  123. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/AdapterRepository.php +107 -107
  124. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/RepositoryBuilder.php +272 -272
  125. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/RepositoryInterface.php +51 -51
  126. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/File/Paths.php +44 -44
  127. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/File/Reader.php +81 -81
  128. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/FileStore.php +72 -72
  129. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/StoreBuilder.php +141 -141
  130. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/StoreInterface.php +17 -17
  131. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/StringStore.php +37 -37
  132. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Util/Regex.php +112 -112
  133. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Util/Str.php +108 -108
  134. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Validator.php +207 -207
  135. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/DotenvTest.php +387 -0
  136. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Loader/LoaderTest.php +86 -0
  137. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/EntryParserTest.php +234 -0
  138. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/LexerTest.php +40 -0
  139. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/LinesTest.php +53 -0
  140. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/ParserTest.php +98 -0
  141. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/ArrayAdapterTest.php +57 -0
  142. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/EnvConstAdapterTest.php +75 -0
  143. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/PutenvAdapterTest.php +52 -0
  144. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/ServerConstAdapterTest.php +75 -0
  145. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/RepositoryTest.php +305 -0
  146. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Store/StoreTest.php +141 -0
  147. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/ValidatorTest.php +479 -0
  148. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/.env +5 -0
  149. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/assertions.env +18 -0
  150. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/booleans.env +33 -0
  151. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/commented.env +15 -0
  152. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/empty.env +1 -0
  153. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/example.env +1 -0
  154. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/exported.env +7 -0
  155. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/immutable.env +1 -0
  156. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/integers.env +17 -0
  157. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/large.env +2 -0
  158. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/multibyte.env +3 -0
  159. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/multiline.env +14 -0
  160. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/multiple.env +4 -0
  161. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/mutable.env +1 -0
  162. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/nested.env +15 -0
  163. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/quoted.env +11 -0
  164. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/specialchars.env +8 -0
  165. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/unicodevarnames.env +2 -0
  166. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/utf8-with-bom-encoding.env +3 -0
  167. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/windows.env +1 -0
  168. package/src/backend/_core/vendor/vlucas/phpdotenv/vendor-bin/phpstan/composer.json +15 -0
  169. package/src/frontend/components/layouts/includes.njk +1 -0
  170. package/src/frontend/data/site.json +43 -43
  171. package/src/frontend/llms.njk +18 -0
  172. package/src/frontend/robots.njk +8 -0
  173. package/src/frontend/scss/modules/frameworks/_bootstrap.scss +63 -63
  174. package/src/frontend/scss/modules/frameworks/_bulma.scss +64 -64
  175. package/src/frontend/scss/modules/frameworks/_foundation.scss +97 -97
  176. package/src/frontend/scss/modules/frameworks/_uikit.scss +78 -78
  177. package/src/frontend/robots.txt +0 -4
@@ -1,175 +1,175 @@
1
- <?php
2
-
3
- /*
4
- * Copyright 2012 Johannes M. Schmitt <schmittjoh@gmail.com>
5
- *
6
- * Licensed under the Apache License, Version 2.0 (the "License");
7
- * you may not use this file except in compliance with the License.
8
- * You may obtain a copy of the License at
9
- *
10
- * http://www.apache.org/licenses/LICENSE-2.0
11
- *
12
- * Unless required by applicable law or agreed to in writing, software
13
- * distributed under the License is distributed on an "AS IS" BASIS,
14
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
- * See the License for the specific language governing permissions and
16
- * limitations under the License.
17
- */
18
-
19
- namespace PhpOption;
20
-
21
- use Traversable;
22
-
23
- /**
24
- * @template T
25
- *
26
- * @extends Option<T>
27
- */
28
- final class LazyOption extends Option
29
- {
30
- /** @var callable(mixed...):(Option<T>) */
31
- private $callback;
32
-
33
- /** @var array<int, mixed> */
34
- private $arguments;
35
-
36
- /** @var Option<T>|null */
37
- private $option;
38
-
39
- /**
40
- * @template S
41
- * @param callable(mixed...):(Option<S>) $callback
42
- * @param array<int, mixed> $arguments
43
- *
44
- * @return LazyOption<S>
45
- */
46
- public static function create($callback, array $arguments = []): self
47
- {
48
- return new self($callback, $arguments);
49
- }
50
-
51
- /**
52
- * @param callable(mixed...):(Option<T>) $callback
53
- * @param array<int, mixed> $arguments
54
- */
55
- public function __construct($callback, array $arguments = [])
56
- {
57
- if (!is_callable($callback)) {
58
- throw new \InvalidArgumentException('Invalid callback given');
59
- }
60
-
61
- $this->callback = $callback;
62
- $this->arguments = $arguments;
63
- }
64
-
65
- public function isDefined(): bool
66
- {
67
- return $this->option()->isDefined();
68
- }
69
-
70
- public function isEmpty(): bool
71
- {
72
- return $this->option()->isEmpty();
73
- }
74
-
75
- public function get()
76
- {
77
- return $this->option()->get();
78
- }
79
-
80
- public function getOrElse($default)
81
- {
82
- return $this->option()->getOrElse($default);
83
- }
84
-
85
- public function getOrCall($callable)
86
- {
87
- return $this->option()->getOrCall($callable);
88
- }
89
-
90
- public function getOrThrow(\Exception $ex)
91
- {
92
- return $this->option()->getOrThrow($ex);
93
- }
94
-
95
- public function orElse(Option $else)
96
- {
97
- return $this->option()->orElse($else);
98
- }
99
-
100
- public function ifDefined($callable)
101
- {
102
- $this->option()->forAll($callable);
103
- }
104
-
105
- public function forAll($callable)
106
- {
107
- return $this->option()->forAll($callable);
108
- }
109
-
110
- public function map($callable)
111
- {
112
- return $this->option()->map($callable);
113
- }
114
-
115
- public function flatMap($callable)
116
- {
117
- return $this->option()->flatMap($callable);
118
- }
119
-
120
- public function filter($callable)
121
- {
122
- return $this->option()->filter($callable);
123
- }
124
-
125
- public function filterNot($callable)
126
- {
127
- return $this->option()->filterNot($callable);
128
- }
129
-
130
- public function select($value)
131
- {
132
- return $this->option()->select($value);
133
- }
134
-
135
- public function reject($value)
136
- {
137
- return $this->option()->reject($value);
138
- }
139
-
140
- /**
141
- * @return Traversable<T>
142
- */
143
- public function getIterator(): Traversable
144
- {
145
- return $this->option()->getIterator();
146
- }
147
-
148
- public function foldLeft($initialValue, $callable)
149
- {
150
- return $this->option()->foldLeft($initialValue, $callable);
151
- }
152
-
153
- public function foldRight($initialValue, $callable)
154
- {
155
- return $this->option()->foldRight($initialValue, $callable);
156
- }
157
-
158
- /**
159
- * @return Option<T>
160
- */
161
- private function option(): Option
162
- {
163
- if (null === $this->option) {
164
- /** @var mixed */
165
- $option = call_user_func_array($this->callback, $this->arguments);
166
- if ($option instanceof Option) {
167
- $this->option = $option;
168
- } else {
169
- throw new \RuntimeException(sprintf('Expected instance of %s', Option::class));
170
- }
171
- }
172
-
173
- return $this->option;
174
- }
175
- }
1
+ <?php
2
+
3
+ /*
4
+ * Copyright 2012 Johannes M. Schmitt <schmittjoh@gmail.com>
5
+ *
6
+ * Licensed under the Apache License, Version 2.0 (the "License");
7
+ * you may not use this file except in compliance with the License.
8
+ * You may obtain a copy of the License at
9
+ *
10
+ * http://www.apache.org/licenses/LICENSE-2.0
11
+ *
12
+ * Unless required by applicable law or agreed to in writing, software
13
+ * distributed under the License is distributed on an "AS IS" BASIS,
14
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
+ * See the License for the specific language governing permissions and
16
+ * limitations under the License.
17
+ */
18
+
19
+ namespace PhpOption;
20
+
21
+ use Traversable;
22
+
23
+ /**
24
+ * @template T
25
+ *
26
+ * @extends Option<T>
27
+ */
28
+ final class LazyOption extends Option
29
+ {
30
+ /** @var callable(mixed...):(Option<T>) */
31
+ private $callback;
32
+
33
+ /** @var array<int, mixed> */
34
+ private $arguments;
35
+
36
+ /** @var Option<T>|null */
37
+ private $option;
38
+
39
+ /**
40
+ * @template S
41
+ * @param callable(mixed...):(Option<S>) $callback
42
+ * @param array<int, mixed> $arguments
43
+ *
44
+ * @return LazyOption<S>
45
+ */
46
+ public static function create($callback, array $arguments = []): self
47
+ {
48
+ return new self($callback, $arguments);
49
+ }
50
+
51
+ /**
52
+ * @param callable(mixed...):(Option<T>) $callback
53
+ * @param array<int, mixed> $arguments
54
+ */
55
+ public function __construct($callback, array $arguments = [])
56
+ {
57
+ if (!is_callable($callback)) {
58
+ throw new \InvalidArgumentException('Invalid callback given');
59
+ }
60
+
61
+ $this->callback = $callback;
62
+ $this->arguments = $arguments;
63
+ }
64
+
65
+ public function isDefined(): bool
66
+ {
67
+ return $this->option()->isDefined();
68
+ }
69
+
70
+ public function isEmpty(): bool
71
+ {
72
+ return $this->option()->isEmpty();
73
+ }
74
+
75
+ public function get()
76
+ {
77
+ return $this->option()->get();
78
+ }
79
+
80
+ public function getOrElse($default)
81
+ {
82
+ return $this->option()->getOrElse($default);
83
+ }
84
+
85
+ public function getOrCall($callable)
86
+ {
87
+ return $this->option()->getOrCall($callable);
88
+ }
89
+
90
+ public function getOrThrow(\Exception $ex)
91
+ {
92
+ return $this->option()->getOrThrow($ex);
93
+ }
94
+
95
+ public function orElse(Option $else)
96
+ {
97
+ return $this->option()->orElse($else);
98
+ }
99
+
100
+ public function ifDefined($callable)
101
+ {
102
+ $this->option()->forAll($callable);
103
+ }
104
+
105
+ public function forAll($callable)
106
+ {
107
+ return $this->option()->forAll($callable);
108
+ }
109
+
110
+ public function map($callable)
111
+ {
112
+ return $this->option()->map($callable);
113
+ }
114
+
115
+ public function flatMap($callable)
116
+ {
117
+ return $this->option()->flatMap($callable);
118
+ }
119
+
120
+ public function filter($callable)
121
+ {
122
+ return $this->option()->filter($callable);
123
+ }
124
+
125
+ public function filterNot($callable)
126
+ {
127
+ return $this->option()->filterNot($callable);
128
+ }
129
+
130
+ public function select($value)
131
+ {
132
+ return $this->option()->select($value);
133
+ }
134
+
135
+ public function reject($value)
136
+ {
137
+ return $this->option()->reject($value);
138
+ }
139
+
140
+ /**
141
+ * @return Traversable<T>
142
+ */
143
+ public function getIterator(): Traversable
144
+ {
145
+ return $this->option()->getIterator();
146
+ }
147
+
148
+ public function foldLeft($initialValue, $callable)
149
+ {
150
+ return $this->option()->foldLeft($initialValue, $callable);
151
+ }
152
+
153
+ public function foldRight($initialValue, $callable)
154
+ {
155
+ return $this->option()->foldRight($initialValue, $callable);
156
+ }
157
+
158
+ /**
159
+ * @return Option<T>
160
+ */
161
+ private function option(): Option
162
+ {
163
+ if (null === $this->option) {
164
+ /** @var mixed */
165
+ $option = call_user_func_array($this->callback, $this->arguments);
166
+ if ($option instanceof Option) {
167
+ $this->option = $option;
168
+ } else {
169
+ throw new \RuntimeException(sprintf('Expected instance of %s', Option::class));
170
+ }
171
+ }
172
+
173
+ return $this->option;
174
+ }
175
+ }
@@ -1,136 +1,136 @@
1
- <?php
2
-
3
- /*
4
- * Copyright 2012 Johannes M. Schmitt <schmittjoh@gmail.com>
5
- *
6
- * Licensed under the Apache License, Version 2.0 (the "License");
7
- * you may not use this file except in compliance with the License.
8
- * You may obtain a copy of the License at
9
- *
10
- * http://www.apache.org/licenses/LICENSE-2.0
11
- *
12
- * Unless required by applicable law or agreed to in writing, software
13
- * distributed under the License is distributed on an "AS IS" BASIS,
14
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
- * See the License for the specific language governing permissions and
16
- * limitations under the License.
17
- */
18
-
19
- namespace PhpOption;
20
-
21
- use EmptyIterator;
22
-
23
- /**
24
- * @extends Option<mixed>
25
- */
26
- final class None extends Option
27
- {
28
- /** @var None|null */
29
- private static $instance;
30
-
31
- /**
32
- * @return None
33
- */
34
- public static function create(): self
35
- {
36
- if (null === self::$instance) {
37
- self::$instance = new self();
38
- }
39
-
40
- return self::$instance;
41
- }
42
-
43
- public function get()
44
- {
45
- throw new \RuntimeException('None has no value.');
46
- }
47
-
48
- public function getOrCall($callable)
49
- {
50
- return $callable();
51
- }
52
-
53
- public function getOrElse($default)
54
- {
55
- return $default;
56
- }
57
-
58
- public function getOrThrow(\Exception $ex)
59
- {
60
- throw $ex;
61
- }
62
-
63
- public function isEmpty(): bool
64
- {
65
- return true;
66
- }
67
-
68
- public function isDefined(): bool
69
- {
70
- return false;
71
- }
72
-
73
- public function orElse(Option $else)
74
- {
75
- return $else;
76
- }
77
-
78
- public function ifDefined($callable)
79
- {
80
- // Just do nothing in that case.
81
- }
82
-
83
- public function forAll($callable)
84
- {
85
- return $this;
86
- }
87
-
88
- public function map($callable)
89
- {
90
- return $this;
91
- }
92
-
93
- public function flatMap($callable)
94
- {
95
- return $this;
96
- }
97
-
98
- public function filter($callable)
99
- {
100
- return $this;
101
- }
102
-
103
- public function filterNot($callable)
104
- {
105
- return $this;
106
- }
107
-
108
- public function select($value)
109
- {
110
- return $this;
111
- }
112
-
113
- public function reject($value)
114
- {
115
- return $this;
116
- }
117
-
118
- public function getIterator(): EmptyIterator
119
- {
120
- return new EmptyIterator();
121
- }
122
-
123
- public function foldLeft($initialValue, $callable)
124
- {
125
- return $initialValue;
126
- }
127
-
128
- public function foldRight($initialValue, $callable)
129
- {
130
- return $initialValue;
131
- }
132
-
133
- private function __construct()
134
- {
135
- }
136
- }
1
+ <?php
2
+
3
+ /*
4
+ * Copyright 2012 Johannes M. Schmitt <schmittjoh@gmail.com>
5
+ *
6
+ * Licensed under the Apache License, Version 2.0 (the "License");
7
+ * you may not use this file except in compliance with the License.
8
+ * You may obtain a copy of the License at
9
+ *
10
+ * http://www.apache.org/licenses/LICENSE-2.0
11
+ *
12
+ * Unless required by applicable law or agreed to in writing, software
13
+ * distributed under the License is distributed on an "AS IS" BASIS,
14
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
+ * See the License for the specific language governing permissions and
16
+ * limitations under the License.
17
+ */
18
+
19
+ namespace PhpOption;
20
+
21
+ use EmptyIterator;
22
+
23
+ /**
24
+ * @extends Option<mixed>
25
+ */
26
+ final class None extends Option
27
+ {
28
+ /** @var None|null */
29
+ private static $instance;
30
+
31
+ /**
32
+ * @return None
33
+ */
34
+ public static function create(): self
35
+ {
36
+ if (null === self::$instance) {
37
+ self::$instance = new self();
38
+ }
39
+
40
+ return self::$instance;
41
+ }
42
+
43
+ public function get()
44
+ {
45
+ throw new \RuntimeException('None has no value.');
46
+ }
47
+
48
+ public function getOrCall($callable)
49
+ {
50
+ return $callable();
51
+ }
52
+
53
+ public function getOrElse($default)
54
+ {
55
+ return $default;
56
+ }
57
+
58
+ public function getOrThrow(\Exception $ex)
59
+ {
60
+ throw $ex;
61
+ }
62
+
63
+ public function isEmpty(): bool
64
+ {
65
+ return true;
66
+ }
67
+
68
+ public function isDefined(): bool
69
+ {
70
+ return false;
71
+ }
72
+
73
+ public function orElse(Option $else)
74
+ {
75
+ return $else;
76
+ }
77
+
78
+ public function ifDefined($callable)
79
+ {
80
+ // Just do nothing in that case.
81
+ }
82
+
83
+ public function forAll($callable)
84
+ {
85
+ return $this;
86
+ }
87
+
88
+ public function map($callable)
89
+ {
90
+ return $this;
91
+ }
92
+
93
+ public function flatMap($callable)
94
+ {
95
+ return $this;
96
+ }
97
+
98
+ public function filter($callable)
99
+ {
100
+ return $this;
101
+ }
102
+
103
+ public function filterNot($callable)
104
+ {
105
+ return $this;
106
+ }
107
+
108
+ public function select($value)
109
+ {
110
+ return $this;
111
+ }
112
+
113
+ public function reject($value)
114
+ {
115
+ return $this;
116
+ }
117
+
118
+ public function getIterator(): EmptyIterator
119
+ {
120
+ return new EmptyIterator();
121
+ }
122
+
123
+ public function foldLeft($initialValue, $callable)
124
+ {
125
+ return $initialValue;
126
+ }
127
+
128
+ public function foldRight($initialValue, $callable)
129
+ {
130
+ return $initialValue;
131
+ }
132
+
133
+ private function __construct()
134
+ {
135
+ }
136
+ }