jekyll-theme-zer0 1.26.0 → 1.28.0

data/_includes/components/book-nav.html

@@ -0,0 +1,80 @@
+{% comment %} Feature: ZER0-080 {% endcomment %}
+{%- comment -%}
+  Component:   book-nav
+  Path:        _includes/components/book-nav.html
+  Purpose:     Previous/next story navigation within one book, with a
+               "Contents" link back to the book's landing page in the middle.
+  Params:      book (string, required)    — book slug matching chapters' `book:`
+               chapter (number, required) — the current chapter number
+  Depends on:  the `books` collection,
+               _sass/components/_post-navigation.scss (.post-nav-card reuse)
+  Notes:       Ordering comes from the numeric `chapter:` front matter, not
+               dates, so books read cover-to-cover. Reuses the article
+               post-nav-card styles for a consistent feel.
+{%- endcomment -%}
+{%- if include.book == nil or include.chapter == nil -%}
+  {%- comment -%} ERROR: book-nav requires `book` and `chapter` {%- endcomment -%}
+{%- else -%}
+{%- assign _chapters = site.books | where: "book", include.book | where_exp: "doc", "doc.chapter" | sort: "chapter" -%}
+{%- assign _book_page = site.books | where: "book", include.book | where: "layout", "book" | first -%}
+{%- assign _prev = nil -%}
+{%- assign _next = nil -%}
+{%- for _ch in _chapters -%}
+  {%- if _ch.chapter == include.chapter -%}
+    {%- unless forloop.first -%}
+      {%- assign _i = forloop.index0 | minus: 1 -%}
+      {%- assign _prev = _chapters[_i] -%}
+    {%- endunless -%}
+    {%- unless forloop.last -%}
+      {%- assign _i = forloop.index0 | plus: 1 -%}
+      {%- assign _next = _chapters[_i] -%}
+    {%- endunless -%}
+    {%- break -%}
+  {%- endif -%}
+{%- endfor -%}
+<nav class="book-story-nav my-5 pt-4 border-top" aria-label="Story navigation">
+  <div class="row g-3 align-items-stretch">
+    <div class="col-md-5">
+      {%- if _prev -%}
+      <a href="{{ _prev.url | relative_url }}" class="post-nav-card post-nav-card--prev">
+        <div class="post-nav-card__body">
+          <small class="post-nav-card__label"><i class="bi bi-chevron-left me-1" aria-hidden="true"></i>Previous story</small>
+          <span class="post-nav-card__title">{{ _prev.title | truncate: 50 }}</span>
+        </div>
+      </a>
+      {%- else -%}
+      <div class="post-nav-card post-nav-card--prev post-nav-card--disabled" aria-disabled="true">
+        <div class="post-nav-card__body">
+          <small class="post-nav-card__label"><i class="bi bi-chevron-left me-1" aria-hidden="true"></i>Previous story</small>
+          <span class="post-nav-card__title text-muted">This is the first story</span>
+        </div>
+      </div>
+      {%- endif -%}
+    </div>
+    <div class="col-md-2 d-flex">
+      {%- if _book_page -%}
+      <a href="{{ _book_page.url | relative_url }}" class="btn btn-outline-secondary w-100 align-self-center" aria-label="Back to {{ _book_page.title | escape }} contents">
+        <i class="bi bi-list-ul me-1" aria-hidden="true"></i>Contents
+      </a>
+      {%- endif -%}
+    </div>
+    <div class="col-md-5">
+      {%- if _next -%}
+      <a href="{{ _next.url | relative_url }}" class="post-nav-card post-nav-card--next">
+        <div class="post-nav-card__body">
+          <small class="post-nav-card__label">Next story<i class="bi bi-chevron-right ms-1" aria-hidden="true"></i></small>
+          <span class="post-nav-card__title">{{ _next.title | truncate: 50 }}</span>
+        </div>
+      </a>
+      {%- else -%}
+      <div class="post-nav-card post-nav-card--next post-nav-card--disabled" aria-disabled="true">
+        <div class="post-nav-card__body">
+          <small class="post-nav-card__label">Next story<i class="bi bi-chevron-right ms-1" aria-hidden="true"></i></small>
+          <span class="post-nav-card__title text-muted">The end — for now</span>
+        </div>
+      </div>
+      {%- endif -%}
+    </div>
+  </div>
+</nav>
+{%- endif -%}

data/_includes/components/book-plate.html

@@ -0,0 +1,31 @@
+{% comment %} Feature: ZER0-080 {% endcomment %}
+{%- comment -%}
+  Component:   book-plate
+  Path:        _includes/components/book-plate.html
+  Purpose:     Full-width illustration "plate" inside a book story — a figure
+               with rounded art, soft shadow, and an optional caption.
+  Params:      src (string, required)   — image path (site-relative or /assets/…)
+               alt (string, required)   — accessible description of the scene
+               caption (string, optional, default: none) — visible caption text
+               class (string, optional, default: "")     — extra figure classes
+               loading (string, optional, default: "lazy")
+  Depends on:  components/preview-image.html (path prefixing + relative_url),
+               _sass/components/_book.scss (.book-plate)
+  Notes:       Alt text stays on the <img>; the caption renders only when
+               explicitly passed so read-aloud story text isn't duplicated.
+{%- endcomment -%}
+{%- if include.src == nil -%}
+  {%- comment -%} ERROR: book-plate requires `src` {%- endcomment -%}
+{%- else -%}
+<figure class="book-plate {{ include.class | default: '' }}">
+  {%- include components/preview-image.html
+     src=include.src
+     alt=include.alt
+     class="book-plate-img"
+     loading=include.loading
+  -%}
+  {%- if include.caption -%}
+  <figcaption>{{ include.caption | escape }}</figcaption>
+  {%- endif -%}
+</figure>
+{%- endif -%}

data/_includes/components/book-toc.html

@@ -0,0 +1,47 @@
+{% comment %} Feature: ZER0-080 {% endcomment %}
+{%- comment -%}
+  Component:   book-toc
+  Path:        _includes/components/book-toc.html
+  Purpose:     Ordered table of contents for one book — chapter number bubble,
+               label (e.g. the month), title, and an optional thumbnail.
+  Params:      book (string, required)  — book slug matching chapters' `book:`
+               heading (string, optional, default: "Table of Contents")
+               heading_level (string, optional, default: "h2")
+  Depends on:  the `books` collection,
+               _sass/components/_book.scss (.book-toc)
+  Notes:       Chapters are docs with a numeric `chapter:`; sorted ascending.
+               Thumbnails come from each chapter's `preview` and are hidden on
+               the smallest screens to keep rows tappable.
+{%- endcomment -%}
+{%- if include.book == nil -%}
+  {%- comment -%} ERROR: book-toc requires `book` {%- endcomment -%}
+{%- else -%}
+{%- assign _chapters = site.books | where: "book", include.book | where_exp: "doc", "doc.chapter" | sort: "chapter" -%}
+{%- assign _hl = include.heading_level | default: "h2" -%}
+{%- if _chapters.size > 0 -%}
+<nav class="book-toc" aria-label="Table of contents">
+  <{{ _hl }} class="mb-3">{{ include.heading | default: "Table of Contents" }}</{{ _hl }}>
+  <ol class="list-unstyled d-flex flex-column gap-2 mb-0">
+    {%- for _ch in _chapters -%}
+    <li>
+      <a class="book-toc-item" href="{{ _ch.url | relative_url }}">
+        <span class="book-toc-number" aria-hidden="true">{{ _ch.chapter }}</span>
+        {%- if _ch.preview -%}
+        <img class="book-toc-thumb d-none d-sm-block" src="{{ _ch.preview | relative_url }}" alt="" loading="lazy" decoding="async">
+        {%- endif -%}
+        <span class="flex-grow-1">
+          {%- if _ch.chapter_label -%}
+          <span class="d-block small text-body-secondary">{{ _ch.chapter_label }}</span>
+          {%- endif -%}
+          <span class="fw-semibold">{{ _ch.title }}</span>
+        </span>
+        <i class="bi bi-chevron-right text-body-secondary" aria-hidden="true"></i>
+      </a>
+    </li>
+    {%- endfor -%}
+  </ol>
+</nav>
+{%- else -%}
+  {%- comment -%} book-toc: no chapters found for book "{{ include.book }}" — skipping render {%- endcomment -%}
+{%- endif -%}
+{%- endif -%}

data/_includes/components/bookshelf.html

@@ -0,0 +1,68 @@
+{% comment %} Feature: ZER0-080 · series grouping ZER0-081 {% endcomment %}
+{%- comment -%}
+  Component:   bookshelf
+  Path:        _includes/components/bookshelf.html
+  Purpose:     Responsive grid of every book in the `books` collection, grouped
+               into series/category shelves — drop it on a home or index page.
+  Params:      heading (string, optional) — overall section heading (h2)
+               class (string, optional, default: "")  — extra wrapper classes
+  Depends on:  components/book-card.html, the `books` collection,
+               _data/series.yml (per-series display metadata)
+  Notes:       A "book" is any books-collection doc whose layout is `book`
+               (story books) or `book-abc` (alphabet books); chapters are never
+               listed. Books group by `series:`; a book with no series falls
+               under the default `stories` shelf. Series render in the order
+               they appear in _data/series.yml, then any undeclared series.
+{%- endcomment -%}
+{%- assign _story_books = site.books | where: "layout", "book" -%}
+{%- assign _abc_books = site.books | where: "layout", "book-abc" -%}
+{%- assign _all = _story_books | concat: _abc_books -%}
+{%- if _all and _all.size > 0 -%}
+{%- assign _default_series = "stories" -%}
+{%- assign _groups = _all | group_by_exp: "doc", "doc.series | default: _default_series" -%}
+
+{%- comment -%} Build the shelf order: declared series (file order) first, then any others. {%- endcomment -%}
+{%- assign _order = "," -%}
+{%- for _pair in site.data.series -%}
+  {%- assign _needle = _pair[0] | prepend: "," | append: "," -%}
+  {%- unless _order contains _needle -%}
+    {%- for _g in _groups -%}{%- if _g.name == _pair[0] -%}{%- assign _order = _order | append: _pair[0] | append: "," -%}{%- endif -%}{%- endfor -%}
+  {%- endunless -%}
+{%- endfor -%}
+{%- for _g in _groups -%}
+  {%- assign _needle = _g.name | prepend: "," | append: "," -%}
+  {%- unless _order contains _needle -%}{%- assign _order = _order | append: _g.name | append: "," -%}{%- endunless -%}
+{%- endfor -%}
+{%- assign _order_list = _order | split: "," -%}
+
+<section class="bookshelf {{ include.class | default: '' }}">
+  {%- if include.heading -%}
+  <h2 class="mb-4">{{ include.heading }}</h2>
+  {%- endif -%}
+
+  {%- for _name in _order_list -%}
+    {%- if _name == "" -%}{%- continue -%}{%- endif -%}
+    {%- assign _group = _groups | where: "name", _name | first -%}
+    {%- if _group == nil -%}{%- continue -%}{%- endif -%}
+    {%- assign _meta = site.data.series[_name] -%}
+    {%- assign _books = _group.items | sort: "title" -%}
+    <div class="book-series mb-5" id="series-{{ _name }}">
+      <h3 class="h4 mb-1">
+        <i class="bi {{ _meta.icon | default: 'bi-book-half' }} me-2" aria-hidden="true"></i>{{ _meta.title | default: _name | escape }}
+      </h3>
+      {%- if _meta.tagline -%}
+      <p class="text-body-secondary mb-3">{{ _meta.tagline | escape }}</p>
+      {%- endif -%}
+      <div class="row row-cols-2 row-cols-md-3 row-cols-lg-4 g-4">
+        {%- for _book in _books -%}
+        <div class="col">
+          {%- include components/book-card.html book=_book -%}
+        </div>
+        {%- endfor -%}
+      </div>
+    </div>
+  {%- endfor -%}
+</section>
+{%- else -%}
+  {%- comment -%} bookshelf: no books collection or no book landing pages — skipping render {%- endcomment -%}
+{%- endif -%}

data/_includes/components/card-grid.html

@@ -0,0 +1,60 @@
+{%- comment -%}
+  ===================================================================
+  CARD-GRID — responsive grid of data-driven cards
+  ===================================================================
+
+  Path: _includes/components/card-grid.html
+  Purpose: Render an array of card hashes (see components/data-card.html
+           for the item schema) as a responsive Bootstrap grid. Built for
+           org hub dashboards, fleet registries, service grids, and any
+           "cards from a _data file" page — the markup consumers have
+           been hand-rolling per site.
+
+  Parameters:
+    items         (array, required) — card hashes (data-card schema)
+    columns       (string) — row-cols classes,
+                  default "row-cols-1 row-cols-md-2 row-cols-lg-3"
+    gap           (string) — gutter class, default "g-4"
+    heading_level (string) — heading tag for card titles, default "h3"
+                  (pick to fit the page outline, e.g. "h2" under an h1)
+    card_class    (string) — extra classes for every card
+    empty_message (string) — message when items is empty/missing;
+                  omit to render nothing at all
+    id            (string) — id for the grid wrapper
+    aria_label    (string) — aria-label for the grid wrapper
+
+  Example — an org hub page over a generated registry:
+    {% include components/card-grid.html
+       items=site.data.hub_index.repos
+       columns="row-cols-1 row-cols-md-2"
+       heading_level="h2"
+       empty_message="No member repositories registered yet." %}
+
+  Data files map 1:1 to the schema, e.g.:
+    - title: "1776"
+      url: "https://year-of-ai.github.io/1776/"
+      external: true
+      icon: bi-journal-richtext
+      description: "The revolutionary year."
+      badge: live
+      badge_variant: success
+      meta: [ { icon: bi-files, text: "42 pages" } ]
+  ===================================================================
+{%- endcomment -%}
+{%- assign _cg_items = include.items -%}
+{%- if _cg_items and _cg_items.size > 0 -%}
+<div class="row {{ include.columns | default: 'row-cols-1 row-cols-md-2 row-cols-lg-3' }} {{ include.gap | default: 'g-4' }} zer0-card-grid"
+     {%- if include.id %} id="{{ include.id }}"{% endif %}
+     {%- if include.aria_label %} role="list" aria-label="{{ include.aria_label | escape }}"{% endif %}>
+  {%- for _cg_item in _cg_items %}
+  <div class="col"{% if include.aria_label %} role="listitem"{% endif %}>
+    {%- include components/data-card.html item=_cg_item heading_level=include.heading_level card_class=include.card_class -%}
+  </div>
+  {%- endfor %}
+</div>
+{%- elsif include.empty_message -%}
+<div class="text-center py-5 text-body-secondary zer0-card-grid-empty">
+  <i class="bi bi-inbox fs-1 d-block mb-2" aria-hidden="true"></i>
+  <p class="mb-0">{{ include.empty_message }}</p>
+</div>
+{%- endif -%}

data/_includes/components/data-card.html

@@ -0,0 +1,95 @@
+{%- comment -%}
+  ===================================================================
+  DATA-CARD — one generic, data-driven Bootstrap card
+  ===================================================================
+
+  Path: _includes/components/data-card.html
+  Purpose: Render ONE card from a plain data hash so hub dashboards,
+           fleet registries, service grids, and link boards can be
+           data-driven instead of hand-written Bootstrap markup.
+           Usually invoked via components/card-grid.html.
+
+  Parameters:
+    item          (hash, required) — the card data (see schema below)
+    heading_level (string) — heading tag for the title, default "h3"
+    heading_class (string) — classes for the heading, default "h5"
+    card_class    (string) — extra classes on the .card element
+
+  Item schema (every key optional except title):
+    title         card heading text
+    url           makes the title a link
+    external      true → the title link opens in a new tab
+    description   body copy (plain text or inline HTML)
+    icon          Bootstrap Icons class shown before the title (e.g. "bi-robot")
+    image         image path/URL rendered via components/preview-image.html
+    image_alt     alt text for the image (defaults to title)
+    badge         short status label rendered next to the title
+    badge_variant Bootstrap color suffix for the badge (default "secondary")
+    badge_title   tooltip for the badge
+    meta          array of { icon, text } pills rendered under the body
+    buttons       array of { label, url, icon, variant, external } footer actions
+    footer        small muted footer text (rendered when no buttons)
+
+  Example (_data/projects.yml + a page):
+    {% for p in site.data.projects %}
+      {% include components/data-card.html item=p %}
+    {% endfor %}
+  ===================================================================
+{%- endcomment -%}
+{%- assign _dc = include.item -%}
+{%- assign _dc_heading = include.heading_level | default: "h3" -%}
+{%- assign _dc_heading_class = include.heading_class | default: "h5" -%}
+<div class="card h-100 zer0-data-card {{ include.card_class }}">
+  {%- if _dc.image -%}
+    {%- assign _dc_img_alt = _dc.image_alt | default: _dc.title -%}
+    {%- if _dc.url -%}<a href="{{ _dc.url | relative_url }}" tabindex="-1" aria-hidden="true">{%- endif -%}
+    {%- include components/preview-image.html src=_dc.image alt=_dc_img_alt class="card-img-top" style="height: 160px; object-fit: cover;" -%}
+    {%- if _dc.url -%}</a>{%- endif -%}
+  {%- endif -%}
+  <div class="card-body d-flex flex-column">
+    <{{ _dc_heading }} class="card-title {{ _dc_heading_class }} mb-2 d-flex align-items-center">
+      {%- if _dc.icon %}<i class="bi {{ _dc.icon }} me-2" aria-hidden="true"></i>{% endif -%}
+      <span class="flex-grow-1">
+        {%- if _dc.url -%}
+          <a href="{{ _dc.url | relative_url }}" class="text-decoration-none text-body-emphasis"
+             {%- if _dc.external %} target="_blank" rel="noopener"{% endif %}>{{ _dc.title }}</a>
+        {%- else -%}
+          {{ _dc.title }}
+        {%- endif -%}
+      </span>
+      {%- if _dc.badge %}
+      <span class="badge text-bg-{{ _dc.badge_variant | default: 'secondary' }} ms-2"
+            {%- if _dc.badge_title %} title="{{ _dc.badge_title | escape }}"{% endif %}>{{ _dc.badge }}</span>
+      {%- endif %}
+    </{{ _dc_heading }}>
+    {%- if _dc.description %}
+    <p class="card-text text-body-secondary mb-2">{{ _dc.description }}</p>
+    {%- endif %}
+    {%- if _dc.meta and _dc.meta.size > 0 %}
+    <div class="d-flex flex-wrap gap-2 mt-auto pt-2">
+      {%- for m in _dc.meta %}
+      <span class="badge rounded-pill text-bg-light border text-body-secondary fw-normal">
+        {%- if m.icon %}<i class="bi {{ m.icon }} me-1" aria-hidden="true"></i>{% endif -%}
+        {{ m.text }}
+      </span>
+      {%- endfor %}
+    </div>
+    {%- endif %}
+  </div>
+  {%- if _dc.buttons and _dc.buttons.size > 0 %}
+  <div class="card-footer bg-transparent d-flex flex-wrap gap-2">
+    {%- for b in _dc.buttons %}
+    <a class="btn btn-sm btn-{{ b.variant | default: 'outline-primary' }}"
+       href="{{ b.url | relative_url }}"
+       {%- if b.external %} target="_blank" rel="noopener"{% endif %}>
+      {%- if b.icon %}<i class="bi {{ b.icon }} me-1" aria-hidden="true"></i>{% endif -%}
+      {{ b.label }}
+    </a>
+    {%- endfor %}
+  </div>
+  {%- elsif _dc.footer %}
+  <div class="card-footer bg-transparent">
+    <small class="text-body-secondary">{{ _dc.footer }}</small>
+  </div>
+  {%- endif %}
+</div>

data/_includes/components/env-switcher.html

@@ -132,7 +132,8 @@
       </div>
     </li>
 
-    <!-- Development URL -->
+    {% unless is_production %}
+    <!-- Development URL (dev builds only — never leak localhost into production HTML) -->
     <li class="list-group-item d-flex justify-content-between align-items-center gap-2">
       <div class="d-flex align-items-center min-w-0">
         <span class="badge bg-warning text-dark me-2">Dev</span>
@@ -162,6 +163,7 @@
         </button>
       </div>
     </li>
+    {% endunless %}
 
     {% if site.repository %}
     <!-- GitHub Source -->

data/_includes/components/halfmoon.html

@@ -9,8 +9,11 @@
                page (settings offcanvas + theme-controls-bar).
   params:      class (string, optional, default "") — extra btn-group classes,
                e.g. "w-100" to fill the parent.
+  config:      site.color_mode_lock: true removes the control entirely — the
+               site pins one mode and visitor switching is disabled
+               (halfmoon.js + core/color-mode-init.html enforce the same).
  -->
-
+{% unless site.color_mode_lock %}
 <div class="btn-group bd-theme-switch {{ include.class | default: '' }}" role="group" aria-label="Color mode">
   <button type="button" class="btn btn-outline-secondary btn-sm d-flex align-items-center justify-content-center gap-1" data-bs-theme-value="light" aria-pressed="false">
     <svg class="bi flex-shrink-0" width="1em" height="1em" fill="currentColor" aria-hidden="true"><use href="#sun-fill"></use></svg>
@@ -25,3 +28,4 @@
     <span>Auto</span>
   </button>
 </div>
+{% endunless %}

data/_includes/components/language-toggle.html

@@ -0,0 +1,81 @@
+{% comment %} Feature: ZER0-078 {% endcomment %}
+{%- comment -%}
+  Component:   language-toggle
+  Path:        _includes/components/language-toggle.html
+  Purpose:     Navbar dropdown that switches between the English original and
+               its machine-generated translations (scripts/translate.rb).
+               Shows the source language plus every configured target
+               language; targets without a generated translation for the
+               current page render as disabled entries.
+  Params:      none — reads page.lang / page.url / page.translation_source_url
+               and the generated _data/i18n/manifest.yml.
+  Depends on:  site.translation.* config, site.data.i18n.manifest,
+               _data/i18n/languages.yml (display names), core/i18n.html,
+               Bootstrap 5 dropdown, Bootstrap Icons (bi-translate)
+  Notes:       Renders nothing when translation is disabled or no target
+               languages are configured. The chosen language is remembered in
+               localStorage("zer0-lang") for future UX (no auto-redirect).
+               Must NOT be include_cached — the menu is page-dependent.
+{%- endcomment -%}
+{%- assign _lt_langs = site.translation.languages -%}
+{%- if site.translation.enabled and _lt_langs and _lt_langs.size > 0 -%}
+{%- include core/i18n.html -%}
+{%- assign _lt_source = site.translation.source_lang | default: 'en' -%}
+{%- assign _lt_current = page.lang | default: _lt_source -%}
+{%- if _lt_current == _lt_source -%}
+  {%- assign _lt_src_url = page.url -%}
+{%- else -%}
+  {%- assign _lt_src_url = page.translation_source_url -%}
+{%- endif -%}
+{%- assign _lt_entry = site.data.i18n.manifest.pages[_lt_src_url] -%}
+{%- assign _lt_names = site.data.i18n.languages -%}
+{%- assign _lt_source_name = _lt_names[_lt_source].native | default: _lt_source -%}
+<div class="dropdown nav-lang-toggle" id="zer0-lang-toggle">
+    <button
+        class="btn nav-lang-button dropdown-toggle"
+        type="button"
+        id="langToggleButton"
+        data-bs-toggle="dropdown"
+        aria-expanded="false"
+        aria-label="{{ ui.lang_toggle_aria | default: 'Change language' }}"
+        title="{{ ui.lang_toggle_label | default: 'Language' }}"
+    >
+        <i class="{{ site.default_icon }} bi-translate" aria-hidden="true"></i>
+        <span class="nav-link-text d-none d-xl-inline ms-1 text-uppercase">{{ _lt_current | slice: 0, 2 }}</span>
+    </button>
+    <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="langToggleButton">
+        <li>
+            {%- if _lt_current == _lt_source %}
+            <span class="dropdown-item active" aria-current="true">{{ _lt_source_name }}</span>
+            {%- else %}
+            <a class="dropdown-item" data-lang="{{ _lt_source }}" hreflang="{{ _lt_source }}" href="{{ _lt_src_url | default: '/' | relative_url }}">{{ _lt_source_name }}</a>
+            {%- endif %}
+        </li>
+        {%- for _lt_lang in _lt_langs -%}
+        {%- assign _lt_name = _lt_names[_lt_lang].native | default: _lt_lang -%}
+        {%- assign _lt_t = _lt_entry[_lt_lang] %}
+        <li>
+            {%- if _lt_current == _lt_lang %}
+            <span class="dropdown-item active" aria-current="true">{{ _lt_name }}</span>
+            {%- elsif _lt_t %}
+            <a class="dropdown-item" data-lang="{{ _lt_lang }}" hreflang="{{ _lt_lang }}" href="{{ _lt_t.url | relative_url }}">{{ _lt_name }}</a>
+            {%- else %}
+            <span class="dropdown-item disabled" aria-disabled="true" title="{{ ui.lang_not_available | default: 'Not yet translated' }}">{{ _lt_name }} <small class="text-body-secondary">({{ ui.lang_not_available | default: 'Not yet translated' }})</small></span>
+            {%- endif %}
+        </li>
+        {%- endfor %}
+    </ul>
+</div>
+<script>
+  // Remember the visitor's language pick (no auto-redirect — just preference).
+  (function () {
+    var toggle = document.getElementById('zer0-lang-toggle');
+    if (!toggle) return;
+    toggle.addEventListener('click', function (event) {
+      var item = event.target.closest('a.dropdown-item[data-lang]');
+      if (!item) return;
+      try { localStorage.setItem('zer0-lang', item.getAttribute('data-lang')); } catch (e) { /* private mode */ }
+    });
+  })();
+</script>
+{%- endif -%}

data/_includes/components/page-feedback.html

@@ -103,6 +103,14 @@
       <!-- Step 1 — request type -->
       <fieldset class="pf-field pf-types">
         <legend class="pf-legend">What kind of feedback?</legend>
+        {%- comment -%}
+          _data/feedback_types.yml is optional for consumers (remote_theme
+          cannot ship _data). Without it the widget falls back to a minimal
+          generic taxonomy (see pf_fallback_types below) instead of rendering
+          an empty selector. The fallback entries carry no GitHub labels and
+          no agent directive — labels must exist in the target repo or GitHub
+          silently drops them from prefilled issue URLs.
+        {%- endcomment -%}
         {%- assign pf_group = "" -%}
         {%- for t in site.data.feedback_types -%}
           {%- if t.group != pf_group -%}
@@ -124,6 +132,54 @@
             </span>
           </button>
           {%- if forloop.last -%}</div>{%- endif -%}
+        {%- else -%}
+          {%- comment -%}
+            _data/feedback_types.yml is optional for consumers (remote_theme
+            cannot ship _data). Without it, render this minimal generic
+            taxonomy instead of an empty selector. Ids/markup must stay in
+            sync with the fallback JSON in the #pageFeedbackTypes script
+            below. Fallback entries carry no GitHub labels (labels must exist
+            in the target repo or GitHub silently drops them) and no agent
+            directive.
+          {%- endcomment -%}
+          <p class="pf-types-group">This page</p>
+          <div class="pf-types-grid" role="radiogroup" aria-label="This page">
+            <button type="button" class="pf-type" role="radio" aria-checked="false"
+                    data-pf-type-id="fix-page" tabindex="0">
+              <i class="bi bi-bug pf-type-icon" aria-hidden="true"></i>
+              <span class="pf-type-text">
+                <span class="pf-type-label">Report a problem</span>
+                <span class="pf-type-desc">A typo, broken link, wrong information, or something rendering badly</span>
+              </span>
+            </button>
+            <button type="button" class="pf-type" role="radio" aria-checked="false"
+                    data-pf-type-id="improve-page" tabindex="-1">
+              <i class="bi bi-stars pf-type-icon" aria-hidden="true"></i>
+              <span class="pf-type-text">
+                <span class="pf-type-label">Improve this page</span>
+                <span class="pf-type-desc">Polish the copy, structure, or presentation</span>
+              </span>
+            </button>
+          </div>
+          <p class="pf-types-group">The site</p>
+          <div class="pf-types-grid" role="radiogroup" aria-label="The site">
+            <button type="button" class="pf-type" role="radio" aria-checked="false"
+                    data-pf-type-id="feature" tabindex="-1">
+              <i class="bi bi-lightbulb pf-type-icon" aria-hidden="true"></i>
+              <span class="pf-type-text">
+                <span class="pf-type-label">Suggest a feature</span>
+                <span class="pf-type-desc">An idea that would make the site more useful</span>
+              </span>
+            </button>
+            <button type="button" class="pf-type" role="radio" aria-checked="false"
+                    data-pf-type-id="question" tabindex="-1">
+              <i class="bi bi-question-circle pf-type-icon" aria-hidden="true"></i>
+              <span class="pf-type-text">
+                <span class="pf-type-label">Ask a question</span>
+                <span class="pf-type-desc">Something unclear that is not exactly a bug</span>
+              </span>
+            </button>
+          </div>
         {%- endfor -%}
       </fieldset>
 
@@ -219,9 +275,16 @@
 }
 </script>
 
-<!-- Request-type taxonomy (from _data/feedback_types.yml) -->
+<!-- Request-type taxonomy (from _data/feedback_types.yml; generic fallback
+     when the site ships no data file — keep in sync with the fallback markup
+     in the pf-types fieldset above) -->
 <script id="pageFeedbackTypes" type="application/json">
-{{ site.data.feedback_types | jsonify }}
+{% if site.data.feedback_types %}{{ site.data.feedback_types | jsonify }}{% else %}[
+  {"id":"fix-page","label":"Report a problem","icon":"bi-bug","group":"This page","scope":"page","description":"A typo, broken link, wrong information, or something rendering badly","labels":[],"agent":false,"placeholder":"What is wrong, where on the page, and what did you expect instead?"},
+  {"id":"improve-page","label":"Improve this page","icon":"bi-stars","group":"This page","scope":"page","description":"Polish the copy, structure, or presentation","labels":[],"agent":false,"placeholder":"What would make this page clearer, tighter, or more useful?"},
+  {"id":"feature","label":"Suggest a feature","icon":"bi-lightbulb","group":"The site","scope":"site","description":"An idea that would make the site more useful","labels":[],"agent":false,"placeholder":"Describe the feature and the problem it would solve."},
+  {"id":"question","label":"Ask a question","icon":"bi-question-circle","group":"The site","scope":"site","description":"Something unclear that is not exactly a bug","labels":[],"agent":false,"placeholder":"What would you like to know?"}
+]{% endif %}
 </script>
 
 <!-- Live page context (build-time front matter; runtime detail added by JS) -->

data/_includes/components/search-modal.html

@@ -18,8 +18,8 @@
   ===================================================================
 -->
 
-{%- assign ui_text = site.data.ui-text[site.locale] | default: site.data.ui-text.en -%}
-{%- assign search_placeholder = ui_text.search_placeholder_text | default: "Enter your search term..." -%}
+{%- include core/i18n.html lang=include.lang -%}
+{%- assign search_placeholder = ui.search_placeholder_text | default: "Enter your search term..." -%}
 {%- comment -%}
   Existence-gate the form action to /sitemap/ only when that page is present
   in the build (mirroring the footer Quick Links guard, and the section-sidebar

data/_includes/components/shortcuts-modal.html

@@ -14,7 +14,7 @@
   is a no-op when the element is absent.
   ===================================================================
 {%- endcomment -%}
-{%- assign ui = site.data.ui-text[site.locale] | default: site.data.ui-text.en -%}
+{%- include core/i18n.html lang=include.lang -%}
 <div class="modal fade" id="zer0-shortcuts-modal" tabindex="-1"
      aria-labelledby="zer0-shortcuts-modal-title" aria-hidden="true">
   <div class="modal-dialog modal-dialog-centered">

data/_includes/components/theme-controls-bar.html

@@ -13,16 +13,24 @@
   Used by theme settings and theme preview pages.
   ===================================================================
 {%- endcomment -%}
-{% assign active_skin = site.theme_skin | default: site.data.theme_skins.default | default: "dark" %}
-{% assign skin_order = site.data.theme_skins.order %}
+{%- comment -%}
+  _data/theme_skins.yml is optional for consumers (remote_theme cannot ship
+  _data), so fall back to the compiled skin registry. Keep this list in sync
+  with the [data-theme-skin] blocks in _sass/theme/_skins.scss.
+{%- endcomment -%}
+{% assign _skin_fallback = "air|aqua|dirt|neon|mint|plum|sunrise" | split: "|" %}
+{% assign active_skin = site.theme_skin | default: site.data.theme_skins.default | default: "air" %}
+{% assign skin_order = site.data.theme_skins.order | default: _skin_fallback %}
 
 <div class="theme-controls-bar d-flex flex-wrap align-items-center gap-3 mb-4 p-3 bg-body-tertiary rounded-3 border">
+  {% unless site.color_mode_lock %}
   <div class="d-flex align-items-center gap-2">
     <i class="bi bi-moon-stars" aria-hidden="true"></i>
     <span class="fw-semibold small">Mode:</span>
     {% include components/halfmoon.html %}
   </div>
   <div class="vr d-none d-sm-block" aria-hidden="true"></div>
+  {% endunless %}
   <div class="d-flex align-items-center gap-2 flex-grow-1">
     <i class="bi bi-palette2" aria-hidden="true"></i>
     <span class="fw-semibold small">Skin:</span>