create-berna-stencil 2.5.0 → 2.6.1

package/bin/create.js

@@ -4,6 +4,19 @@ const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
 const { writeSync } = require('fs');
+const { spawnSync } = require('child_process');
+
+const color = {
+    reset:   '\x1b[0m',
+    bold:    '\x1b[1m',
+    dim:     '\x1b[2m',
+    red:     '\x1b[31m',
+    green:   '\x1b[32m',
+    yellow:  '\x1b[33m',
+    blue:    '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan:    '\x1b[36m',
+};
 
 // ── PATHS ────────────────────────────────────────────────────────────────────
 
@@ -121,7 +134,7 @@ src/backend/config.php
 
 const PROJECT_PACKAGE = {
     name:      path.basename(targetDir),
-    version:   '2.5.0',
+    version:   '2.6.1',
     private:   true,
     outputDir: 'out',
     "scripts": {
@@ -134,8 +147,7 @@ const PROJECT_PACKAGE = {
         "serve:11ty": "eleventy --serve --quiet",
         "clean": "node _tools/cleanOutput.js",
         "serve": "npm run clean && concurrently \"npm run serve:11ty\" \"npm run serve:css\" \"npm run serve:js\"",
-        "assistant": "node _tools/assistant.js",
-        "postinstall": "cd src/backend/_core && composer install --quiet"
+        "assistant": "node _tools/assistant.js"
     },
     dependencies: {
         '@11ty/eleventy':     '^3.1.2',
@@ -161,6 +173,10 @@ function log(msg) {
     writeSync(1, msg + '\n');
 }
 
+function logAdd(name) {
+    log(`${color.green}+${color.reset} ${name}`);
+}
+
 function escapeRegex(str) {
     return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
@@ -209,6 +225,48 @@ function njkUncomment(content, line) {
     return content.split(`{# ${line} #}`).join(line);
 }
 
+function installDependencies() {
+    const backendCore = path.join(targetDir, 'src', 'backend', '_core');
+
+    log(`${color.blue}\n>> Installing Node modules...${color.reset}`);
+    const npm = spawnSync('npm', ['install'], {
+        cwd: targetDir,
+        stdio: 'inherit',
+        shell: process.platform === 'win32',
+    });
+
+    if (npm.status !== 0) {
+        log('\n(!) npm install failed. Finish manually:');
+        if (process.argv[2]) log(`      cd ${process.argv[2]}`);
+        log('      npm install\n');
+        return false;
+    }
+
+    if (!fs.existsSync(path.join(backendCore, 'composer.json'))) {
+        return true;
+    }
+
+    const probe = spawnSync('composer', ['--version'], {
+        stdio: 'ignore',
+        shell: process.platform === 'win32',
+    });
+
+    if (probe.status !== 0) {
+        log('\n(!) Composer not found — skipping backend dependencies.');
+        log('    Install Composer, then run: cd src/backend/_core && composer install\n');
+        return true;
+    }
+
+    log(`\n${color.blue}>> Installing Composer modules...${color.reset}\n`);
+    spawnSync('composer', ['install'], {
+        cwd: backendCore,
+        stdio: 'inherit',
+        shell: process.platform === 'win32',
+    });
+
+    return true;
+}
+
 // ── APPLY ─────────────────────────────────────────────────────────────────────
 
 function applyFramework(framework) {
@@ -226,7 +284,7 @@ function applyFramework(framework) {
         fs.writeFileSync(globalScssPath, content);
     }
 
-    const baseNjkPath = path.join(targetDir, 'src/frontend/components/layouts/base.njk');
+    const baseNjkPath = path.join(targetDir, 'src/frontend/layouts/base.njk');
     if (fs.existsSync(baseNjkPath)) {
         let content = fs.readFileSync(baseNjkPath, 'utf8');
         ALL_FRAMEWORKS.forEach(fw => {
@@ -313,25 +371,27 @@ function askChoice(question, choices) {
 async function init() {
     if (!fs.existsSync(targetDir)) fs.mkdirSync(targetDir, { recursive: true });
 
-    log(`\n>> Creating berna-stencil project in ${targetDir}\n`);
+    log(`\n>> ${color.magenta}Creating berna-stencil project in ${targetDir}\n${color.reset}`);
 
     const language  = await askChoice('Select a language',      LANGUAGE_CHOICES);
     const framework = await askChoice('Select a CSS framework', FRAMEWORK_CHOICES);
 
+    log('');
+
     for (const target of MANDATORY_COPY) {
         const src  = path.join(templateDir, target);
         const dest = path.join(targetDir, target);
         if (!fs.existsSync(src)) continue;
         const exclude = target === 'src/frontend' ? FRONTEND_EXCLUDE[language] : [];
         copyRecursive(src, dest, exclude);
-        log(`+ ${target}`);
+        logAdd(target);
     }
 
     const configDest    = path.join(targetDir, 'src/backend/config.php');
     const configExample = path.join(targetDir, 'src/backend/config.example.php');
     if (!fs.existsSync(configDest) && fs.existsSync(configExample)) {
         fs.copyFileSync(configExample, configDest);
-        log('+ src/backend/config.php');
+        logAdd('src/backend/config.php');
     }
     deleteFileRecursive(targetDir, 'config.example.php');
 
@@ -341,15 +401,15 @@ async function init() {
         const tsSrc  = path.join(templateDir, 'tsconfig.json');
         const tsDest = path.join(targetDir, 'tsconfig.json');
         fs.copyFileSync(tsSrc, tsDest);
-        log('+ tsconfig.json');
+        logAdd('tsconfig.json');
         pkg.devDependencies = { ...pkg.devDependencies, typescript: 'latest' };
     }
 
     fs.writeFileSync(path.join(targetDir, 'package.json'), JSON.stringify(pkg, null, 2));
-    log('+ package.json');
+    logAdd('package.json');
 
     fs.writeFileSync(path.join(targetDir, '.gitignore'), GITIGNORE_CONTENT);
-    log('+ .gitignore');
+    logAdd('.gitignore');
 
     for (const dir of CREATE_DIRS) {
         fs.mkdirSync(path.join(targetDir, dir), { recursive: true });
@@ -358,10 +418,12 @@ async function init() {
     applyFramework(framework);
     applyLanguage(language);
 
-    log(`\n>> Done! Now run:\n`);
-    if (process.argv[2]) log(`cd ${process.argv[2]}`);
-    log('npm install');
-    log('npm run serve\n');
+    installDependencies();
+
+    log(`\n${color.green}>> Done!${color.reset}`);
+    log(`${color.yellow}\nNow run:\n${color.reset}`);
+    if (process.argv[2]) log(`  ${color.yellow}cd ${process.argv[2]}${color.reset}`);
+    log(`  ${color.yellow}npm run serve${color.reset}\n`);
 }
 
 init();

package/docs/Assistant CLI.md

@@ -31,7 +31,7 @@ For a page named `my-page`, the following files are created:
 | `src/frontend/js/pages/myPage.js` | JS entry point |
 | `src/frontend/_routes/my-page.njk` | Nunjucks template |
 
-It also adds an `elif` block in `includes.njk` and a stub entry in `site.json`:
+It also adds an `elif` block in `pageComponents.njk` and a stub entry in `site.json`:
 
 ```json
 "myPage": {
@@ -48,11 +48,11 @@ It also adds an `elif` block in `includes.njk` and a stub entry in `site.json`:
 
 ## Remove page
 
-Deletes all source files for the page and cleans up the output directory, `includes.njk`, and `site.json`.
+Deletes all source files for the page and cleans up the output directory, `pageComponents.njk`, and `site.json`.
 
 ## Rename page
 
-Renames all three source files, updates the `elif` block in `includes.njk`, and renames the record in `site.json` while preserving all existing fields.
+Renames all three source files, updates the `elif` block in `pageComponents.njk`, and renames the record in `site.json` while preserving all existing fields.
 
 ## Configure output path
 

package/docs/Components.md

@@ -19,9 +19,9 @@ src/frontend/components/
 
 ## Include a component
 
-To render a component inside a page, navigate to `src/frontend/components/layouts/` and edit `includes.njk`
+To render a component inside a page, navigate to `src/frontend/layouts/` and edit `pageComponents.njk`
 
-### includes.njk <small>(`src/frontend/components/layouts/`)</small>
+### pageComponents.njk <small>(`src/frontend/layouts/`)</small>
 
 ```js
 {% if title == "homepage" %}
@@ -41,7 +41,7 @@ Add a new `{% elif %}` block for each page, listing its components in order. If
 
 > ⚠️ A new `elif` block is automatically added when you create a page via the Assistant CLI
 
-> ⚠️ If you move or delete a component, always update `includes.njk` or the site will break
+> ⚠️ If you move or delete a component, always update `pageComponents.njk` or the site will break
 
 ### Using Markdown files in components
 
@@ -75,7 +75,7 @@ Header and footer live in `src/frontend/components/global/` and are automaticall
 
 ## Site data in components
 
-All values defined in `src/data/site.json` are globally available in every component via `{{ site.* }}`
+All values defined in `src/frontend/data/site.json` are globally available in every component via `{{ site.* }}`
 
 ### site.json <small>(`src/data/`)</small>
 ```json

package/docs/Creating pages.md

@@ -9,14 +9,14 @@ For a page named `my-page`:
 
 | File | Purpose |
 |---|---|
-| `src/frontend/pages/my-page.njk` | Template with front matter |
+| `src/frontend/_routes_/my-page.njk` | Template with front matter |
 | `src/frontend/scss/pages/myPage.scss` | Imports framework + modules |
 | `src/frontend/js/pages/myPage.js` | Imports JS modules |
 
 ## Adding content
 
 1. Create a component in `src/frontend/components/` (e.g. `_myPage.njk`)
-2. Include it in `src/frontend/components/layouts/includes.njk` inside the generated `elif` block:
+2. Include it in `src/frontend/layouts/pageComponents.njk` inside the generated `elif` block:
 
 ```njk
 {% elif title == "myPage" %}
@@ -37,7 +37,7 @@ To create a URL like `domain.it/about/team`, edit the `permalink` in `src/fronte
 ---
 title: "team"
 permalink: "about/team/"
-layout: includes.njk
+layout: pageComponents.njk
 ---
 ```
 

package/docs/Styling with SCSS.md

@@ -97,7 +97,7 @@ To enable/disable them you have to modify 3 files around the project by just com
 // @import "../modules/frameworks/uikit";
 ```
 
-### 2. base.njk <small>(`src/frontend/components/layouts/`)</small>
+### 2. base.njk <small>(`src/frontend/layouts/`)</small>
 
 ```html
 {# Bootstrap JS #}

package/package.json

@@ -1,66 +1,51 @@
-{
-  "name": "create-berna-stencil",
-  "version": "2.5.0",
-  "description": "Eleventy boilerplate with per-page SCSS/JS pipeline, esbuild bundling, multi-framework CSS support and a built-in page management CLI",
-  "keywords": [],
-  "author": "Michele Garofalo",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/rhaastrake/berna-stencil"
-  },
-  "homepage": "https://github.com/rhaastrake/berna-stencil#readme",
-  "bugs": {
-    "url": "https://github.com/rhaastrake/berna-stencil/issues"
-  },
-  "bin": {
-    "create-berna-stencil": "bin/create.js"
-  },
-  "files": [
-    "bin/",
-    "docs/",
-    "src/",
-    "_tools/",
-    ".eleventy.js",
-    ".eleventyignore",
-    "nginx.conf",
-    ".gitignore",
-    "tsconfig.json",
-    "LICENSE",
-    "NOTICE"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@11ty/eleventy": "^3.1.2",
-    "@11ty/eleventy-img": "^6.0.4",
-    "bootstrap": "^5.3.8",
-    "bootstrap-icons": "^1.13.1",
-    "bulma": "^1.0.4",
-    "foundation-sites": "^6.9.0",
-    "github-markdown-css": "^5.9.0",
-    "glob": "^13.0.6",
-    "markdown-it": "^14.2.0",
-    "uikit": "^3.25.13"
-  },
-  "devDependencies": {
-    "concurrently": "^9.2.1",
-    "esbuild": "^0.27.3",
-    "sass": "^1.77.0"
-  },
-  "scripts": {
-    "build:css": "sass src/frontend/scss:out/css --no-source-map --style=compressed --quiet",
-    "build:js": "esbuild \"src/frontend/ts/pages/*.ts\" --bundle --outdir=out/js/pages --minify",
-    "build:11ty": "eleventy",
-    "build": "npm run clean && npm run build:css && npm run build:js && npm run build:11ty",
-    "serve:css": "sass --watch src/frontend/scss:out/css --no-source-map --quiet",
-    "serve:js": "esbuild \"src/frontend/ts/pages/*.ts\" --bundle --outdir=out/js/pages --watch",
-    "serve:11ty": "eleventy --serve --quiet",
-    "clean": "node _tools/cleanOutput.js",
-    "serve": "npm run clean && concurrently \"npm run serve:11ty\" \"npm run serve:css\" \"npm run serve:js\"",
-    "assistant": "node _tools/assistant.js",
-    "postinstall": "cd src/backend/_core && composer install --quiet"
-  },
-  "outputDir": "out"
+{
+  "name": "create-berna-stencil",
+  "version": "2.6.1",
+  "description": "Eleventy boilerplate with per-page SCSS/JS pipeline, esbuild bundling, multi-framework CSS support and a built-in page management CLI",
+  "author": "Michele Garofalo",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rhaastrake/berna-stencil"
+  },
+  "homepage": "https://github.com/rhaastrake/berna-stencil#readme",
+  "bugs": {
+    "url": "https://github.com/rhaastrake/berna-stencil/issues"
+  },
+  "bin": {
+    "create-berna-stencil": "bin/create.js"
+  },
+  "files": [
+    "bin/",
+    "docs/",
+    "src/",
+    "_tools/",
+    ".eleventy.js",
+    ".eleventyignore",
+    "nginx.conf",
+    ".gitignore",
+    "tsconfig.json",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@11ty/eleventy": "^3.1.2",
+    "@11ty/eleventy-img": "^6.0.4",
+    "bootstrap": "^5.3.8",
+    "bootstrap-icons": "^1.13.1",
+    "bulma": "^1.0.4",
+    "foundation-sites": "^6.9.0",
+    "github-markdown-css": "^5.9.0",
+    "glob": "^13.0.6",
+    "markdown-it": "^14.2.0",
+    "uikit": "^3.25.13"
+  },
+  "devDependencies": {
+    "concurrently": "^9.2.1",
+    "esbuild": "^0.27.3",
+    "sass": "^1.77.0"
+  }
 }

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": "dist",
+            "installation-source": "source",
             "autoload": {
                 "psr-4": {
                     "GrahamCampbell\\ResultType\\": "src/"
@@ -98,7 +98,7 @@
                     "dev-master": "1.9-dev"
                 }
             },
-            "installation-source": "dist",
+            "installation-source": "source",
             "autoload": {
                 "psr-4": {
                     "PhpOption\\": "src/PhpOption/"
@@ -175,7 +175,7 @@
                     "name": "symfony/polyfill"
                 }
             },
-            "installation-source": "dist",
+            "installation-source": "source",
             "autoload": {
                 "files": [
                     "bootstrap.php"
@@ -262,7 +262,7 @@
                     "name": "symfony/polyfill"
                 }
             },
-            "installation-source": "dist",
+            "installation-source": "source",
             "autoload": {
                 "files": [
                     "bootstrap.php"
@@ -343,7 +343,7 @@
                     "name": "symfony/polyfill"
                 }
             },
-            "installation-source": "dist",
+            "installation-source": "source",
             "autoload": {
                 "files": [
                     "bootstrap.php"
@@ -447,7 +447,7 @@
                     "dev-master": "5.6-dev"
                 }
             },
-            "installation-source": "dist",
+            "installation-source": "source",
             "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' => '9bbb36794fc27d6938523db2d4076661ad9ddab9',
+        'reference' => '4719f94db95d3c803abf3cf434a4e47e38526a14',
         'type' => 'library',
         'install_path' => __DIR__ . '/../../',
         'aliases' => array(),
@@ -13,7 +13,7 @@
         '__root__' => array(
             'pretty_version' => 'dev-main',
             'version' => 'dev-main',
-            'reference' => '9bbb36794fc27d6938523db2d4076661ad9ddab9',
+            'reference' => '4719f94db95d3c803abf3cf434a4e47e38526a14',
             'type' => 'library',
             'install_path' => __DIR__ . '/../../',
             'aliases' => array(),

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

@@ -0,0 +1,9 @@
+* text=auto
+
+/tests export-ignore
+/.gitattributes export-ignore
+/.github export-ignore
+/.gitignore export-ignore
+/phpunit.xml.dist export-ignore
+/CHANGELOG.md export-ignore
+/README.md export-ignore

package/src/backend/_core/vendor/graham-campbell/result-type/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# CONTRIBUTOR COVENANT CODE OF CONDUCT
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+hello@gjcampbell.co.uk.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available
+at [https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations