create-berna-stencil 1.0.46 → 1.0.48

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 (185) hide show
  1. package/_tools/res/templates/template.scss +6 -0
  2. package/bin/create.js +2 -1
  3. package/docs/Assistant CLI.md +36 -0
  4. package/docs/Components.md +63 -0
  5. package/docs/Creating pages.md +46 -0
  6. package/docs/Head and SEO.md +44 -0
  7. package/docs/Javascript.md +53 -0
  8. package/docs/Styling with SCSS.md +114 -0
  9. package/package.json +3 -15
  10. package/src/backend/_core/vendor/composer/autoload_static.php +10 -10
  11. package/src/backend/_core/vendor/composer/installed.json +6 -6
  12. package/src/backend/_core/vendor/composer/installed.php +2 -2
  13. package/src/backend/_core/vendor/graham-campbell/result-type/LICENSE +21 -21
  14. package/src/backend/_core/vendor/graham-campbell/result-type/composer.json +33 -33
  15. package/src/backend/_core/vendor/graham-campbell/result-type/src/Error.php +121 -121
  16. package/src/backend/_core/vendor/graham-campbell/result-type/src/Result.php +69 -69
  17. package/src/backend/_core/vendor/graham-campbell/result-type/src/Success.php +120 -120
  18. package/src/backend/_core/vendor/phpoption/phpoption/LICENSE +200 -200
  19. package/src/backend/_core/vendor/phpoption/phpoption/composer.json +50 -50
  20. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/LazyOption.php +175 -175
  21. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/None.php +136 -136
  22. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/Option.php +434 -434
  23. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/Some.php +169 -169
  24. package/src/backend/_core/vendor/symfony/polyfill-ctype/Ctype.php +232 -232
  25. package/src/backend/_core/vendor/symfony/polyfill-ctype/LICENSE +19 -19
  26. package/src/backend/_core/vendor/symfony/polyfill-ctype/README.md +12 -12
  27. package/src/backend/_core/vendor/symfony/polyfill-ctype/bootstrap.php +50 -50
  28. package/src/backend/_core/vendor/symfony/polyfill-ctype/bootstrap80.php +46 -46
  29. package/src/backend/_core/vendor/symfony/polyfill-ctype/composer.json +38 -38
  30. package/src/backend/_core/vendor/symfony/polyfill-mbstring/LICENSE +19 -19
  31. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Mbstring.php +1077 -1077
  32. package/src/backend/_core/vendor/symfony/polyfill-mbstring/README.md +13 -13
  33. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/caseFolding.php +119 -119
  34. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/lowerCase.php +1397 -1397
  35. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/titleCaseRegexp.php +5 -5
  36. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/upperCase.php +1489 -1489
  37. package/src/backend/_core/vendor/symfony/polyfill-mbstring/bootstrap.php +171 -171
  38. package/src/backend/_core/vendor/symfony/polyfill-mbstring/bootstrap80.php +167 -167
  39. package/src/backend/_core/vendor/symfony/polyfill-mbstring/composer.json +39 -39
  40. package/src/backend/_core/vendor/symfony/polyfill-php80/LICENSE +19 -19
  41. package/src/backend/_core/vendor/symfony/polyfill-php80/Php80.php +115 -115
  42. package/src/backend/_core/vendor/symfony/polyfill-php80/PhpToken.php +106 -106
  43. package/src/backend/_core/vendor/symfony/polyfill-php80/README.md +25 -25
  44. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/Attribute.php +31 -31
  45. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/PhpToken.php +16 -16
  46. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/Stringable.php +20 -20
  47. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/UnhandledMatchError.php +16 -16
  48. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/ValueError.php +16 -16
  49. package/src/backend/_core/vendor/symfony/polyfill-php80/bootstrap.php +42 -42
  50. package/src/backend/_core/vendor/symfony/polyfill-php80/composer.json +37 -37
  51. package/src/backend/_core/vendor/vlucas/phpdotenv/LICENSE +30 -30
  52. package/src/backend/_core/vendor/vlucas/phpdotenv/composer.json +60 -60
  53. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Dotenv.php +267 -267
  54. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/ExceptionInterface.php +12 -12
  55. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/InvalidEncodingException.php +12 -12
  56. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/InvalidFileException.php +12 -12
  57. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/InvalidPathException.php +12 -12
  58. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/ValidationException.php +12 -12
  59. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Loader/Loader.php +48 -48
  60. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Loader/LoaderInterface.php +20 -20
  61. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Loader/Resolver.php +65 -65
  62. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Entry.php +59 -59
  63. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/EntryParser.php +299 -299
  64. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Lexer.php +58 -58
  65. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Lines.php +127 -127
  66. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Parser.php +53 -53
  67. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/ParserInterface.php +19 -19
  68. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Value.php +88 -88
  69. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/AdapterInterface.php +15 -15
  70. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ApacheAdapter.php +89 -89
  71. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ArrayAdapter.php +80 -80
  72. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/EnvConstAdapter.php +88 -88
  73. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/GuardedWriter.php +85 -85
  74. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ImmutableWriter.php +110 -110
  75. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiReader.php +48 -48
  76. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiWriter.php +64 -64
  77. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/PutenvAdapter.php +91 -91
  78. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReaderInterface.php +17 -17
  79. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReplacingWriter.php +104 -104
  80. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ServerConstAdapter.php +88 -88
  81. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/WriterInterface.php +27 -27
  82. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/AdapterRepository.php +107 -107
  83. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/RepositoryBuilder.php +272 -272
  84. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/RepositoryInterface.php +51 -51
  85. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/File/Paths.php +44 -44
  86. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/File/Reader.php +81 -81
  87. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/FileStore.php +72 -72
  88. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/StoreBuilder.php +141 -141
  89. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/StoreInterface.php +17 -17
  90. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/StringStore.php +37 -37
  91. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Util/Regex.php +112 -112
  92. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Util/Str.php +108 -108
  93. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Validator.php +207 -207
  94. package/src/backend/api/protected/subfolder/example-protected.php +0 -4
  95. package/src/backend/api/public/example-public.php +0 -4
  96. package/src/frontend/components/layouts/includes.njk +0 -3
  97. package/src/frontend/data/site.json +0 -10
  98. package/src/frontend/scss/modules/_root.scss +2 -4
  99. package/src/frontend/scss/modules/frameworks/_bootstrap.scss +0 -1
  100. package/src/frontend/scss/modules/frameworks/_bulma.scss +0 -1
  101. package/src/frontend/scss/modules/frameworks/_foundation.scss +0 -1
  102. package/src/frontend/scss/modules/frameworks/_uikit.scss +0 -1
  103. package/src/frontend/scss/pages/404.scss +3 -1
  104. package/src/frontend/scss/pages/homepage.scss +3 -1
  105. package/src/backend/_core/vendor/graham-campbell/result-type/.gitattributes +0 -9
  106. package/src/backend/_core/vendor/graham-campbell/result-type/.github/CODE_OF_CONDUCT.md +0 -132
  107. package/src/backend/_core/vendor/graham-campbell/result-type/.github/CONTRIBUTING.md +0 -31
  108. package/src/backend/_core/vendor/graham-campbell/result-type/.github/FUNDING.yml +0 -2
  109. package/src/backend/_core/vendor/graham-campbell/result-type/.github/SECURITY.md +0 -14
  110. package/src/backend/_core/vendor/graham-campbell/result-type/.github/workflows/stale.yml +0 -11
  111. package/src/backend/_core/vendor/graham-campbell/result-type/.github/workflows/tests.yml +0 -40
  112. package/src/backend/_core/vendor/graham-campbell/result-type/CHANGELOG.md +0 -53
  113. package/src/backend/_core/vendor/graham-campbell/result-type/README.md +0 -42
  114. package/src/backend/_core/vendor/graham-campbell/result-type/phpunit.xml.dist +0 -13
  115. package/src/backend/_core/vendor/graham-campbell/result-type/tests/ResultTest.php +0 -95
  116. package/src/backend/_core/vendor/phpoption/phpoption/.gitattributes +0 -13
  117. package/src/backend/_core/vendor/phpoption/phpoption/.github/CODE_OF_CONDUCT.md +0 -132
  118. package/src/backend/_core/vendor/phpoption/phpoption/.github/CONTRIBUTING.md +0 -30
  119. package/src/backend/_core/vendor/phpoption/phpoption/.github/FUNDING.yml +0 -2
  120. package/src/backend/_core/vendor/phpoption/phpoption/.github/SECURITY.md +0 -14
  121. package/src/backend/_core/vendor/phpoption/phpoption/.github/workflows/static.yml +0 -40
  122. package/src/backend/_core/vendor/phpoption/phpoption/.github/workflows/tests.yml +0 -40
  123. package/src/backend/_core/vendor/phpoption/phpoption/Makefile +0 -17
  124. package/src/backend/_core/vendor/phpoption/phpoption/README.md +0 -201
  125. package/src/backend/_core/vendor/phpoption/phpoption/phpstan-baseline.neon +0 -44
  126. package/src/backend/_core/vendor/phpoption/phpoption/phpstan.neon.dist +0 -7
  127. package/src/backend/_core/vendor/phpoption/phpoption/phpunit.xml.dist +0 -13
  128. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/EnsureTest.php +0 -72
  129. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/LazyOptionTest.php +0 -357
  130. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/NoneTest.php +0 -153
  131. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/OptionTest.php +0 -166
  132. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/SomeTest.php +0 -194
  133. package/src/backend/_core/vendor/phpoption/phpoption/tests/bootstrap.php +0 -8
  134. package/src/backend/_core/vendor/phpoption/phpoption/vendor-bin/phpstan/composer.json +0 -8
  135. package/src/backend/_core/vendor/vlucas/phpdotenv/.editorconfig +0 -15
  136. package/src/backend/_core/vendor/vlucas/phpdotenv/.gitattributes +0 -15
  137. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/CODE_OF_CONDUCT.md +0 -132
  138. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/CONTRIBUTING.md +0 -30
  139. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/FUNDING.yml +0 -2
  140. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/SECURITY.md +0 -14
  141. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/workflows/static.yml +0 -40
  142. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/workflows/tests.yml +0 -70
  143. package/src/backend/_core/vendor/vlucas/phpdotenv/Makefile +0 -17
  144. package/src/backend/_core/vendor/vlucas/phpdotenv/README.md +0 -370
  145. package/src/backend/_core/vendor/vlucas/phpdotenv/UPGRADING.md +0 -196
  146. package/src/backend/_core/vendor/vlucas/phpdotenv/phpstan-baseline.neon +0 -157
  147. package/src/backend/_core/vendor/vlucas/phpdotenv/phpstan.neon.dist +0 -7
  148. package/src/backend/_core/vendor/vlucas/phpdotenv/phpunit.xml.dist +0 -13
  149. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/DotenvTest.php +0 -387
  150. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Loader/LoaderTest.php +0 -86
  151. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/EntryParserTest.php +0 -234
  152. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/LexerTest.php +0 -40
  153. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/LinesTest.php +0 -53
  154. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/ParserTest.php +0 -98
  155. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/ArrayAdapterTest.php +0 -57
  156. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/EnvConstAdapterTest.php +0 -75
  157. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/PutenvAdapterTest.php +0 -52
  158. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/ServerConstAdapterTest.php +0 -75
  159. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/RepositoryTest.php +0 -305
  160. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Store/StoreTest.php +0 -141
  161. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/ValidatorTest.php +0 -479
  162. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/.env +0 -5
  163. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/assertions.env +0 -18
  164. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/booleans.env +0 -33
  165. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/commented.env +0 -15
  166. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/empty.env +0 -1
  167. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/example.env +0 -1
  168. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/exported.env +0 -7
  169. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/immutable.env +0 -1
  170. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/integers.env +0 -17
  171. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/large.env +0 -2
  172. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/multibyte.env +0 -3
  173. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/multiline.env +0 -14
  174. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/multiple.env +0 -4
  175. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/mutable.env +0 -1
  176. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/nested.env +0 -15
  177. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/quoted.env +0 -11
  178. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/specialchars.env +0 -8
  179. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/unicodevarnames.env +0 -2
  180. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/utf8-with-bom-encoding.env +0 -3
  181. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/windows.env +0 -1
  182. package/src/backend/_core/vendor/vlucas/phpdotenv/vendor-bin/phpstan/composer.json +0 -15
  183. package/src/frontend/_routes/example-page.njk +0 -9
  184. package/src/frontend/js/pages/examplePage.js +0 -19
  185. package/src/frontend/scss/pages/examplePage.scss +0 -17
@@ -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
+ }