nibula 1.6.1 → 1.6.2

package/.eleventy.js

@@ -33,6 +33,7 @@ module.exports = function (eleventyConfig) {
   eleventyConfig.addPassthroughCopy("src/frontend/robots.txt");
 
   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",
 

package/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to Nibula are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.6.2] - 2026-08-07
+
+### Added
+- `nib --version` (also `-v`, `v`, `version`) prints the version number on its own line. Inside a project it reports the project's own copy, which is the one actually running the command.
+
+### Fixed
+[...le quattro voci di prima, invariate...]
+
+### Changed
+- `docs/Styling with SCSS.md` now matches the template: the Nunjucks snippets include the `url` filter and the config file is named `.eleventy.js`.
+
 ## [1.6.1] - 2026-08-06
 
 ### Fixed

package/bin/create.js

@@ -33,6 +33,11 @@ const BACKEND = Object.freeze({
     PHP:  'php',
 });
 
+const COMMENT_STYLE = Object.freeze({
+    SLASH: { open: '// ', close: '' },
+    NJK:   { open: '{# ', close: ' #}' },
+});
+
 // ── CHOICES ──────────────────────────────────────────────────────────────────
 
 const LANGUAGE_CHOICES = [
@@ -88,14 +93,16 @@ const BACKEND_SKIP_DIRS = new Set(['node_modules', 'cache', '.git']);
 
 const ALL_FRAMEWORKS = Object.values(FRAMEWORK).filter(f => f !== FRAMEWORK.NONE);
 
+const SCSS_FRAMEWORK_PREFIX = 'modules/frameworks/';
+
+// Markers are substrings matched against whole lines, never full lines, so the
+// surrounding syntax (Nunjucks url filter, passthrough copy mapping) can change
+// without breaking the scaffolder.
 const FRAMEWORKS = {
     [FRAMEWORK.BOOTSTRAP]: {
         scss:     'bootstrap',
-        njk:      ['<script src="/js/bootstrap.bundle.min.js" defer></script>'],
-        eleventy: [
-            '"node_modules/bootstrap/dist/js/bootstrap.bundle.min.js": "js/bootstrap.bundle.min.js",',
-            '"node_modules/bootstrap-icons/font/fonts": "css/fonts",',
-        ],
+        njk:      ['/js/bootstrap.bundle.min.js'],
+        eleventy: ['bootstrap/dist/js/bootstrap.bundle.min.js', 'bootstrap-icons/font/fonts'],
     },
     [FRAMEWORK.BULMA]: {
         scss:     'bulma',
@@ -104,19 +111,13 @@ const FRAMEWORKS = {
     },
     [FRAMEWORK.FOUNDATION]: {
         scss:     'foundation',
-        njk:      ['<script src="/js/foundation.min.js" defer></script>'],
-        eleventy: ['"node_modules/foundation-sites/dist/js/foundation.min.js": "js/foundation.min.js",'],
+        njk:      ['/js/foundation.min.js'],
+        eleventy: ['foundation-sites/dist/js/foundation.min.js'],
     },
     [FRAMEWORK.UIKIT]: {
         scss:     'uikit',
-        njk:      [
-            '<script src="/js/uikit.min.js" defer></script>',
-            '<script src="/js/uikit-icons.min.js" defer></script>',
-        ],
-        eleventy: [
-            '"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",',
-        ],
+        njk:      ['/js/uikit.min.js', '/js/uikit-icons.min.js'],
+        eleventy: ['uikit/dist/js/uikit.min.js', 'uikit/dist/js/uikit-icons.min.js'],
     },
     [FRAMEWORK.NONE]: {
         scss:     null,
@@ -189,10 +190,6 @@ function logAdd(name) {
     log(`${color.green}+${color.reset} ${name}`);
 }
 
-function escapeRegex(str) {
-    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
 function copyRecursive(src, dest, exclude = []) {
     const stat = fs.statSync(src);
     if (stat.isDirectory()) {
@@ -250,22 +247,60 @@ function copyBackend(src, dest, backend) {
     }
 }
 
-function slashComment(content, line) {
-    content = content.replace(new RegExp(`^([ \\t]*)// (${escapeRegex(line)})$`, 'gm'), '$1$2');
-    return content.replace(new RegExp(`^([ \\t]*)(${escapeRegex(line)})$`, 'gm'), '$1// $2');
+function splitLine(line) {
+    const body = line.trim();
+    if (!body) return { indent: line, body: '', trailing: '' };
+
+    const start = line.indexOf(body);
+    return {
+        indent:   line.slice(0, start),
+        body,
+        trailing: line.slice(start + body.length),
+    };
+}
+
+function uncommentLine(line, style) {
+    const { indent, body, trailing } = splitLine(line);
+    if (!body.startsWith(style.open)) return line;
+
+    let inner = body.slice(style.open.length);
+    if (style.close) {
+        if (!inner.endsWith(style.close)) return line;
+        inner = inner.slice(0, -style.close.length);
+    }
+
+    return indent + inner + trailing;
+}
+
+function commentLine(line, style) {
+    const bare = uncommentLine(line, style);
+    const { indent, body, trailing } = splitLine(bare);
+    if (!body) return line;
+
+    return indent + style.open + body + style.close + trailing;
+}
+
+function mapMarkedLines(content, marker, style, transform) {
+    return content
+        .split('\n')
+        .map(line => (line.includes(marker) ? transform(line, style) : line))
+        .join('\n');
+}
+
+function slashComment(content, marker) {
+    return mapMarkedLines(content, marker, COMMENT_STYLE.SLASH, commentLine);
 }
 
-function slashUncomment(content, line) {
-    return content.replace(new RegExp(`^([ \\t]*)// (${escapeRegex(line)})$`, 'gm'), '$1$2');
+function slashUncomment(content, marker) {
+    return mapMarkedLines(content, marker, COMMENT_STYLE.SLASH, uncommentLine);
 }
 
-function njkComment(content, line) {
-    content = content.split(`{# ${line} #}`).join(line);
-    return content.split(line).join(`{# ${line} #}`);
+function njkComment(content, marker) {
+    return mapMarkedLines(content, marker, COMMENT_STYLE.NJK, commentLine);
 }
 
-function njkUncomment(content, line) {
-    return content.split(`{# ${line} #}`).join(line);
+function njkUncomment(content, marker) {
+    return mapMarkedLines(content, marker, COMMENT_STYLE.NJK, uncommentLine);
 }
 
 function installDependencies(backend) {
@@ -323,14 +358,14 @@ function installDependencies(backend) {
 function applyFramework(framework) {
     const config = FRAMEWORKS[framework];
 
-    const globalScssPath = path.join(targetDir, 'src/frontend/scss/modules/_global.scss');
+    const globalScssPath = path.join(targetDir, 'src/frontend/scss/_global.scss');
     if (fs.existsSync(globalScssPath)) {
         let content = fs.readFileSync(globalScssPath, 'utf8');
         ALL_FRAMEWORKS.forEach(fw => {
-            content = slashComment(content, `@import "../modules/frameworks/${fw}";`);
+            content = slashComment(content, `${SCSS_FRAMEWORK_PREFIX}${fw}`);
         });
         if (config.scss) {
-            content = slashUncomment(content, `@import "../modules/frameworks/${config.scss}";`);
+            content = slashUncomment(content, `${SCSS_FRAMEWORK_PREFIX}${config.scss}`);
         }
         fs.writeFileSync(globalScssPath, content);
     }
@@ -339,9 +374,9 @@ function applyFramework(framework) {
     if (fs.existsSync(baseNjkPath)) {
         let content = fs.readFileSync(baseNjkPath, 'utf8');
         ALL_FRAMEWORKS.forEach(fw => {
-            FRAMEWORKS[fw].njk.forEach(line => { content = njkComment(content, line); });
+            FRAMEWORKS[fw].njk.forEach(marker => { content = njkComment(content, marker); });
         });
-        config.njk.forEach(line => { content = njkUncomment(content, line); });
+        config.njk.forEach(marker => { content = njkUncomment(content, marker); });
         fs.writeFileSync(baseNjkPath, content);
     }
 
@@ -349,9 +384,9 @@ function applyFramework(framework) {
     if (fs.existsSync(eleventyPath)) {
         let content = fs.readFileSync(eleventyPath, 'utf8');
         ALL_FRAMEWORKS.forEach(fw => {
-            FRAMEWORKS[fw].eleventy.forEach(line => { content = slashComment(content, line); });
+            FRAMEWORKS[fw].eleventy.forEach(marker => { content = slashComment(content, marker); });
         });
-        config.eleventy.forEach(line => { content = slashUncomment(content, line); });
+        config.eleventy.forEach(marker => { content = slashUncomment(content, marker); });
         fs.writeFileSync(eleventyPath, content);
     }
 }

package/bin/delegate.js

@@ -10,6 +10,7 @@ const ENTRY_FILE = path.join('bin', 'nibula.js');
 const PACKAGE_FILE = 'package.json';
 const LOCAL_FLAG = 'NIBULA_LOCAL';
 const LOCAL_FLAG_VALUE = '1';
+const GLOBAL_VERSION_FLAG = 'NIBULA_GLOBAL_VERSION';
 
 const globalVersion = require(`../${PACKAGE_FILE}`).version;
 
@@ -49,7 +50,7 @@ function delegateToLocal(projectRoot) {
     const result = spawnSync(process.execPath, [localEntry, ...process.argv.slice(2)], {
         stdio: 'inherit',
         cwd: process.cwd(),
-        env: { ...process.env, [LOCAL_FLAG]: LOCAL_FLAG_VALUE },
+        env: { ...process.env, [LOCAL_FLAG]: LOCAL_FLAG_VALUE, [GLOBAL_VERSION_FLAG]: globalVersion },
     });
 
     process.exit(result.status ?? 0);

package/docs/Styling with SCSS.md

@@ -31,7 +31,7 @@ body {
 
 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>
+### _root.scss <small>(`src/frontend/scss/`)</small>
 ```scss
 $header-height: 10vh;
 
@@ -51,6 +51,8 @@ You can create subfolders if you want to refactor the structure, but be sure to
 ```scss
 @use '../../root' as root;
 
+@import '../../global';
+
 body {
   background-color: root.$primary;
 }
@@ -97,19 +99,19 @@ To enable/disable them you have to modify 3 files around the project by just com
 
 ```html
 {# Bootstrap JS #}
-<script src="/js/bootstrap.bundle.min.js" defer></script>
+<script src="{{ '/js/bootstrap.bundle.min.js' | url }}" defer></script>
 
 {# Foundation JS #}
-{# <script src="/js/foundation.min.js" defer></script> #}
+{# <script src="{{ '/js/foundation.min.js' | url }}" defer></script> #}
 
 {# UIkit JS #}
-{# <script src="/js/uikit.min.js" defer></script> #}
-{# <script src="/js/uikit-icons.min.js" defer></script> #}
+{# <script src="{{ '/js/uikit.min.js' | url }}" defer></script> #}
+{# <script src="{{ '/js/uikit-icons.min.js' | url }}" defer></script> #}
 
 {# Bulma — no JS needed #}
 ```
 
-### 3. eleventy.config.js
+### 3. eleventy.js
 
 ```javascript
 eleventyConfig.addPassthroughCopy({
@@ -128,7 +130,7 @@ eleventyConfig.addPassthroughCopy({
 });
 ```
 
-> ⚠️ Changes to `eleventy.config.js` are not picked up while the dev server is running — restart it.
+> ⚠️ Changes to `eleventy.js` are not picked up while the dev server is running — restart it.
 
 ### Reducing bundle size
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nibula",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "description": "A beginner-friendly static site generator built on Eleventy that stays close to vanilla HTML, CSS and JS — with a page-management CLI, an optional PHP backend, and SEO files generated for you.",
   "keywords": [
     "11ty",

package/src/frontend/layouts/base.njk

@@ -109,7 +109,6 @@
         ╚══════════════════╝#}
 
         {# Framework — uncomment the one you are using #}
-        
         {# Bootstrap JS #}
         <script src="{{ '/js/bootstrap.bundle.min.js' | url }}" defer></script>
 

package/tools/cli/ui.js

@@ -15,12 +15,14 @@ const BOX_VERTICAL = '\u2502';
 const NEW_LINE = '\n';
 const SPACE = ' ';
 
-const LOCAL_FLAG = 'NIBULA_LOCAL';
-const LOCAL_FLAG_VALUE = '1';
+const GLOBAL_VERSION_FLAG = 'NIBULA_GLOBAL_VERSION';
 const TITLE_PADDING = 2;
 
-const TITLE_SUFFIX = process.env[LOCAL_FLAG] === LOCAL_FLAG_VALUE
-    ? ` (local v${require('../../package.json').version})`
+const LOCAL_VERSION = require('../../package.json').version;
+const GLOBAL_VERSION = process.env[GLOBAL_VERSION_FLAG];
+
+const TITLE_SUFFIX = GLOBAL_VERSION && GLOBAL_VERSION !== LOCAL_VERSION
+    ? ` (local v${LOCAL_VERSION})`
     : '';
 
 const PLAIN_TITLE = `${BOX_TITLE}${TITLE_SUFFIX}`;
@@ -55,8 +57,6 @@ function centeredTitle() {
     const left = SPACE.repeat(Math.ceil(padding / 2));
     const right = SPACE.repeat(Math.floor(padding / 2));
 
-    if (!TITLE_SUFFIX) return `${left}${BOX_TITLE}${right}`;
-
     const suffix = `${color.dim}${TITLE_SUFFIX}${color.reset}${color[COLORS.box]}${color.bold}`;
     return `${left}${BOX_TITLE}${suffix}${right}`;
 }