create-berna-stencil 1.0.47 → 1.0.48

package/bin/create.js

@@ -8,6 +8,7 @@ const templateDir = path.join(__dirname, '..');
 
 const COPY_TARGETS = [
     'src',
+    "docs",
     '_tools',
     '.eleventy.js',
     '.eleventyignore',

package/docs/Assistant CLI.md

@@ -0,0 +1,36 @@
+# To be finished...
+
+# Assistant CLI
+
+`assistant.js` is a CLI tool to manage pages and project configuration without editing files manually.
+
+## Run
+```bash
+node assistant.js
+```
+
+## Options
+
+### 1. Create a page
+Enter a page name in kebab-case (e.g. `contact-us`). The CLI generates:
+
+| File | Purpose |
+|---|---|
+| `src/pages/contact-us.njk` | Page template |
+| `src/scss/pages/contactUs.scss` | Page styles |
+| `src/js/pages/contactUs.js` | Page scripts |
+
+It also registers the page automatically in:
+- `src/layouts/includes.njk` — adds an `elif` block for component routing
+- `src/data/site.json` — adds an SEO entry under `pages`
+
+> Protected pages (`homepage`, `404`) cannot be created or removed.
+
+### 2. Remove a page
+Enter the page name to delete all related files and clean up registrations.
+
+### 3. Configure output path
+Change the build output directory. Updates both `.eleventy.js` and `package.json` automatically.
+
+## Naming conventions
+Page names are always kebab-case for URLs and file names (`contact-us`), and camelCase for SCSS and JS (`contactUs`). The CLI handles the conversion automatically.

package/docs/Components.md

@@ -0,0 +1,63 @@
+# To be finished...
+
+# Components
+
+## Create a component
+
+Add a Nunjucks file in `src/components/`:
+
+```
+src/components/myComponent.njk
+```
+
+## Subfolders
+
+Components can be organized into subfolders freely. Some examples:
+
+```
+src/components/
+├── global/          # Header, footer — included in every page
+├── pages/           # Page-specific components
+│   ├── homepage.njk
+│   └── contactUs.njk
+└── modals/          # Shared modals (privacy, cookies, etc.)
+    └── privacyModal.njk
+```
+
+The include path must reflect the subfolder:
+
+```njk
+{% include "pages/homepage.njk" %}
+{% include "modals/privacyModal.njk" %}
+```
+
+## Register it for a page
+
+In `src/layouts/includes.njk`, find the `elif` block for your page and include the component:
+
+```njk
+{% elif title == "myPage" %}
+  {% include "myComponent.njk" %}
+```
+
+Multiple components can be included in the same block:
+
+```njk
+{% elif title == "myPage" %}
+  {% include "hero.njk" %}
+  {% include "features.njk" %}
+```
+
+## Global components
+
+Header and footer live in `src/components/global/` and are automatically included in every page via `base.njk`. Edit them to change the site-wide layout.
+
+## Site data in components
+
+All values from `src/data/site.json` are available as `{{ site.* }}`:
+
+```njk
+<p>{{ site.title }}</p>
+<a href="{{ site.legal.privacy }}">Privacy Policy</a>
+<img src="{{ site.logo }}" alt="{{ site.title }}">
+```

package/docs/Creating pages.md

@@ -0,0 +1,46 @@
+# To be finished...
+
+# Creating Pages
+
+The recommended way is via the [Assistant CLI](assistant-cli.md).
+
+## What gets created
+
+For a page named `my-page`:
+
+| File | Purpose |
+|---|---|
+| `src/pages/my-page.njk` | Template with front matter |
+| `src/scss/pages/myPage.scss` | Imports framework + modules |
+| `src/js/pages/myPage.js` | Imports JS modules |
+
+## Adding content
+
+1. Create a component in `src/components/` (e.g. `_myPage.njk`)
+2. Include it in `src/layouts/includes.njk` inside the generated `elif` block:
+
+```njk
+{% elif title == "myPage" %}
+  {% include "_myPage.njk" %}
+```
+
+See [components.md](components.md) for details.
+
+## URL and title
+
+The URL is the kebab-case name (`/my-page/`). The `title` in the front matter is camelCase (`myPage`) and is used internally to load the correct CSS and JS files — do not change it.
+
+## SEO
+
+The CLI creates a stub entry in `src/data/site.json`. Fill it in:
+
+```json
+"myPage": {
+  "seo": {
+    "title": "My Page | Site Name",
+    "description": "Page description"
+  }
+}
+```
+
+See [head-and-seo.md](head-and-seo.md) for all available options.

package/docs/Head and SEO.md

@@ -0,0 +1,44 @@
+# Head & SEO
+
+
+`src/frontend/data/site.json` holds global settings used across all pages in `base.njk` and other components:
+
+### site.json
+```json
+"site_name": "Site name",
+"title": "Site title",
+"description": "Site description",
+"keywords": "keyword1, keyword2, keyword3",
+"domain": "yoursite.com",
+"url": "https://yoursite.com",
+"lang": "en",
+"author": "Name and surname",
+"data_bs_theme": "dark",
+"favicon": "/assets/brand/favicon.svg",
+"logo": "/assets/brand/logo.svg",
+...
+```
+
+## Per-page SEO and CDN
+
+Each page entry is keyed by its camelCase `title` from the front matter:
+
+If you don't want to use a particular cdn inserting it in `base.njk` for all pages, you can add extra specific cdn (css, js) by inserting the link in each page of site.json separating them with a `,` and setting them in ""
+
+### site.json
+```json
+"pages": {
+    ...
+    "examplePage": {
+      "seo": {
+        "title": "Example Page",
+        "description": "description"
+      },
+      "cdn": {
+        "css": [],
+        "js": []
+      }
+    }
+    ...
+}
+```

package/docs/Javascript.md

@@ -0,0 +1,53 @@
+# To be finished...
+
+# JavaScript
+
+## Page files
+
+Each page has a JS entry point in `src/js/pages/`. It is bundled by esbuild and loaded automatically by `base.njk`. Import only what the page needs.
+
+## Module categories
+
+**Call inside `DOMContentLoaded`** — these interact with the DOM and require the page to be fully loaded:
+
+| Module | Function |
+|---|---|
+| `modules/langSwitcher.js` | `initLangSwitcher()` |
+| `modules/forms/form.js` | `initFormListener()` |
+| `modules/forms/textAreaAutoExpand.js` | `initTextAreaAutoExpand()` |
+| `modules/forms/normalizePhoneNumber.js` | `initNormalizePhoneNumber()` |
+
+**Call anywhere** — these create DOM elements dynamically and can be called at any point after the script loads:
+
+| Module | Function |
+|---|---|
+| `modules/notification.js` | `showNotification(text, type, duration)` |
+
+## Usage example
+
+```js
+import { initLangSwitcher } from '../modules/langSwitcher.js';
+import { showNotification } from '../modules/notification.js';
+
+document.addEventListener("DOMContentLoaded", () => {
+  initLangSwitcher();
+});
+
+showNotification("Page loaded", "success", 3000);
+```
+
+## `showNotification` reference
+
+| Parameter | Type | Default | Values |
+|---|---|---|---|
+| `text` | string | — | Any string |
+| `type` | string | `"info"` | `"success"`, `"info"`, `"error"` |
+| `duration` | number | `5000` | ms, or `-1` for persistent with spinner |
+
+## Adding a module
+
+Create a file in `src/js/modules/`, export your function, and import it in the pages that need it. Use ESM syntax (`import` / `export`) — this code is processed by esbuild.
+
+## `assistant_utils/`
+
+These scripts run directly in Node.js without a bundler. Use CommonJS syntax (`require` / `module.exports`) here, not ESM.

package/docs/Styling with SCSS.md

@@ -0,0 +1,114 @@
+# Styling with SCSS
+
+## Page CSS
+
+Each page has its own SCSS entry point in `src/frontend/scss/pages/`
+
+It must contain `_root.scss` + other modules like `_global.scss` or any other one that you need and its own specific css rules
+
+`_root.scss` uses `@use` to enable namespaced access (`root.$var`); other modules use `@import` as they don't expose variables.
+### examplePage.scss <small>(`src/frontend/scss/pages/`)</small>
+```scss
+//==========================
+// CSS MODULES IMPORTS
+//==========================
+
+@use "../modules/root" as root;
+
+@import "../modules/global";
+
+@import "../modules/notification";
+
+//==========================
+// PAGE CUSTOM CSS RULES
+//==========================
+
+body {
+  background-color: root.$primary;
+}
+```
+
+## CSS Framework
+
+Some of the most popular css frameworks that supports scss with modules are already installed in `node_modules`
+
+You can choose one or none of them (more than 1 works, but you may get in various conflicts)
+
+To enable/disable them you have to modify 3 files around the project by just commenting them
+
+
+### 1. _global.scss <small>(`src/frontend/scss/modules/`)</small>
+```scss
+@import "../modules/frameworks/bootstrap";
+// @import "../modules/frameworks/bulma";
+// @import "../modules/frameworks/foundation";
+// @import "../modules/frameworks/uikit";
+```
+
+### 2. base.njk <small>(`src/frontend/components/layouts/`)</small>
+
+```html
+{# Bootstrap JS #}
+<script src="/js/bootstrap.bundle.min.js" defer></script>
+
+{# Foundation JS #}
+{# <script src="/js/foundation.min.js" defer></script> #}
+
+{# UIkit JS #}
+{# <script src="/js/uikit.min.js" defer></script> #}
+{# <script src="/js/uikit-icons.min.js" defer></script> #}
+
+{# Bulma — no JS needed #}
+```
+
+### 3. `.eleventy.js`
+
+```javascript
+eleventyConfig.addPassthroughCopy({
+  // Bootstrap
+  "node_modules/bootstrap/dist/js/bootstrap.bundle.min.js": "js/bootstrap.bundle.min.js",
+  "node_modules/bootstrap-icons/font/fonts": "css/fonts",
+
+  // Foundation
+  // "node_modules/foundation-sites/dist/js/foundation.min.js": "js/foundation.min.js",
+
+  // UIkit
+  // "node_modules/uikit/dist/js/uikit.min.js": "js/uikit.min.js",
+  // "node_modules/uikit/dist/js/uikit-icons.min.js": "js/uikit-icons.min.js",
+
+  // Bulma — CSS only, no JS passthrough needed
+});
+```
+
+### Reducing bundle size
+To reduce the bundle size, open the corresponding framework file (`src/frontend/scss/modules/frameworks/`) and comment out any modules you don't need
+```scss
+@import "../../../../../node_modules/bootstrap/scss/card"; // Cards
+@import "../../../../../node_modules/bootstrap/scss/carousel"; // Carousel
+```
+
+## Global Variables
+
+Instead of using `:root` in your custom modules or pages, the best thing to do is to centralize all your variables in a single file (that will be tree-shaken automatically by Sass)
+
+### _root.scss <small>(`src/frontend/scss/modules/`)</small>
+```scss
+$header-height: 10vh;
+
+// Usage example (in any other file): 
+header {
+  height: root.$header-height;
+}
+```
+
+## Pre-existing modules
+
+| File | Purpose |
+|---|---|
+| `_root.scss` | Global variables (colors, spacing) |
+| `_global.scss` | Site-wide base rules and frameworks |
+| `_animations.scss` | Keyframe animations (`fade-in`, `spin`) |
+| `_header.scss` | Header styles |
+| `_footer.scss` | Footer styles |
+| `_notification.scss` | Notification component style |
+| `_mobile.scss` | Media query rules |

package/package.json

@@ -1,21 +1,8 @@
 {
   "name": "create-berna-stencil",
-  "version": "1.0.47",
+  "version": "1.0.48",
   "description": "Eleventy boilerplate with per-page SCSS/JS pipeline, esbuild bundling, multi-framework CSS support and a built-in page management CLI",
-  "keywords": [
-    "eleventy",
-    "11ty",
-    "boilerplate",
-    "starter",
-    "scss",
-    "esbuild",
-    "bootstrap",
-    "bulma",
-    "foundation",
-    "uikit",
-    "static-site",
-    "nunjucks"
-  ],
+  "keywords": [],
   "author": "Michele Garofalo",
   "license": "MIT",
   "repository": {
@@ -31,6 +18,7 @@
   },
   "files": [
     "bin/",
+    "docs/",
     "src/",
     "src/_routes",
     "src/assets/files",

package/src/backend/_core/vendor/composer/autoload_static.php

@@ -13,48 +13,48 @@ class ComposerStaticInit108be68e4e2b97fed51d36a10eed0849
     );
 
     public static $prefixLengthsPsr4 = array (
-        'S' => 
+        'S' =>
         array (
             'Symfony\\Polyfill\\Php80\\' => 23,
             'Symfony\\Polyfill\\Mbstring\\' => 26,
             'Symfony\\Polyfill\\Ctype\\' => 23,
         ),
-        'P' => 
+        'P' =>
         array (
             'PhpOption\\' => 10,
         ),
-        'G' => 
+        'G' =>
         array (
             'GrahamCampbell\\ResultType\\' => 26,
         ),
-        'D' => 
+        'D' =>
         array (
             'Dotenv\\' => 7,
         ),
     );
 
     public static $prefixDirsPsr4 = array (
-        'Symfony\\Polyfill\\Php80\\' => 
+        'Symfony\\Polyfill\\Php80\\' =>
         array (
             0 => __DIR__ . '/..' . '/symfony/polyfill-php80',
         ),
-        'Symfony\\Polyfill\\Mbstring\\' => 
+        'Symfony\\Polyfill\\Mbstring\\' =>
         array (
             0 => __DIR__ . '/..' . '/symfony/polyfill-mbstring',
         ),
-        'Symfony\\Polyfill\\Ctype\\' => 
+        'Symfony\\Polyfill\\Ctype\\' =>
         array (
             0 => __DIR__ . '/..' . '/symfony/polyfill-ctype',
         ),
-        'PhpOption\\' => 
+        'PhpOption\\' =>
         array (
             0 => __DIR__ . '/..' . '/phpoption/phpoption/src/PhpOption',
         ),
-        'GrahamCampbell\\ResultType\\' => 
+        'GrahamCampbell\\ResultType\\' =>
         array (
             0 => __DIR__ . '/..' . '/graham-campbell/result-type/src',
         ),
-        'Dotenv\\' => 
+        'Dotenv\\' =>
         array (
             0 => __DIR__ . '/..' . '/vlucas/phpdotenv/src',
         ),

package/src/backend/_core/vendor/composer/installed.json

@@ -24,7 +24,7 @@
             },
             "time": "2025-12-27T19:43:20+00:00",
             "type": "library",
-            "installation-source": "source",
+            "installation-source": "dist",
             "autoload": {
                 "psr-4": {
                     "GrahamCampbell\\ResultType\\": "src/"
@@ -98,7 +98,7 @@
                     "dev-master": "1.9-dev"
                 }
             },
-            "installation-source": "source",
+            "installation-source": "dist",
             "autoload": {
                 "psr-4": {
                     "PhpOption\\": "src/PhpOption/"
@@ -175,7 +175,7 @@
                     "name": "symfony/polyfill"
                 }
             },
-            "installation-source": "source",
+            "installation-source": "dist",
             "autoload": {
                 "files": [
                     "bootstrap.php"
@@ -262,7 +262,7 @@
                     "name": "symfony/polyfill"
                 }
             },
-            "installation-source": "source",
+            "installation-source": "dist",
             "autoload": {
                 "files": [
                     "bootstrap.php"
@@ -343,7 +343,7 @@
                     "name": "symfony/polyfill"
                 }
             },
-            "installation-source": "source",
+            "installation-source": "dist",
             "autoload": {
                 "files": [
                     "bootstrap.php"
@@ -447,7 +447,7 @@
                     "dev-master": "5.6-dev"
                 }
             },
-            "installation-source": "source",
+            "installation-source": "dist",
             "autoload": {
                 "psr-4": {
                     "Dotenv\\": "src/"

package/src/backend/_core/vendor/composer/installed.php

@@ -3,7 +3,7 @@
         'name' => '__root__',
         'pretty_version' => 'dev-main',
         'version' => 'dev-main',
-        'reference' => '4da27b8f50bb1a801f88ad46a9e9eafa51c1bb34',
+        'reference' => 'abd41735fb0323798fbaca8b317b15190d4c5da6',
         'type' => 'library',
         'install_path' => __DIR__ . '/../../',
         'aliases' => array(),
@@ -13,7 +13,7 @@
         '__root__' => array(
             'pretty_version' => 'dev-main',
             'version' => 'dev-main',
-            'reference' => '4da27b8f50bb1a801f88ad46a9e9eafa51c1bb34',
+            'reference' => 'abd41735fb0323798fbaca8b317b15190d4c5da6',
             'type' => 'library',
             'install_path' => __DIR__ . '/../../',
             'aliases' => array(),

package/src/backend/_core/vendor/graham-campbell/result-type/LICENSE

@@ -1,21 +1,21 @@
-The MIT License (MIT)
-
-Copyright (c) 2020-2024 Graham Campbell <hello@gjcampbell.co.uk>
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+The MIT License (MIT)
+
+Copyright (c) 2020-2024 Graham Campbell <hello@gjcampbell.co.uk>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/src/backend/_core/vendor/graham-campbell/result-type/composer.json

@@ -1,33 +1,33 @@
-{
-    "name": "graham-campbell/result-type",
-    "description": "An Implementation Of The Result Type",
-    "keywords": ["result", "result-type", "Result", "Result Type", "Result-Type", "Graham Campbell", "GrahamCampbell"],
-    "license": "MIT",
-    "authors": [
-        {
-            "name": "Graham Campbell",
-            "email": "hello@gjcampbell.co.uk",
-            "homepage": "https://github.com/GrahamCampbell"
-        }
-    ],
-    "require": {
-        "php": "^7.2.5 || ^8.0",
-        "phpoption/phpoption": "^1.9.5"
-    },
-    "require-dev": {
-        "phpunit/phpunit": "^8.5.41 || ^9.6.22 || ^10.5.45 || ^11.5.7"
-    },
-    "autoload": {
-        "psr-4": {
-            "GrahamCampbell\\ResultType\\": "src/"
-        }
-    },
-    "autoload-dev": {
-        "psr-4": {
-            "GrahamCampbell\\Tests\\ResultType\\": "tests/"
-        }
-    },
-    "config": {
-        "preferred-install": "dist"
-    }
-}
+{
+    "name": "graham-campbell/result-type",
+    "description": "An Implementation Of The Result Type",
+    "keywords": ["result", "result-type", "Result", "Result Type", "Result-Type", "Graham Campbell", "GrahamCampbell"],
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Graham Campbell",
+            "email": "hello@gjcampbell.co.uk",
+            "homepage": "https://github.com/GrahamCampbell"
+        }
+    ],
+    "require": {
+        "php": "^7.2.5 || ^8.0",
+        "phpoption/phpoption": "^1.9.5"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^8.5.41 || ^9.6.22 || ^10.5.45 || ^11.5.7"
+    },
+    "autoload": {
+        "psr-4": {
+            "GrahamCampbell\\ResultType\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "GrahamCampbell\\Tests\\ResultType\\": "tests/"
+        }
+    },
+    "config": {
+        "preferred-install": "dist"
+    }
+}