create-berna-stencil 2.0.8 → 2.0.9

package/src/backend/_core/vendor/vlucas/phpdotenv/src/Validator.php

@@ -1,207 +1,207 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Dotenv;
-
-use Dotenv\Exception\ValidationException;
-use Dotenv\Repository\RepositoryInterface;
-use Dotenv\Util\Regex;
-use Dotenv\Util\Str;
-
-class Validator
-{
-    /**
-     * The environment repository instance.
-     *
-     * @var \Dotenv\Repository\RepositoryInterface
-     */
-    private $repository;
-
-    /**
-     * The variables to validate.
-     *
-     * @var string[]
-     */
-    private $variables;
-
-    /**
-     * Create a new validator instance.
-     *
-     * @param \Dotenv\Repository\RepositoryInterface $repository
-     * @param string[]                               $variables
-     *
-     * @return void
-     */
-    public function __construct(RepositoryInterface $repository, array $variables)
-    {
-        $this->repository = $repository;
-        $this->variables = $variables;
-    }
-
-    /**
-     * Assert that each variable is present.
-     *
-     * @throws \Dotenv\Exception\ValidationException
-     *
-     * @return \Dotenv\Validator
-     */
-    public function required()
-    {
-        return $this->assert(
-            static function (?string $value) {
-                return $value !== null;
-            },
-            'is missing'
-        );
-    }
-
-    /**
-     * Assert that each variable is not empty.
-     *
-     * @throws \Dotenv\Exception\ValidationException
-     *
-     * @return \Dotenv\Validator
-     */
-    public function notEmpty()
-    {
-        return $this->assertNullable(
-            static function (string $value) {
-                return Str::len(\trim($value)) > 0;
-            },
-            'is empty'
-        );
-    }
-
-    /**
-     * Assert that each specified variable is an integer.
-     *
-     * @throws \Dotenv\Exception\ValidationException
-     *
-     * @return \Dotenv\Validator
-     */
-    public function isInteger()
-    {
-        return $this->assertNullable(
-            static function (string $value) {
-                return \ctype_digit($value);
-            },
-            'is not an integer'
-        );
-    }
-
-    /**
-     * Assert that each specified variable is a boolean.
-     *
-     * @throws \Dotenv\Exception\ValidationException
-     *
-     * @return \Dotenv\Validator
-     */
-    public function isBoolean()
-    {
-        return $this->assertNullable(
-            static function (string $value) {
-                if ($value === '') {
-                    return false;
-                }
-
-                return \filter_var($value, \FILTER_VALIDATE_BOOLEAN, \FILTER_NULL_ON_FAILURE) !== null;
-            },
-            'is not a boolean'
-        );
-    }
-
-    /**
-     * Assert that each variable is amongst the given choices.
-     *
-     * @param string[] $choices
-     *
-     * @throws \Dotenv\Exception\ValidationException
-     *
-     * @return \Dotenv\Validator
-     */
-    public function allowedValues(array $choices)
-    {
-        return $this->assertNullable(
-            static function (string $value) use ($choices) {
-                return \in_array($value, $choices, true);
-            },
-            \sprintf('is not one of [%s]', \implode(', ', $choices))
-        );
-    }
-
-    /**
-     * Assert that each variable matches the given regular expression.
-     *
-     * @param string $regex
-     *
-     * @throws \Dotenv\Exception\ValidationException
-     *
-     * @return \Dotenv\Validator
-     */
-    public function allowedRegexValues(string $regex)
-    {
-        return $this->assertNullable(
-            static function (string $value) use ($regex) {
-                return Regex::matches($regex, $value)->success()->getOrElse(false);
-            },
-            \sprintf('does not match "%s"', $regex)
-        );
-    }
-
-    /**
-     * Assert that the callback returns true for each variable.
-     *
-     * @param callable(?string):bool $callback
-     * @param string                 $message
-     *
-     * @throws \Dotenv\Exception\ValidationException
-     *
-     * @return \Dotenv\Validator
-     */
-    public function assert(callable $callback, string $message)
-    {
-        $failing = [];
-
-        foreach ($this->variables as $variable) {
-            if ($callback($this->repository->get($variable)) === false) {
-                $failing[] = \sprintf('%s %s', $variable, $message);
-            }
-        }
-
-        if (\count($failing) > 0) {
-            throw new ValidationException(\sprintf(
-                'One or more environment variables failed assertions: %s.',
-                \implode(', ', $failing)
-            ));
-        }
-
-        return $this;
-    }
-
-    /**
-     * Assert that the callback returns true for each variable.
-     *
-     * Skip checking null variable values.
-     *
-     * @param callable(string):bool $callback
-     * @param string                $message
-     *
-     * @throws \Dotenv\Exception\ValidationException
-     *
-     * @return \Dotenv\Validator
-     */
-    public function assertNullable(callable $callback, string $message)
-    {
-        return $this->assert(
-            static function (?string $value) use ($callback) {
-                if ($value === null) {
-                    return true;
-                }
-
-                return $callback($value);
-            },
-            $message
-        );
-    }
-}
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv;
+
+use Dotenv\Exception\ValidationException;
+use Dotenv\Repository\RepositoryInterface;
+use Dotenv\Util\Regex;
+use Dotenv\Util\Str;
+
+class Validator
+{
+    /**
+     * The environment repository instance.
+     *
+     * @var \Dotenv\Repository\RepositoryInterface
+     */
+    private $repository;
+
+    /**
+     * The variables to validate.
+     *
+     * @var string[]
+     */
+    private $variables;
+
+    /**
+     * Create a new validator instance.
+     *
+     * @param \Dotenv\Repository\RepositoryInterface $repository
+     * @param string[]                               $variables
+     *
+     * @return void
+     */
+    public function __construct(RepositoryInterface $repository, array $variables)
+    {
+        $this->repository = $repository;
+        $this->variables = $variables;
+    }
+
+    /**
+     * Assert that each variable is present.
+     *
+     * @throws \Dotenv\Exception\ValidationException
+     *
+     * @return \Dotenv\Validator
+     */
+    public function required()
+    {
+        return $this->assert(
+            static function (?string $value) {
+                return $value !== null;
+            },
+            'is missing'
+        );
+    }
+
+    /**
+     * Assert that each variable is not empty.
+     *
+     * @throws \Dotenv\Exception\ValidationException
+     *
+     * @return \Dotenv\Validator
+     */
+    public function notEmpty()
+    {
+        return $this->assertNullable(
+            static function (string $value) {
+                return Str::len(\trim($value)) > 0;
+            },
+            'is empty'
+        );
+    }
+
+    /**
+     * Assert that each specified variable is an integer.
+     *
+     * @throws \Dotenv\Exception\ValidationException
+     *
+     * @return \Dotenv\Validator
+     */
+    public function isInteger()
+    {
+        return $this->assertNullable(
+            static function (string $value) {
+                return \ctype_digit($value);
+            },
+            'is not an integer'
+        );
+    }
+
+    /**
+     * Assert that each specified variable is a boolean.
+     *
+     * @throws \Dotenv\Exception\ValidationException
+     *
+     * @return \Dotenv\Validator
+     */
+    public function isBoolean()
+    {
+        return $this->assertNullable(
+            static function (string $value) {
+                if ($value === '') {
+                    return false;
+                }
+
+                return \filter_var($value, \FILTER_VALIDATE_BOOLEAN, \FILTER_NULL_ON_FAILURE) !== null;
+            },
+            'is not a boolean'
+        );
+    }
+
+    /**
+     * Assert that each variable is amongst the given choices.
+     *
+     * @param string[] $choices
+     *
+     * @throws \Dotenv\Exception\ValidationException
+     *
+     * @return \Dotenv\Validator
+     */
+    public function allowedValues(array $choices)
+    {
+        return $this->assertNullable(
+            static function (string $value) use ($choices) {
+                return \in_array($value, $choices, true);
+            },
+            \sprintf('is not one of [%s]', \implode(', ', $choices))
+        );
+    }
+
+    /**
+     * Assert that each variable matches the given regular expression.
+     *
+     * @param string $regex
+     *
+     * @throws \Dotenv\Exception\ValidationException
+     *
+     * @return \Dotenv\Validator
+     */
+    public function allowedRegexValues(string $regex)
+    {
+        return $this->assertNullable(
+            static function (string $value) use ($regex) {
+                return Regex::matches($regex, $value)->success()->getOrElse(false);
+            },
+            \sprintf('does not match "%s"', $regex)
+        );
+    }
+
+    /**
+     * Assert that the callback returns true for each variable.
+     *
+     * @param callable(?string):bool $callback
+     * @param string                 $message
+     *
+     * @throws \Dotenv\Exception\ValidationException
+     *
+     * @return \Dotenv\Validator
+     */
+    public function assert(callable $callback, string $message)
+    {
+        $failing = [];
+
+        foreach ($this->variables as $variable) {
+            if ($callback($this->repository->get($variable)) === false) {
+                $failing[] = \sprintf('%s %s', $variable, $message);
+            }
+        }
+
+        if (\count($failing) > 0) {
+            throw new ValidationException(\sprintf(
+                'One or more environment variables failed assertions: %s.',
+                \implode(', ', $failing)
+            ));
+        }
+
+        return $this;
+    }
+
+    /**
+     * Assert that the callback returns true for each variable.
+     *
+     * Skip checking null variable values.
+     *
+     * @param callable(string):bool $callback
+     * @param string                $message
+     *
+     * @throws \Dotenv\Exception\ValidationException
+     *
+     * @return \Dotenv\Validator
+     */
+    public function assertNullable(callable $callback, string $message)
+    {
+        return $this->assert(
+            static function (?string $value) use ($callback) {
+                if ($value === null) {
+                    return true;
+                }
+
+                return $callback($value);
+            },
+            $message
+        );
+    }
+}

package/src/frontend/components/layouts/base.njk

@@ -1,4 +1,4 @@
-<!-- This is the base of everypage that you will create -->
+<!-- This is the base of every page that you will create -->
 
 <!DOCTYPE html>
 <html lang="{{ site.lang or 'en' }}" data-bs-theme="{{ site.data_bs_theme or 'light' }}">
@@ -7,19 +7,28 @@
         <meta charset="UTF-8">
         <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
-        <!-- Page Data based on Page Title -->
+        {# Preconnect hints — establish early connections to external origins #}
+        <link rel="preconnect" href="https://cdn.jsdelivr.net" crossorigin>
+
+      {#╔══════════════════╗
+        ║    PAGE DATA     ║
+        ╚══════════════════╝#}
+
         {% set pageKey = title %}
         {% set pageData = site.pages[pageKey] %}
 
-        <!-- SEO Meta Tags -->
+      {#╔══════════════════╗
+        ║       SEO        ║
+        ╚══════════════════╝#}
+
         <link rel="canonical" href="{{ site.url }}{{ page.url }}"/>
         <title>{{ pageData.seo.title or title or site.title }}</title>
         <meta name="description" content="{{ pageData.seo.description or site.description }}">
         <meta name="keywords" content="{{ site.keywords }}">
         <meta name="author" content="{{ site.author }}">
-        <meta name="theme-color" content="" >
+        <meta name="theme-color" content="">
 
-        <!-- Open Graph -->
+        {# Open Graph #}
         <meta property="og:title" content="{{ pageData.seo.title }}">
         <meta property="og:description" content="{{ pageData.seo.description }}">
         <meta property="og:type" content="website">
@@ -27,15 +36,16 @@
         <meta property="og:image" content="{{ site.url }}{{ site.logo }}">
         <meta property="og:site-name" content="{{ site.site-name }}">
 
-        <!-- Twitter Card -->
+        {# Twitter Card #}
         <meta name="twitter:card" content="summary_large_image">
         <meta name="twitter:title" content="{{ pageData.seo.title }}">
         <meta name="twitter:description" content="{{ pageData.seo.description }}">
         <meta name="twitter:image" content="{{ site.url }}{{ site.logo }}">
 
-        <!-- ========================================== -->
-        <!-- JSON-LD / Structured data for SEO and AI   -->
-        <!-- ========================================== -->
+      {#╔══════════════════════════════════════════╗
+        ║   JSON-LD — Structured data for SEO/AI  ║
+        ╚══════════════════════════════════════════╝#}
+
         <script type="application/ld+json">
         {
             "@context": "https://schema.org",
@@ -58,67 +68,70 @@
         }
         </script>
 
-        <!-- Favicon -->
+      {#╔══════════════════╗
+        ║     FAVICON      ║
+        ╚══════════════════╝#}
+
         <link rel="icon" type="image/svg+xml" href="{{ site.favicon }}">
-        <!-- (If you want to use a PNG favicon) -->
         {#
         <link rel="icon" type="image/png" href="/assets/favicon.png">
         <link rel="apple-touch-icon" href="/assets/favicon.png">
         #}
 
-        <!-- CSS -->
-        {# preconnect to jsdelivr — only needed if loading scripts from CDN #}
-        <link rel="preconnect" href="https://cdn.jsdelivr.net" crossorigin data-iub-purposes="1" data-cmp-ab="1">
-        <link rel="stylesheet" href="/css/pages/{{ title }}.css" />
-        
+      {#╔══════════════════╗
+        ║       CSS        ║
+        ╚══════════════════╝#}
+
+        {# Markdown — theme-aware #}
+        {% if site.data_bs_theme == "dark" %}
+        <link rel="stylesheet" href="/css/github-markdown-dark.css">
+        {% else %}
+        <link rel="stylesheet" href="/css/github-markdown-light.css">
+        {% endif %}
+
+        {# Page CSS #}
+        <link rel="stylesheet" href="/css/pages/{{ title }}.css"/>
+
+        {# Per-page CDN CSS #}
         {% if pageData and pageData.cdn and pageData.cdn.css %}
             {% for link in pageData.cdn.css %}
                 <link rel="stylesheet" href="{{ link }}">
             {% endfor %}
         {% endif %}
+
     </head>
 
     <body>
-        <!-- Header -->
+
         {% include "global/header.njk" %}
 
-        <!-- Main -->
         <main>
             {{ content | safe }}
         </main>
 
-        <!-- Footer -->
         {% include "global/footer.njk" %}
 
-        <!-- SCRIPTS -->
-
-        {#
-        ╔═══════════════════════════════════════════╗
-        ║              FRAMEWORK SCRIPTS            ║
-        ║  Uncomment the framework JS you are using ║
-        ║  Bulma requires no JS — CSS only          ║
-        ╚═══════════════════════════════════════════╝
-        #}
+      {#╔══════════════════╗
+        ║     SCRIPTS      ║
+        ╚══════════════════╝#}
 
-        {# Bootstrap JS — comment out if using Bulma or Foundation #}
+        {# Framework — uncomment the one you are using #}
         <script src="/js/bootstrap.bundle.min.js" defer></script>
-
-        {# Foundation JS — uncomment if using Foundation #}
         {# <script src="/js/foundation.min.js" defer></script> #}
-
-        {# UIkit JS — uncomment if using UIkit #}
         {# <script src="/js/uikit.min.js" defer></script> #}
         {# <script src="/js/uikit-icons.min.js" defer></script> #}
-
         {# Bulma — no JS needed #}
 
+        {# Per-page CDN JS #}
         {% if pageData and pageData.cdn and pageData.cdn.js %}
             {% for script in pageData.cdn.js %}
                 <script src="{{ script }}" defer></script>
             {% endfor %}
         {% endif %}
 
+        {# Page JS #}
         <script src="/js/pages/{{ title }}.js"></script>
+
     </body>
 
 </html>