nibula 1.2.3 → 1.2.5

package/docs/Components.md

@@ -1,85 +1,85 @@
-# Nunjucks (HTML) 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
-
-Create a new `.njk` file anywhere inside `src/frontend/components/`. You can organize them into subfolders freely
-
-```
-src/frontend/components/
-├── global/
-├── layouts/
-├── modals/
-│   └── privacyModal.njk # You can move it to a modals/subfolder
-├── welcome.njk
-```
-
-## Include a component
-
-To render a component inside a page, navigate to `src/frontend/layouts/` and edit `page-components.njk`
-
-### page-components.njk <small>(`src/frontend/layouts/`)</small>
-
-```js
-{% if title == "homepage" %}
-{% include "welcome.njk" %}
-
-{% elif title == "examplePage" %}
-{% include "exampleComponent1.njk" %}
-{% include "subfolder/exampleComponent2.njk" %}
-
-{% else %}
-{% include "404/_404.njk" %}
-{{ content | safe }}
-{% endif %}
-```
-
-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
-
-> ⚠️ 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 `page-components.njk` or the site will break
-
-## Nest components
-
-A component can include other components. This is useful for breaking complex sections into smaller, reusable pieces.
-
-### 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/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 defined in `src/frontend/data/site.json` are globally available in every component via `{{ site.* }}`
-
-### site.json <small>(`src/frontend/data/`)</small>
-```json
-{
-  "title": "My Site",
-  "theme": "dark",
-  "logo": "/assets/brand/logo.svg",
-  "legal": {
-    "privacy": "/privacy"
-  }
-}
-```
-
-### 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 }}">
+# Nunjucks (HTML) 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
+
+Create a new `.njk` file anywhere inside `src/frontend/components/`. You can organize them into subfolders freely
+
+```
+src/frontend/components/
+├── global/
+├── layouts/
+├── modals/
+│   └── privacyModal.njk # You can move it to a modals/subfolder
+├── welcome.njk
+```
+
+## Include a component
+
+To render a component inside a page, navigate to `src/frontend/layouts/` and edit `page-components.njk`
+
+### page-components.njk <small>(`src/frontend/layouts/`)</small>
+
+```js
+{% if title == "homepage" %}
+{% include "welcome.njk" %}
+
+{% elif title == "examplePage" %}
+{% include "exampleComponent1.njk" %}
+{% include "subfolder/exampleComponent2.njk" %}
+
+{% else %}
+{% include "404/_404.njk" %}
+{{ content | safe }}
+{% endif %}
+```
+
+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
+
+> ⚠️ 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 `page-components.njk` or the site will break
+
+## Nest components
+
+A component can include other components. This is useful for breaking complex sections into smaller, reusable pieces.
+
+### 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/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 defined in `src/frontend/data/site.json` are globally available in every component via `{{ site.* }}`
+
+### site.json <small>(`src/frontend/data/`)</small>
+```json
+{
+  "title": "My Site",
+  "theme": "dark",
+  "logo": "/assets/brand/logo.svg",
+  "legal": {
+    "privacy": "/privacy"
+  }
+}
+```
+
+### 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/Creating pages.md

@@ -1,65 +1,65 @@
-# Creating Pages
-
-> Examples use JavaScript, but everything applies equally to TypeScript. The only difference is the file extension (`.ts` instead of `.js`), that imports do **not** include the extension, and that paths use `src/frontend/ts/` instead of `src/frontend/js/`.
-
-The recommended way is via the **Assistant CLI**
-
-## What gets created
-For a page named `my-page`:
-
-| File | Purpose |
-|---|---|
-| `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/layouts/page-components.njk` inside the generated `elif` block:
-
-```njk
-{% elif title == "myPage" %}
-  {% include "_myPage.njk" %}
-```
-
-See **Components** DOC file for more info
-
-## 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.
-
-## Subpages (nested URLs)
-
-To create a URL like `domain.it/about/team`, edit the `permalink` in `src/frontend/routes/team.njk` and add the parent segment before the final slash:
-
-```njk
----
-title: "team"
-permalink: "about/team/"
-layout: page-components.njk
----
-```
-
-The parent path (`about`) does **not** need to exist as a real page — it's just a URL prefix. Only the last segment (`team`) must match the filename and the `title` in the front matter.
-
-| Goal URL | permalink value | File |
-|---|---|---|
-| `/team/` | `/team/` | `routes/team.njk` |
-| `/about/team/` | `/about/team/` | `routes/team.njk` |
-| `/company/about/team/` | `/company/about/team/` | `routes/team.njk` |
-
-## SEO
-
-The CLI creates a stub entry in `src/frontend/data/site.json`. Fill it in:
-
-```json
-"myPage": {
-  "seo": {
-    "title": "My Page | Site Name",
-    "description": "Page description"
-  }
-}
-```
-
+# Creating Pages
+
+> Examples use JavaScript, but everything applies equally to TypeScript. The only difference is the file extension (`.ts` instead of `.js`), that imports do **not** include the extension, and that paths use `src/frontend/ts/` instead of `src/frontend/js/`.
+
+The recommended way is via the **Assistant CLI**
+
+## What gets created
+For a page named `my-page`:
+
+| File | Purpose |
+|---|---|
+| `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/layouts/page-components.njk` inside the generated `elif` block:
+
+```njk
+{% elif title == "myPage" %}
+  {% include "_myPage.njk" %}
+```
+
+See **Components** DOC file for more info
+
+## 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.
+
+## Subpages (nested URLs)
+
+To create a URL like `domain.it/about/team`, edit the `permalink` in `src/frontend/routes/team.njk` and add the parent segment before the final slash:
+
+```njk
+---
+title: "team"
+permalink: "about/team/"
+layout: page-components.njk
+---
+```
+
+The parent path (`about`) does **not** need to exist as a real page — it's just a URL prefix. Only the last segment (`team`) must match the filename and the `title` in the front matter.
+
+| Goal URL | permalink value | File |
+|---|---|---|
+| `/team/` | `/team/` | `routes/team.njk` |
+| `/about/team/` | `/about/team/` | `routes/team.njk` |
+| `/company/about/team/` | `/company/about/team/` | `routes/team.njk` |
+
+## SEO
+
+The CLI creates a stub entry in `src/frontend/data/site.json`. Fill it in:
+
+```json
+"myPage": {
+  "seo": {
+    "title": "My Page | Site Name",
+    "description": "Page description"
+  }
+}
+```
+
 See **Head & SEO** for all available options.