create-berna-stencil 1.0.50 → 1.0.52

package/_tools/assistant.js

@@ -2,6 +2,8 @@ const readline = require('readline');
 const { addPage, removePage, renamePage } = require('./modules/updatePage');
 const { updateOutputPath, getCurrentOutputPath } = require('./modules/updateOutputPath');
 
+// --- Setup ---
+
 const readerInterface = readline.createInterface({
     input: process.stdin,
     output: process.stdout,
@@ -10,86 +12,96 @@ const readerInterface = readline.createInterface({
 
 const PROTECTED_PAGES = ['homepage', '404'];
 
+// --- Utility ---
+
+// Converts any string to kebab-case
 function toKebabCase(str) {
     return str.trim().toLowerCase()
         .replace(/[\s_]+/g, '-')
         .replace(/-+/g, '-');
 }
 
-function handleCreateRequest() {
-    readerInterface.question('\n> Enter the name of the new page: ', (inputName) => {
-        const kebabName = toKebabCase(inputName);
-        if (!kebabName) {
-            console.log('(!) Invalid name.');
-        } else if (/^\d/.test(kebabName)) {
-            console.log('(!) Invalid name. Page name cannot start with a number.');
-        } else if (PROTECTED_PAGES.includes(kebabName)) {
-            console.log(`(!) "${kebabName}" is a protected page and cannot be created.`);
-        } else {
-            addPage(kebabName, null);
-        }
-        displayMainMenu();
-    });
+// Returns an error message if the name is invalid, null otherwise
+function validatePageName(name) {
+    if (!name)                      return 'Invalid name.';
+    if (/^\d/.test(name))           return 'Page name cannot start with a number.';
+    if (PROTECTED_PAGES.includes(name)) return `"${name}" is a protected page name.`;
+    return null;
+}
+
+// Wraps readerInterface.question in a Promise for use with async/await
+function ask(prompt) {
+    return new Promise(resolve =>
+        readerInterface.question(prompt, answer => resolve(answer))
+    );
+}
+
+// Asks for a page name, converts it to kebab-case, validates it,
+// logs the error and returns null if invalid
+async function askPageName(prompt) {
+    const raw = await ask(prompt);
+    const name = toKebabCase(raw);
+    const error = validatePageName(name);
+    if (error) {
+        console.log(`(!) ${error}`);
+        return null;
+    }
+    return name;
+}
+
+// --- Handlers ---
+
+async function handleCreateRequest() {
+    const name = await askPageName('\n> Enter the name of the new page: ');
+    if (name) addPage(name, null);
 }
 
-function handleRenameRequest() {
-    readerInterface.question('\n> Enter the name of the page to rename: ', (inputOld) => {
-        const oldName = toKebabCase(inputOld);
-        if (!oldName) {
-            console.log('(!) Invalid name.');
-            return displayMainMenu();
-        }
-        if (PROTECTED_PAGES.includes(oldName)) {
-            console.log(`(!) "${oldName}" is a protected page and cannot be renamed.`);
-            return displayMainMenu();
-        }
-        readerInterface.question('> enter the new name: ', (inputNew) => {
-            const newName = toKebabCase(inputNew);
-            if (!newName) {
-                console.log('(!) invalid name.');
-            } else if (/^\d/.test(newName)) {
-                console.log('(!) Invalid name. Page name cannot start with a number.');
-            } else if (PROTECTED_PAGES.includes(newName)) {
-                console.log(`(!) "${newName}" is a protected page name.`);
-            } else if (oldName === newName) {
-                console.log('(!) Old and new name are the same.');
-            } else {
-                renamePage(oldName, newName);
-            }
-            displayMainMenu();
-        });
-    });
+async function handleRemoveRequest() {
+    const name = await askPageName('\n> Enter the name of the page to remove: ');
+    if (name) removePage(name);
 }
 
-function handleRemoveRequest() {
-    readerInterface.question('\n> Enter the name of the page to remove: ', (inputName) => {
-        const kebabName = toKebabCase(inputName);
-        if (!kebabName) {
-            console.log('(!) Invalid name.');
-        } else if (PROTECTED_PAGES.includes(kebabName)) {
-            console.log(`(!) "${kebabName}" Is a protected page and cannot be removed.`);
-        } else {
-            removePage(kebabName);
-        }
-        displayMainMenu();
-    });
+async function handleRenameRequest() {
+    const oldName = await askPageName('\n> Enter the name of the page to rename: ');
+    if (!oldName) return;
+
+    const newName = await askPageName('> Enter the new name: ');
+    if (!newName) return;
+
+    // Extra check: old and new name must differ
+    if (oldName === newName) {
+        console.log('(!) Old and new name are the same.');
+        return;
+    }
+
+    renamePage(oldName, newName);
 }
 
-function handleOutputPathRequest() {
+async function handleOutputPathRequest() {
     const current = getCurrentOutputPath();
-    const currentLabel = current ? ` Current path: "${current}"` : '';
-
-    readerInterface.question(`${currentLabel}\n Enter the new output path: `, (inputPath) => {
-        if (!inputPath.trim()) {
-            console.log('(!) Invalid path.');
-        } else {
-            updateOutputPath(inputPath);
-        }
-        displayMainMenu();
-    });
+    const label = current ? ` Current path: "${current}"\n` : '';
+    const input = await ask(`${label} Enter the new output path: `);
+
+    if (!input.trim()) {
+        console.log('(!) Invalid path.');
+    } else {
+        updateOutputPath(input);
+    }
 }
 
-function displayMainMenu() {
+// --- Menu ---
+
+// Maps each menu choice to its handler function
+const MENU_ACTIONS = {
+    '1': handleCreateRequest,
+    '2': handleRemoveRequest,
+    '3': handleRenameRequest,
+    '4': handleOutputPathRequest,
+};
+
+// Displays the menu, waits for input, executes the chosen action,
+// then calls itself again to keep the CLI alive (async recursion, no stack buildup)
+async function displayMainMenu() {
     console.log('\n========================');
     console.log('  Berna-Stencil CLI      ');
     console.log('========================\n');
@@ -99,24 +111,23 @@ function displayMainMenu() {
     console.log('4. Configure output path');
     console.log('\nCTRL/CMD + C to exit');
 
-    readerInterface.question('\nChoose an option: ', (choice) => {
-        const cleanChoice = choice.trim();
-        if (cleanChoice === '1') {
-            handleCreateRequest();
-        } else if (cleanChoice === '2') {
-            handleRemoveRequest();
-        } else if (cleanChoice === '3') {
-            handleRenameRequest();
-        } else if (cleanChoice === '4') {
-            handleOutputPathRequest();
-        } else if (cleanChoice === '0') {
-            readerInterface.close();
-            process.exit(0);
-        } else {
-            console.log('(!) Invalid option.');
-            displayMainMenu();
-        }
-    });
+    const choice = (await ask('\nChoose an option: ')).trim();
+
+    if (choice === '0') {
+        readerInterface.close();
+        process.exit(0);
+    }
+
+    const action = MENU_ACTIONS[choice];
+    if (action) {
+        await action();
+    } else {
+        console.log('(!) Invalid option.');
+    }
+
+    // Recurse to redisplay the menu after each action.
+    // Safe because each iteration fully resolves before the next one starts.
+    displayMainMenu();
 }
 
 displayMainMenu();

package/_tools/modules/updateData.js

@@ -1,16 +1,46 @@
 const fileSystem = require('fs');
+
 const SITE_DATA_PATH = 'src/frontend/data/site.json';
 
+// --- Utility ---
+
+// Converts a kebab-case string to camelCase
+// slice(1) removes the delimiter character reliably, avoiding the regex flag bug
+// of a double replace('-', '') without the /g flag
 function toCamelCase(str) {
     return str.toLowerCase().replace(/[-_][a-z0-9]/g, (group) =>
-        group.toUpperCase().replace('-', '').replace('_', '')
+        group.slice(1).toUpperCase()
     );
 }
 
+// Converts a kebab-case page name to a human-readable title
+// e.g. "about-us" → "About Us"
+function toNiceTitle(pageName) {
+    return pageName
+        .split('-')
+        .map(w => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+
+// Returns the parsed site.json content, or null if the file doesn't exist
+function readSiteData() {
+    if (!fileSystem.existsSync(SITE_DATA_PATH)) return null;
+    return JSON.parse(fileSystem.readFileSync(SITE_DATA_PATH, 'utf8'));
+}
+
+// Serializes and writes the data object back to site.json
+function writeSiteData(data) {
+    fileSystem.writeFileSync(SITE_DATA_PATH, JSON.stringify(data, null, 2));
+}
+
+// --- Public API ---
+
+// Adds a new page record to site.json
+// Skips silently if the file doesn't exist or the record is already present
 function addSiteData(pageName) {
-    if (!fileSystem.existsSync(SITE_DATA_PATH)) return;
+    const data = readSiteData();
+    if (!data) return;
 
-    const data = JSON.parse(fileSystem.readFileSync(SITE_DATA_PATH, 'utf8'));
     const camelName = toCamelCase(pageName);
 
     if (data.pages[camelName]) {
@@ -18,15 +48,11 @@ function addSiteData(pageName) {
         return;
     }
 
-    const niceTitle = pageName
-        .split('-')
-        .map(w => w.charAt(0).toUpperCase() + w.slice(1))
-        .join(' ');
-
+    // Build the default page record with SEO metadata and empty CDN arrays
     data.pages[camelName] = {
         seo: {
-            title: niceTitle,
-            description: "description",
+            title: toNiceTitle(pageName),
+            description: 'description',
         },
         cdn: {
             css: [],
@@ -34,14 +60,16 @@ function addSiteData(pageName) {
         }
     };
 
-    fileSystem.writeFileSync(SITE_DATA_PATH, JSON.stringify(data, null, 2));
+    writeSiteData(data);
     console.log(`[UPDATED] Record "${camelName}" added.`);
 }
 
+// Removes a page record from site.json
+// Skips silently if the file doesn't exist or the record is not found
 function removeSiteData(pageName) {
-    if (!fileSystem.existsSync(SITE_DATA_PATH)) return;
+    const data = readSiteData();
+    if (!data) return;
 
-    const data = JSON.parse(fileSystem.readFileSync(SITE_DATA_PATH, 'utf8'));
     const camelName = toCamelCase(pageName);
 
     if (!data.pages[camelName]) {
@@ -51,8 +79,44 @@ function removeSiteData(pageName) {
 
     delete data.pages[camelName];
 
-    fileSystem.writeFileSync(SITE_DATA_PATH, JSON.stringify(data, null, 2));
+    writeSiteData(data);
     console.log(`[CLEANED] Record "${camelName}" removed.`);
 }
 
-module.exports = { addSiteData, removeSiteData };
+// Renames a page record in site.json
+// Preserves all existing fields (cdn, etc.) and only updates the SEO title
+// Skips if the source record doesn't exist or the target name is already taken
+function renameSiteData(oldName, newName) {
+    const data = readSiteData();
+    if (!data) return;
+
+    const oldCamel = toCamelCase(oldName);
+    const newCamel = toCamelCase(newName);
+
+    if (!data.pages[oldCamel]) {
+        console.log(`[SKIP] Record "${oldCamel}" not found.`);
+        return;
+    }
+
+    if (data.pages[newCamel]) {
+        console.log(`[SKIP] Record "${newCamel}" already exists.`);
+        return;
+    }
+
+    // Spread the existing record to preserve cdn and any future fields,
+    // then override only the seo.title with the new page name
+    data.pages[newCamel] = {
+        ...data.pages[oldCamel],
+        seo: {
+            ...data.pages[oldCamel].seo,
+            title: toNiceTitle(newName),
+        }
+    };
+
+    delete data.pages[oldCamel];
+
+    writeSiteData(data);
+    console.log(`[UPDATED] Record "${oldCamel}" renamed to "${newCamel}".`);
+}
+
+module.exports = { addSiteData, removeSiteData, renameSiteData };

package/_tools/modules/updateIncludes.js

@@ -1,45 +1,78 @@
 const fileSystem = require('fs');
+const { toCamelCase } = require('./utils');
+
 const INCLUDES_PATH = 'src/frontend/components/layouts/includes.njk';
 
-function toCamelCase(str) {
-    return str.toLowerCase().replace(/[-_][a-z0-9]/g, (group) =>
-        group.toUpperCase().replace('-', '').replace('_', '')
+// --- Helpers ---
+
+// Returns the file content as a string, or null if the file doesn't exist
+function readIncludes() {
+    if (!fileSystem.existsSync(INCLUDES_PATH)) return null;
+    return fileSystem.readFileSync(INCLUDES_PATH, 'utf8');
+}
+
+// Writes updated content back to the includes file
+function writeIncludes(content) {
+    fileSystem.writeFileSync(INCLUDES_PATH, content);
+}
+
+// Builds the regex that matches the elif block for a given camelCase page name.
+// Defined once here to avoid duplication and the stateful /g flag bug:
+// using /g with .test() advances lastIndex, making a subsequent .replace() start
+// from the wrong position. A fresh non-/g regex avoids this entirely.
+function buildElifRegex(camelName) {
+    return new RegExp(
+        `[ \\t]*\\{%\\s*elif\\s+title\\s*==\\s*"${camelName}"\\s*%\\}[\\s\\S]*?(?=[ \\t]*\\{%\\s*(?:elif|else|endif))`,
     );
 }
 
+// --- Public API ---
+
+// Inserts a new elif block before {% else %} for the given page
 function addLayout(pageName) {
-    const camelName = toCamelCase(pageName);
-    if (!fileSystem.existsSync(INCLUDES_PATH)) return;
+    const content = readIncludes();
+    if (!content) return;
 
-    let content = fileSystem.readFileSync(INCLUDES_PATH, 'utf8');
+    const camelName = toCamelCase(pageName);
 
+    // Skip if the block already exists
     if (content.includes(`{% elif title == "${camelName}" %}`)) return;
 
-    const newElif = `{% elif title == "${camelName}" %}\n  {#{% include "component.njk" %}#}\n\n`;
-    const updatedContent = content.replace('{% else %}', `${newElif}{% else %}`);
+    const newElif =
+        `{% elif title == "${camelName}" %}\n` +
+        `  {# Insert your includes under this page #}\n` +
+        `  {#{% include "component.njk" %}#}\n\n`;
 
-    fileSystem.writeFileSync(INCLUDES_PATH, updatedContent);
+    writeIncludes(content.replace('{% else %}', `${newElif}{% else %}`));
     console.log(`[UPDATED] Layout block added for "${camelName}".`);
 }
 
+// Removes the elif block for the given page, then collapses extra blank lines
 function removeLayout(pageName) {
-    const camelName = toCamelCase(pageName);
-    if (!fileSystem.existsSync(INCLUDES_PATH)) return;
-
-    let content = fileSystem.readFileSync(INCLUDES_PATH, 'utf8');
+    const content = readIncludes();
+    if (!content) return;
 
-    const regex = new RegExp(`[ \\t]*\\{%\\s*elif\\s+title\\s*==\\s*"${camelName}"\\s*%\\}[\\s\\S]*?(?=[ \\t]*\\{%\\s*(?:elif|else|endif))`, 'g');
+    const camelName = toCamelCase(pageName);
+    const regex = buildElifRegex(camelName);
 
     if (!regex.test(content)) {
         console.log(`[DEBUG] Layout block for "${camelName}" not found. Skipped.`);
         return;
     }
 
-    let updatedContent = content.replace(regex, '');
-    updatedContent = updatedContent.replace(/\n\s*\n\s*\n/g, '\n\n');
+    // Build a fresh regex instance for replace to avoid stale lastIndex
+    const updated = content
+        .replace(buildElifRegex(camelName), '')
+        .replace(/\n\s*\n\s*\n/g, '\n\n');
 
-    fileSystem.writeFileSync(INCLUDES_PATH, updatedContent);
+    writeIncludes(updated);
     console.log(`[CLEANED] Layout block removed for "${camelName}".`);
 }
 
-module.exports = { addLayout, removeLayout };
+// Renames a layout block by removing the old one and inserting a new one
+function renameLayout(oldName, newName) {
+    removeLayout(oldName);
+    addLayout(newName);
+}
+
+module.exports = { addLayout, removeLayout, renameLayout };

package/_tools/modules/updateOutputPath.js

@@ -4,11 +4,25 @@ const path = require('path');
 const ELEVENTY_CONFIG = path.resolve(__dirname, '../../.eleventy.js');
 const PACKAGE_JSON = path.resolve(__dirname, '../../package.json');
 
+// Regex to locate the OUTPUT_DIR declaration in .eleventy.js.
+// Extracted as a constant to avoid writing it by hand in multiple places.
+const OUTPUT_DIR_REGEX = /const OUTPUT_DIR\s*=\s*['"`]([^'"`]*)['"`]/;
+
+// --- Helpers ---
+
+// Reads OUTPUT_DIR value from a given file content string, or returns null
+function parseOutputDir(content) {
+    const match = content.match(OUTPUT_DIR_REGEX);
+    return match ? match[1] : null;
+}
+
+// --- Updaters ---
+
 function updateEleventyConfig(newPath) {
-    let content = fs.readFileSync(ELEVENTY_CONFIG, 'utf-8');
+    const content = fs.readFileSync(ELEVENTY_CONFIG, 'utf-8');
 
     const updated = content.replace(
-        /const OUTPUT_DIR\s*=\s*['"`][^'"`]*['"`]/,
+        OUTPUT_DIR_REGEX,
         `const OUTPUT_DIR = "${newPath}"`
     );
 
@@ -23,34 +37,37 @@ function updateEleventyConfig(newPath) {
 }
 
 function updatePackageJson(newPath) {
-    const raw = fs.readFileSync(PACKAGE_JSON, 'utf-8');
-    const pkg = JSON.parse(raw);
+    const pkg = JSON.parse(fs.readFileSync(PACKAGE_JSON, 'utf-8'));
 
+    // Reconstruct all output-dependent scripts from scratch to avoid
+    // partial string replacement bugs on the outdir flag
     pkg.scripts['build:css'] = `sass src/frontend/scss:${newPath}/css --no-source-map --style=compressed --quiet`;
-    pkg.scripts['build:js'] = `esbuild "src/frontend/js/pages/*.js" --bundle --outdir=${newPath}/js/pages --minify`;
+    pkg.scripts['build:js']  = `esbuild "src/frontend/js/pages/*.js" --bundle --outdir=${newPath}/js/pages --minify`;
     pkg.scripts['serve:css'] = `sass --watch src/frontend/scss:${newPath}/css --no-source-map --quiet`;
-    pkg.scripts['serve:js'] = `esbuild "src/frontend/js/pages/*.js" --bundle --outdir=${newPath}/js/pages --watch`;
+    pkg.scripts['serve:js']  = `esbuild "src/frontend/js/pages/*.js" --bundle --outdir=${newPath}/js/pages --watch`;
 
     fs.writeFileSync(PACKAGE_JSON, JSON.stringify(pkg, null, 2), 'utf-8');
     console.log(`(✓) package.json updated → ${newPath}`);
     return true;
 }
 
+// --- Public API ---
+
 function updateOutputPath(newPath) {
     const trimmed = newPath.trim().replace(/\\/g, '/');
 
-    let normalizedPath;
-    if (trimmed === '.') {
-        normalizedPath = 'out';
-    } else {
-        const projectName = path.basename(process.cwd());
-        normalizedPath = trimmed.replace(/\/$/, '') + '/' + projectName + '-out';
-    }
+    // Normalize the path: bare "." becomes "out", everything else gets a
+    // project-scoped suffix to avoid collisions
+    const normalizedPath = trimmed === '.'
+        ? 'out'
+        : `${trimmed.replace(/\/$/, '')}/${path.basename(process.cwd())}-out`;
 
+    // Read the config once and reuse it to get the old path —
+    // avoids a second disk read inside updateEleventyConfig
     const eleventyContent = fs.readFileSync(ELEVENTY_CONFIG, 'utf-8');
-    const match = eleventyContent.match(/const OUTPUT_DIR\s*=\s*['"`]([^'"`]*)['"`]/);
-    const oldPath = match ? match[1] : null;
+    const oldPath = parseOutputDir(eleventyContent);
 
+    // Delete the old output folder if it exists
     if (oldPath) {
         const oldAbsPath = path.resolve(__dirname, '../../', oldPath);
         if (fs.existsSync(oldAbsPath)) {
@@ -67,19 +84,11 @@ function updateOutputPath(newPath) {
     updateEleventyConfig(normalizedPath);
 }
 
+// Returns the current OUTPUT_DIR value from .eleventy.js, or null on failure
 function getCurrentOutputPath() {
     try {
         const content = fs.readFileSync(ELEVENTY_CONFIG, 'utf-8');
-        const match = content.match(/const OUTPUT_DIR\s*=\s*['"`]([^'"`]*)['"`]/);
-        if (!match) return null;
-
-        const outputDir = match[1];
-
-        
-        const parent = path.dirname(outputDir);
-        const projectName = path.basename(outputDir);
-
-        return `${parent}/${projectName}`;
+        return parseOutputDir(content);
     } catch {
         return null;
     }

package/_tools/modules/updatePage.js

@@ -1,45 +1,49 @@
-const fileSystem = require("fs");
-const path = require("path");
+const fileSystem = require('fs');
+const path = require('path');
 
-const { addSiteData, removeSiteData } = require("./updateData");
-const { addLayout, removeLayout } = require("./updateIncludes");
+const { addSiteData, removeSiteData, renameSiteData } = require('./updateData');
+const { addLayout, removeLayout, renameLayout } = require('./updateIncludes');
+const { getCurrentOutputPath } = require('./updateOutputPath');
+const { toCamelCase } = require('./utils');
 
 const TEMPLATES_DIR = path.join(__dirname, '..', 'res', 'templates');
 
-function toCamelCase(str) {
-    return str.toLowerCase().replace(/[-_][a-z0-9]/g, (group) =>
-        group.toUpperCase().replace('-', '').replace('_', '')
-    );
+// --- Helpers ---
+
+// Returns the three file targets (scss, js, njk) for a given page name
+function getPageTargets(pageName) {
+    const camelName = toCamelCase(pageName);
+    return [
+        { folder: 'src/frontend/scss/pages', templateFile: 'template.scss', fileName: `${camelName}.scss` },
+        { folder: 'src/frontend/js/pages',   templateFile: 'template.js',   fileName: `${camelName}.js`   },
+        { folder: 'src/frontend/_routes',    templateFile: 'template.njk',  fileName: `${pageName}.njk`   },
+    ];
 }
 
+// --- Public API ---
+
 function addPage(pageName) {
     const camelName = toCamelCase(pageName);
 
-        const targets = [
-            { folder: "src/frontend/scss/pages", templateFile: "template.scss", fileName: `${camelName}.scss` },
-            { folder: "src/frontend/js/pages",   templateFile: "template.js",   fileName: `${camelName}.js`   },
-            { folder: "src/frontend/_routes",    templateFile: "template.njk",  fileName: `${pageName}.njk`   },
-        ];
-
-    targets.forEach(({ folder, templateFile, fileName }) => {
+    getPageTargets(pageName).forEach(({ folder, templateFile, fileName }) => {
         const destPath = path.join(folder, fileName);
         fileSystem.mkdirSync(folder, { recursive: true });
 
-        if (!fileSystem.existsSync(destPath)) {
-            const srcPath = path.join(TEMPLATES_DIR, templateFile);
+        if (fileSystem.existsSync(destPath)) return;
 
-            if (templateFile === "template.njk") {
-                let content = fileSystem.readFileSync(srcPath, 'utf8');
-                content = content
-                    .replace(/^title:.*$/m, `title: "${camelName}"`)
-                    .replace(/^permalink:.*$/m, `permalink: "/${pageName}/"`);
-                fileSystem.writeFileSync(destPath, content);
-            } else {
-                fileSystem.copyFileSync(srcPath, destPath);
-            }
+        const srcPath = path.join(TEMPLATES_DIR, templateFile);
 
-            console.log(`[created file] ${destPath}`);
+        if (templateFile === 'template.njk') {
+            // Patch the frontmatter placeholders with the actual page values
+            const content = fileSystem.readFileSync(srcPath, 'utf8')
+                .replace(/^title:.*$/m,     `title: "${camelName}"`)
+                .replace(/^permalink:.*$/m, `permalink: "/${pageName}/"`);
+            fileSystem.writeFileSync(destPath, content);
+        } else {
+            fileSystem.copyFileSync(srcPath, destPath);
         }
+
+        console.log(`[created file] ${destPath}`);
     });
 
     addLayout(pageName);
@@ -50,10 +54,11 @@ function renamePage(oldName, newName) {
     const oldCamel = toCamelCase(oldName);
     const newCamel = toCamelCase(newName);
 
+    // Use consistent src/frontend/ paths (matching addPage)
     const filesToRename = [
-        { src: `src/scss/pages/${oldCamel}.scss`, dest: `src/scss/pages/${newCamel}.scss` },
-        { src: `src/js/pages/${oldCamel}.js`,     dest: `src/js/pages/${newCamel}.js`     },
-        { src: `src/_routes/${oldName}.njk`,      dest: `src/_routes/${newName}.njk`      },
+        { src: `src/frontend/scss/pages/${oldCamel}.scss`, dest: `src/frontend/scss/pages/${newCamel}.scss` },
+        { src: `src/frontend/js/pages/${oldCamel}.js`,     dest: `src/frontend/js/pages/${newCamel}.js`     },
+        { src: `src/frontend/_routes/${oldName}.njk`,      dest: `src/frontend/_routes/${newName}.njk`      },
     ];
 
     filesToRename.forEach(({ src, dest }) => {
@@ -65,29 +70,30 @@ function renamePage(oldName, newName) {
         console.log(`[renamed] ${src} → ${dest}`);
     });
 
-    removeLayout(oldName);
-    addLayout(newName);
-    removeSiteData(oldName);
-    addSiteData(newName);
+    // Use atomic rename helpers instead of remove + add separately
+    renameLayout(oldName, newName);
+    renameSiteData(oldName, newName);
 }
 
 function removePage(pageName) {
     const camelName = toCamelCase(pageName);
-    const OUTPUT_DIR = "out";
+
+    // Read the actual current output dir instead of hardcoding "out"
+    const OUTPUT_DIR = getCurrentOutputPath() || 'out';
 
     const filesToDelete = [
         `src/frontend/scss/pages/${camelName}.scss`,
         `src/frontend/js/pages/${camelName}.js`,
         `src/frontend/_routes/${pageName}.njk`,
-        path.join(OUTPUT_DIR, "js/pages",  `${camelName}.js`),
-        path.join(OUTPUT_DIR, "css/pages", `${camelName}.css`),
+        path.join(OUTPUT_DIR, 'js/pages',  `${camelName}.js`),
+        path.join(OUTPUT_DIR, 'css/pages', `${camelName}.css`),
         path.join(OUTPUT_DIR, `${pageName}.html`),
-        path.join(OUTPUT_DIR, "pages", `${pageName}.html`),
+        path.join(OUTPUT_DIR, 'pages', `${pageName}.html`),
     ];
 
     const foldersToDelete = [
         path.join(OUTPUT_DIR, pageName),
-        path.join(OUTPUT_DIR, "pages", pageName),
+        path.join(OUTPUT_DIR, 'pages', pageName),
     ];
 
     filesToDelete.forEach(f => {

package/_tools/modules/utils.js

@@ -0,0 +1,12 @@
+// Shared utility functions used across modules
+
+// Converts a kebab-case or snake_case string to camelCase.
+// Uses slice(1) to remove the delimiter, avoiding the double-replace bug
+// that occurs when using .replace('-', '') without the /g flag.
+function toCamelCase(str) {
+    return str.toLowerCase().replace(/[-_][a-z0-9]/g, (group) =>
+        group.slice(1).toUpperCase()
+    );
+}
+
+module.exports = { toCamelCase };

package/bin/create.js

@@ -19,11 +19,11 @@ const PROJECT_PACKAGE = {
     version: '1.0.47',
     private: true,
     scripts: {
-        "build:css": "sass src/frontend/scss:out/css --no-source-map --style=compressed --quiet",
+        "build:css": "sass src/frontend/scss:out/css --no-source-map --style=compressed --quiet --load-path=node_modules",
         "build:js": "esbuild \"src/frontend/js/pages/*.js\" --bundle --outdir=out/js/pages --minify",
         "build:11ty": "eleventy",
         "build": "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:css": "sass --watch src/frontend/scss:out/css --no-source-map --quiet --load-path=node_modules",
         "serve:js": "esbuild \"src/frontend/js/pages/*.js\" --bundle --outdir=out/js/pages --watch",
         "serve:11ty": "eleventy --serve --quiet",
         "clean": "node _tools/cleanOutput.js",

package/docs/Assistant CLI.md

@@ -1,36 +1 @@
-# 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/Backend.md

@@ -0,0 +1 @@
+# ...

package/docs/Components.md

@@ -1,62 +1,83 @@
-# To be finished...
+# Nunjucks (HTML) Components
 
-# Components
+## What is Nunjucks
+
+Nunjucks (`.njk`) is an HTML file that supports logic like variables, `if` statements, and `for` loops. It can extend a base layout and include other `.njk` components
 
 ## Create a component
 
-Add a Nunjucks file in `src/components/`:
+Create a new `.njk` file anywhere inside `src/frontend/components/`. You can organize them into subfolders freely
 
 ```
-src/components/myComponent.njk
+src/frontend/components/
+├── global/
+├── layouts/
+├── modals/
+│   └── privacyModal.njk # You can move it to a modals/subfolder
+├── welcome.njk
 ```
 
-## Subfolders
+## Include a component
 
-Components can be organized into subfolders freely. Some examples:
+To render a component inside a page, navigate to `src/frontend/components/layouts/` and edit `includes.njk`
 
-```
-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
-```
+### includes.njk <small>(`src/frontend/components/layouts/`)</small>
+
+```js
+{% if title == "homepage" %}
+  {% include "welcome.njk" %}
 
-The include path must reflect the subfolder:
+{% elif title == "examplePage" %}
+  {% include "exampleComponent1.njk" %}
+  {% include "subfolder/exampleComponent2.njk" %}
 
-```njk
-{% include "pages/homepage.njk" %}
-{% include "modals/privacyModal.njk" %}
+{% else %}
+  {% include "404/_404.njk" %}
+  {{ content | safe }}
+{% endif %}
 ```
 
-## Register it for a page
+Add a new `{% elif %}` block for each page, listing its components in order. If a component lives in a subfolder, specify the relative path accordingly
 
-In `src/layouts/includes.njk`, find the `elif` block for your page and include the component:
+> ⚠️ A new `elif` block is automatically added when you create a page via the Assistant CLI
 
-```njk
-{% elif title == "myPage" %}
-  {% include "myComponent.njk" %}
-```
+> ⚠️ If you move or delete a component, always update `includes.njk` or the site will break
+
+## Nest components
 
-Multiple components can be included in the same block:
+A component can include other components. This is useful for breaking complex sections into smaller, reusable pieces.
 
-```njk
-{% elif title == "myPage" %}
-  {% include "hero.njk" %}
-  {% include "features.njk" %}
+### exampleComponent.njk
+```js
+<section class="hero">
+  {% include "ui/heroTitle.njk" %}
+  {% include "ui/heroButton.njk" %}
+</section>
 ```
 
+> The same path rules apply: if the included component is in a subfolder, specify the full relative path.
+
 ## 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.
+Header and footer live in `src/frontend/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.* }}`:
+All values defined in `src/data/site.json` are globally available in every component via `{{ site.* }}`
+
+### site.json <small>(`src/data/`)</small>
+```json
+{
+  "title": "My Site",
+  "logo": "/img/logo.png",
+  "legal": {
+    "privacy": "/privacy"
+  }
+}
+```
 
-```njk
+### Usage in any `.njk` file
+```js
 <p>{{ site.title }}</p>
 <a href="{{ site.legal.privacy }}">Privacy Policy</a>
 <img src="{{ site.logo }}" alt="{{ site.title }}">

package/docs/Head and SEO.md

@@ -1,9 +1,9 @@
 # Head & SEO
 
 
-`src/frontend/data/site.json` holds global settings used across all pages in `base.njk` and other components:
+This json holds global settings used across all pages in `base.njk` and other components:
 
-### site.json
+### site.json <small>`(src/frontend/data/)`</small>
 ```json
 "site_name": "Site name",
 "title": "Site title",
@@ -25,7 +25,7 @@ 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
+### site.json <small>`(src/frontend/data/)`</small>
 ```json
 "pages": {
     ...
@@ -35,10 +35,37 @@ If you don't want to use a particular cdn inserting it in `base.njk` for all pag
         "description": "description"
       },
       "cdn": {
-        "css": [],
-        "js": []
+        // You can leave the [] empty
+        "css": ["https://example1.com/lib.min.css", "https://example2.com/lib.min.css"],
+        "js": ["https://example1.com/lib.min.js", "https://example2.com/lib.min.js"]
       }
     }
     ...
 }
-```
+```
+
+## AI & SEO bots
+
+`llms.txt` and `robots.txt` are generated automatically from `site.json` via their respective `.njk` files — no manual editing needed.
+
+| File | Purpose | Reachable at |
+|---|---|---|
+| `llms.njk` | Tells AI models what your site is about | `yoursite.com/llms.txt` |
+| `robots.njk` | Controls search engine crawling | `yoursite.com/robots.txt` |
+
+To customize them, edit `src/llms.njk` or `src/robots.njk` directly.
+
+## Configuration field description
+
+| Field | Purpose |
+|---|---|
+| `site_name` | Brand name (used in meta tags) |
+| `title` | Default page title |
+| `description` | Default meta description |
+| `keywords` | Default meta keywords |
+| `domain` / `url` | Used for canonical URLs and og:url |
+| `lang` | HTML `lang` attribute |
+| `author` | Meta author tag |
+| `data_bs_theme` | Bootstrap color scheme (`light` / `dark`) |
+| `favicon` | Path to the favicon |
+| `logo` | Path to the logo (available as `{{ site.logo }}`) |

package/docs/Javascript.md

@@ -1,14 +1,30 @@
-# To be finished...
-
 # JavaScript
 
-## Page files
+## Page JS
+
+Each page has its own JS entry point in `src/frontend/js/pages/`
 
-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.
+It is bundled and minified by esbuild and loaded automatically by `base.njk`
 
-## Module categories
+Import only what the page needs.
 
-**Call inside `DOMContentLoaded`** — these interact with the DOM and require the page to be fully loaded:
+### examplePage.js <small>(`src/frontend/js/pages/`)</small>
+```js
+import { initLangSwitcher } from '../modules/langSwitcher.js';
+import { showNotification } from '../modules/notification.js';
+
+document.addEventListener("DOMContentLoaded", () => {
+  initLangSwitcher();
+});
+
+showNotification("Page loaded", "success", 3000);
+```
+
+## Modules
+
+Modules live in `src/frontend/js/modules/`. Some must be called inside `DOMContentLoaded` as they interact with the DOM; others create elements dynamically and can be called anywhere.
+
+### Call inside `DOMContentLoaded`
 
 | Module | Function |
 |---|---|
@@ -17,26 +33,13 @@ Each page has a JS entry point in `src/js/pages/`. It is bundled by esbuild and
 | `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:
+### Call anywhere
 
 | 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
+### `showNotification` parameters
 
 | Parameter | Type | Default | Values |
 |---|---|---|---|
@@ -46,8 +49,21 @@ showNotification("Page loaded", "success", 3000);
 
 ## 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.
+Create a new `.js` file in `src/frontend/js/modules/`. You can organize them into subfolders freely.
+
+Use ESM syntax — esbuild handles the bundling:
+
+```js
+// _yourModule.js
+export function yourFunction() {
+  // ...
+}
+```
+
+Then import it in the pages that need it:
 
-## `assistant_utils/`
+```js
+import { yourFunction } from '../modules/yourModule.js';
+```
 
-These scripts run directly in Node.js without a bundler. Use CommonJS syntax (`require` / `module.exports`) here, not ESM.
+> ⚠️ Files inside `_tools/` run directly in Node.js without a bundler — use CommonJS (`require` / `module.exports`) there, not ESM.

package/docs/Styling with SCSS.md

@@ -61,7 +61,7 @@ To enable/disable them you have to modify 3 files around the project by just com
 {# Bulma — no JS needed #}
 ```
 
-### 3. `.eleventy.js`
+### 3. .eleventy.js
 
 ```javascript
 eleventyConfig.addPassthroughCopy({
@@ -83,8 +83,8 @@ eleventyConfig.addPassthroughCopy({
 ### 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
+@import "bootstrap/scss/card"; // Cards
+@import "bootstrap/scss/carousel"; // Carousel
 ```
 
 ## Global Variables

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-berna-stencil",
-  "version": "1.0.50",
+  "version": "1.0.52",
   "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",
@@ -20,10 +20,6 @@
     "bin/",
     "docs/",
     "src/",
-    "src/_routes",
-    "src/assets/files",
-    "src/assets/videos",
-    "src/assets/images",
     "_tools/",
     ".eleventy.js",
     ".eleventyignore",
@@ -51,7 +47,7 @@
     "build:css": "sass src/frontend/scss:out/css --no-source-map --style=compressed --quiet",
     "build:js": "esbuild \"src/frontend/js/pages/*.js\" --bundle --outdir=out/js/pages --minify",
     "build:11ty": "eleventy",
-    "build": "npm run build:css && npm run build:js && npm run build:11ty",
+    "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/js/pages/*.js\" --bundle --outdir=out/js/pages --watch",
     "serve:11ty": "eleventy --serve --quiet",

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

@@ -8,6 +8,7 @@ layout: base.njk
   {% include "welcome.njk" %}
 
 {% else %}
+  <!-- You should not touch this else statement -->
   {% include "404/_404.njk" %}
   {{ content | safe }}
 {% endif %}

package/src/frontend/js/modules/forms/textAreaAutoExpand.js

@@ -14,14 +14,14 @@ export function initTextAreaAutoExpand() {
     element.addEventListener("input", () => expand(element));
     if (element.value) expand(element);
   }
-
+  
   function expand(element) {
     element.rows = element.dataset.minRows;
     while (element.scrollHeight > element.clientHeight && element.rows < MAX_ROWS) {
       element.rows += 1;
     }
   }
-
+  
   document.querySelectorAll("textarea").forEach(setup);
 
   const observer = new MutationObserver((mutations) => {

package/src/frontend/llms.njk

@@ -0,0 +1,18 @@
+---
+permalink: /llms.txt
+eleventyExcludeFromCollections: true
+---
+# {{ site.site_name }}
+
+> {{ site.description }}
+
+Built by {{ site.author }} — {{ site.url }}
+
+## Pages
+
+- {{ site.url }}: Homepage
+
+## Notes
+
+- Language: {{ site.lang }}
+- All content may be used for AI indexing unless otherwise stated

package/src/frontend/robots.njk

@@ -0,0 +1,8 @@
+---
+permalink: /robots.txt
+eleventyExcludeFromCollections: true
+---
+Sitemap: {{ site.url }}/sitemap.xml
+
+User-agent: *
+Disallow:

package/src/frontend/scss/modules/frameworks/_bootstrap.scss

@@ -1,18 +1,18 @@
 // ╔══════════════════════════════════════════════════════╗
-// ║                   BOOTSTRAP MODULES                  ║
+// ║                   ../../../../../node_modules/BOOTSTRAP MODULES                  ║
 // ║  Comment out any module you don't need to improve    ║
 // ║  performance. Core section is required by all others ║
 // ╚══════════════════════════════════════════════════════╝
 
 // Imports can be filtered by commenting them
 // Example:
-// @import "../../../../../node_modules/bootstrap/scss/example-bootstrap-module";
+// @import "../../../../../node_modules/bootstrap/scss/example-../../../../../node_modules/bootstrap-module";
 
 //==========================
 // 1️⃣ CORE – Functions and variables
 // ⚠️ Do not comment these out — required by all other modules
 //==========================
-@import "../../../../../node_modules/bootstrap/scss/functions";        // Bootstrap SCSS functions
+@import "../../../../../node_modules/bootstrap/scss/functions";        // ../../../../../node_modules/Bootstrap SCSS functions
 @import "../../../../../node_modules/bootstrap/scss/variables";        // Core variables (colors, spacing, fonts)
 @import "../../../../../node_modules/bootstrap/scss/variables-dark";   // Dark theme variables
 @import "../../../../../node_modules/bootstrap/scss/maps";             // Maps for spacing, colors, breakpoints
@@ -77,7 +77,7 @@
 @import "../../../../../node_modules/bootstrap/scss/forms/validation";         // Validation states
 
 //==========================
-// 8️⃣ COMPONENTS – All Bootstrap components
+// 8️⃣ COMPONENTS – All ../../../../../node_modules/Bootstrap components
 //==========================
 @import "../../../../../node_modules/bootstrap/scss/alert";            // Alerts
 @import "../../../../../node_modules/bootstrap/scss/badge";            // Badges

package/src/frontend/scss/modules/frameworks/_bulma.scss

@@ -1,12 +1,12 @@
 // ╔══════════════════════════════════════════════════════╗
-// ║                     BULMA MODULES                    ║
+// ║                     ../../../../../node_modules/BULMA MODULES                    ║
 // ║  Comment out any module you don't need to improve    ║
 // ║  performance. Core section is required by all others ║
 // ╚══════════════════════════════════════════════════════╝
 
 // Imports can be filtered by commenting them
 // Example:
-// @import "../../../../../node_modules/bulma/sass/example-bulma-module";
+// @import "../../../../../node_modules/bulma/sass/example-../../../../../node_modules/bulma-module";
 
 //==========================
 // 1️⃣ CORE – Utilities and variables

package/src/frontend/scss/modules/frameworks/_foundation.scss

@@ -1,12 +1,12 @@
 // ╔══════════════════════════════════════════════════════╗
-// ║                  FOUNDATION MODULES                  ║
+// ║                  ../../../../../node_modules/FOUNDATION MODULES                  ║
 // ║  Comment out any module you don't need to improve    ║
 // ║  performance. Core section is required by all others ║
 // ╚══════════════════════════════════════════════════════╝
 
 // Imports can be filtered by commenting them
 // Example:
-// @import "../../../../../node_modules/foundation-sites/scss/example-foundation-module";
+// @import "../../../../../node_modules/foundation-sites/scss/example-../../../../../node_modules/foundation-module";
 
 //==========================
 // 1️⃣ CORE – Utilities and functions

package/src/frontend/scss/modules/frameworks/_uikit.scss

@@ -1,5 +1,5 @@
 // ╔══════════════════════════════════════════════════════╗
-// ║                     UIKIT MODULES                    ║
+// ║                     ../../../../../node_modules/UIKIT MODULES                    ║
 // ║  Comment out any module you don't need to improve    ║
 // ║  performance. Core section is required by all others ║
 // ╚══════════════════════════════════════════════════════╝

package/src/frontend/robots.txt

@@ -1,4 +0,0 @@
-Sitemap: https://yoursite.com/sitemap.xml
-
-User-agent: *
-Disallow: