@omega.js/desktop 0.1.0

package/dist/assets/themes/base/_includes/global/sections/app-sidebar.html

@@ -0,0 +1,248 @@
+{% comment %}
+  Base app sidebar, omega-* markup shared by backend + admin surfaces. The
+  CALLER assigns `data` (backend/sections/sidebar.html and
+  admin/sections/sidebar.html bind their own json) before including this.
+
+  Data shape:
+    logo:     { href, src, text, class }
+    selector: { enabled, name, env, initial, dropdown: [{label, href, icon, divider}] }   (optional)
+    links:    [{ label, href, icon, badge: {text, class} }
+               | { header: true, label }
+               | { divider: true }
+               | { label, icon, dropdown: [ …links, nested dropdowns… ] }]
+    bottom:   { vert: { enabled } }                                                      (optional)
+
+  Anything textual wears .omega-shell__label so the rail collapse hides it
+  (core/css/shell). Active detection via urlmatches, including nested groups.
+
+  The brand and the selector are the rail's PINNED head; everything below them
+  lives in .omega-shell__sidebar-scroll. That is the selector's escape (#319):
+  the rail itself never clips, so its open menu leaves the 264px box instead of
+  being cut where the sidebar meets the content column.
+{% endcomment %}
+
+<aside class="omega-shell__sidebar" id="app-sidebar">
+  <!-- Brand lockup -->
+  {% capture logo_href %}{% assign temp_href = data.logo.href | default: resolved.config.brand.href | default: '/dashboard/account' %}{% if temp_href and temp_href != '' and temp_href != 'null' %}{{ temp_href }}{% else %}javascript:void(0){% endif %}{% endcapture %}
+  {% comment %} The VISIBLE logo prefers the bridged vector when the mint produced one (#467) —
+    `brand.images.brandmark` stays the raster OG/social and payment sync need, and an
+    authored `data.logo.src` still outranks both. {% endcomment %}
+  {% capture logo_src %}{% if data.logo.src %}{{ data.logo.src }}{% else %}{{ assetManifest.brandmarkSvg | default: resolved.config.brand.images.brandmark | default: null }}{% endif %}{% endcapture %}
+  {% capture logo_text %}{{ data.logo.text | default: resolved.config.brand.name | omega_liquify }}{% endcapture %}
+
+  <a href="{{ logo_href }}" class="omega-side__brand">
+    {% iftruthy logo_src %}
+      <img src="{{ logo_src | omega_cachebreak }}" alt="{{ logo_text }} Logo" class="{{ data.logo.class | default: 'filter-adaptive' }}"/>
+    {% endiftruthy %}
+    {% iftruthy logo_text %}
+      <span class="omega-shell__label">{{ logo_text }}</span>
+    {% endiftruthy %}
+  </a>
+
+  <!-- Project selector (optional module) -->
+  {% if data.selector.enabled %}
+    {% capture selector_name %}{{ data.selector.name | omega_liquify }}{% endcapture %}
+    {% capture selector_initial %}{% if data.selector.initial %}{{ data.selector.initial }}{% else %}{{ selector_name | slice: 0 }}{% endif %}{% endcapture %}
+    <div class="dropdown">
+      <button class="omega-side__selector" type="button" data-bs-toggle="dropdown" aria-expanded="false" aria-label="Switch project">
+        <span class="omega-side__selector-tile">{{ selector_initial | upcase }}</span>
+        <span class="omega-shell__label">
+          <span class="omega-side__selector-name d-block">{{ selector_name }}</span>
+          {% iftruthy data.selector.env %}
+            <span class="omega-side__selector-env d-block">{{ data.selector.env | omega_liquify }}</span>
+          {% endiftruthy %}
+        </span>
+        <span class="omega-side__selector-chevron"><i class="fa-solid fa-arrows-up-down fa-xs"></i></span>
+      </button>
+      {% if data.selector.dropdown %}
+        <ul class="dropdown-menu">
+          {% for item in data.selector.dropdown %}
+            {% if item.divider %}
+              <li><hr class="dropdown-divider"/></li>
+            {% else %}
+              <li>
+                <a class="dropdown-item" href="{{ item.href | default: '#' }}">
+                  {% if item.icon %}<i class="fa-solid fa-{{ item.icon }} fa-sm me-2"></i>{% endif %}
+                  {{ item.label | omega_liquify }}
+                </a>
+              </li>
+            {% endif %}
+          {% endfor %}
+        </ul>
+      {% endif %}
+    </div>
+  {% endif %}
+
+  <!-- Scrolling body: nav + bottom slot (the pinned head above never clips) -->
+  <div class="omega-shell__sidebar-scroll">
+    <!-- Navigation -->
+    <ul class="list-unstyled mb-0">
+      {% for link in data.links %}
+        {% if link.divider %}
+          <li class="hairline-top my-2"></li>
+        {% elsif link.header %}
+          <li><span class="omega-side__label omega-shell__label">{{ link.label }}</span></li>
+        {% elsif link.dropdown %}
+          <!-- Collapsible group (open when a descendant is active) -->
+          {% capture link_id %}sidebar-collapse-{{ forloop.index }}{% endcapture %}
+          {% assign dropdown_has_active = false %}
+          {% for child in link.dropdown %}
+            {% unless child.divider %}
+              {% if child.dropdown %}
+                {% for grandchild in child.dropdown %}
+                  {% unless grandchild.divider %}
+                    {% capture _check_nested %}{% urlmatches grandchild.href, "active" %}{% endcapture %}
+                    {% if _check_nested == "active" %}{% assign dropdown_has_active = true %}{% endif %}
+                  {% endunless %}
+                {% endfor %}
+              {% else %}
+                {% capture _check_active %}{% urlmatches child.href, "active" %}{% endcapture %}
+                {% if _check_active == "active" %}{% assign dropdown_has_active = true %}{% endif %}
+              {% endif %}
+            {% endunless %}
+          {% endfor %}
+          <li>
+            <button class="omega-side__item {% if dropdown_has_active %}active{% endif %}" type="button" data-bs-toggle="collapse" data-bs-target="#{{ link_id }}" aria-expanded="{{ dropdown_has_active }}">
+              {% if link.icon %}
+                <span class="omega-side__icon"><i class="fa-solid fa-{{ link.icon }} fa-sm"></i></span>
+              {% endif %}
+              <span class="omega-shell__label">{{ link.label }}</span>
+              <span class="omega-side__chevron"><i class="fa-solid fa-chevron-right fa-xs"></i></span>
+            </button>
+            <div class="collapse {% if dropdown_has_active %}show{% endif %}" id="{{ link_id }}">
+              <ul class="omega-side__children">
+                {% for child in link.dropdown %}
+                  {% if child.divider %}
+                    <li class="hairline-top my-2"></li>
+                  {% elsif child.dropdown %}
+                    <!-- Nested group -->
+                    {% capture nested_id %}{{ link_id }}-nested-{{ forloop.index }}{% endcapture %}
+                    {% assign nested_has_active = false %}
+                    {% for grandchild in child.dropdown %}
+                      {% unless grandchild.divider %}
+                        {% capture _check_nested %}{% urlmatches grandchild.href, "active" %}{% endcapture %}
+                        {% if _check_nested == "active" %}{% assign nested_has_active = true %}{% endif %}
+                      {% endunless %}
+                    {% endfor %}
+                    <li>
+                      <button class="omega-side__item {% if nested_has_active %}active{% endif %}" type="button" data-bs-toggle="collapse" data-bs-target="#{{ nested_id }}" aria-expanded="{{ nested_has_active }}">
+                        {% if child.icon %}
+                          <span class="omega-side__icon"><i class="fa-solid fa-{{ child.icon }} fa-sm"></i></span>
+                        {% endif %}
+                        <span class="omega-shell__label">{{ child.label }}</span>
+                        <span class="omega-side__chevron"><i class="fa-solid fa-chevron-right fa-xs"></i></span>
+                      </button>
+                      <div class="collapse {% if nested_has_active %}show{% endif %}" id="{{ nested_id }}">
+                        <ul class="omega-side__children">
+                          {% for grandchild in child.dropdown %}
+                            {% if grandchild.divider %}
+                              <li class="hairline-top my-2"></li>
+                            {% else %}
+                              {% capture grandchild_active %}{% urlmatches grandchild.href, "active" %}{% endcapture %}
+                              <li>
+                                <a href="{{ grandchild.href }}" class="omega-side__item {{ grandchild_active }}">
+                                  {% if grandchild.icon %}
+                                    <span class="omega-side__icon"><i class="fa-solid fa-{{ grandchild.icon }} fa-sm"></i></span>
+                                  {% endif %}
+                                  <span class="omega-shell__label">{{ grandchild.label }}</span>
+                                </a>
+                              </li>
+                            {% endif %}
+                          {% endfor %}
+                        </ul>
+                      </div>
+                    </li>
+                  {% else %}
+                    {% capture child_active %}{% urlmatches child.href, "active" %}{% endcapture %}
+                    {% capture child_attributes %}{% if child.attributes %}{% for attr in child.attributes %} {{ attr[0] }}="{{ attr[1] }}"{% endfor %}{% endif %}{% endcapture %}
+                    <li>
+                      {% iftruthy child.href %}
+                        <a href="{{ child.href }}" class="omega-side__item {{ child_active }}" {{ child_attributes }}>
+                          {% if child.icon %}
+                            <span class="omega-side__icon"><i class="fa-solid fa-{{ child.icon }} fa-sm"></i></span>
+                          {% endif %}
+                          <span class="omega-shell__label">{{ child.label }}</span>
+                          {% if child.badge %}
+                            <span class="omega-chip omega-side__chip omega-shell__label {{ child.badge.class }}">{{ child.badge.text }}</span>
+                          {% endif %}
+                        </a>
+                      {% endiftruthy %}
+                      {% iffalsy child.href %}
+                        <button type="button" class="omega-side__item {% if child.class %}{{ child.class }}{% endif %}" {{ child_attributes }}>
+                          {% if child.icon %}
+                            <span class="omega-side__icon"><i class="fa-solid fa-{{ child.icon }} fa-sm"></i></span>
+                          {% endif %}
+                          <span class="omega-shell__label">{{ child.label }}</span>
+                        </button>
+                      {% endiffalsy %}
+                    </li>
+                  {% endif %}
+                {% endfor %}
+              </ul>
+            </div>
+          </li>
+        {% else %}
+          <!-- Regular nav link -->
+          {% capture link_active %}{% urlmatches link.href, "active" %}{% endcapture %}
+          {% capture link_attributes %}{% if link.attributes %}{% for attr in link.attributes %} {{ attr[0] }}="{{ attr[1] }}"{% endfor %}{% endif %}{% endcapture %}
+          <li>
+            {% iftruthy link.href %}
+              <a href="{{ link.href }}" class="omega-side__item {{ link_active }}" {{ link_attributes }}>
+                {% if link.icon %}
+                  <span class="omega-side__icon"><i class="fa-solid fa-{{ link.icon }} fa-sm"></i></span>
+                {% endif %}
+                <span class="omega-shell__label">{{ link.label }}</span>
+                {% if link.badge %}
+                  <span class="omega-chip omega-side__chip omega-shell__label {{ link.badge.class }}">{{ link.badge.text }}</span>
+                {% endif %}
+              </a>
+            {% endiftruthy %}
+            {% iffalsy link.href %}
+              <button type="button" class="omega-side__item" {{ link_attributes }}>
+                {% if link.icon %}
+                  <span class="omega-side__icon"><i class="fa-solid fa-{{ link.icon }} fa-sm"></i></span>
+                {% endif %}
+                <span class="omega-shell__label">{{ link.label }}</span>
+              </button>
+            {% endiffalsy %}
+          </li>
+        {% endif %}
+      {% endfor %}
+    </ul>
+
+    <!-- Bottom section: optional vert slot + user row -->
+    <div class="mt-auto">
+      {% comment %} The rail vert slot: the surface opts in through its sidebar data
+        (the dashboard does, admin does not) and the brand's `advertising` config key
+        gates it — no config, no slot chrome (docs/web/ads-system.md). {% endcomment %}
+      {% if data.bottom.vert.enabled and resolved.config.advertising %}
+        <div class="omega-side__ad omega-shell__label">
+          <div class="d-flex align-items-center justify-content-between mb-2">
+            <span class="omega-chip">Sponsored</span>
+            <a href="/pricing" class="omega-footer__link" data-omega-bind="@show !auth.resolved.active" hidden aria-label="Remove ads with Pro">
+              <i class="fa-solid fa-xmark fa-xs"></i>
+            </a>
+          </div>
+          {% section "verts/unit", type: "in-article", size: "rectangle" %}
+          <a href="/pricing" class="d-block text-center omega-footer__link small mt-2 text-decoration-none" data-omega-bind="@show !auth.resolved.active" hidden>
+            Remove with <span class="text-primary">Pro</span>
+          </a>
+        </div>
+      {% endif %}
+
+      <!-- User row -->
+      <div class="omega-side__user" data-omega-bind="@show auth.user" hidden>
+        <span class="avatar avatar-sm rounded-circle overflow-hidden d-inline-flex flex-shrink-0">
+          <img src="{{ site.omega.placeholder.src }}" data-omega-bind="@attr src auth.user.photoURL" alt="{{ resolved.config.brand.name }} profile picture"/>
+        </span>
+        <span class="omega-shell__label flex-grow-1 overflow-hidden">
+          <span class="omega-side__user-name d-block text-truncate" data-omega-bind="@text auth.user.displayName">User</span>
+          <span class="omega-side__user-email d-block text-truncate" data-omega-bind="@text auth.user.email">email@example.com</span>
+        </span>
+        <a href="/dashboard/account" class="btn-icon omega-shell__label" aria-label="Account settings">
+          <i class="fa-solid fa-gear fa-sm"></i>
+        </a>
+      </div>
+    </div>
+  </div>
+</aside>

package/dist/assets/themes/base/_includes/global/sections/app-topbar.html

@@ -0,0 +1,228 @@
+{% comment %}
+  Base app topbar, omega-* markup shared by backend + admin surfaces (the cap
+  of the big content card). The CALLER assigns `data` before including this.
+
+  Data shape:
+    search:  { enabled, action, name, placeholder }        (optional; form GET)
+    status:  { label, tone: ok|warn|danger }                (optional env pill)
+    actions: [{ type: 'account' } | { type: 'notifications', icon, badge, dropdown }
+              | { label, href, icon, class, size, dropdown }]
+
+    action.size is 'sm' | 'lg' (Bootstrap's button sizes) — anything else
+    renders no size class. NEVER test it for truthiness: Liquid answers `.size`
+    on a hash with its KEY COUNT, so every action would "have" a size (#43).
+
+  Breadcrumbs come from the page's resolved.config.theme.header.breadcrumbs.items
+  (the same frontmatter API as ever — they render here now instead of the
+  in-card page header).
+{% endcomment %}
+
+<header class="omega-shell__topbar">
+  <div class="omega-shell__topbar-start">
+    {% comment %}Rail controls, on the same switch backend/core/base applies to the sidebar itself (#740): with no rail on the page they would be dead buttons naming an id the document does not carry.{% endcomment %}
+    {% unless resolved.config.theme.sidebar.enabled == false %}
+      <!-- Drawer toggle (mobile) -->
+      <button class="btn-icon d-xl-none" type="button" data-shell-toggle="drawer" aria-expanded="false" aria-controls="app-sidebar" aria-label="Toggle navigation">
+        <i class="fa-solid fa-bars fa-md"></i>
+      </button>
+
+      <!-- Rail collapse toggle (desktop) -->
+      <button class="btn-icon d-none d-xl-inline-flex" type="button" data-shell-toggle="collapse" aria-expanded="true" aria-controls="app-sidebar" aria-label="Toggle sidebar">
+        <i class="fa-solid fa-table-columns fa-sm"></i>
+      </button>
+    {% endunless %}
+
+    <!-- Breadcrumb trail -->
+    <div class="omega-topbar__crumbs d-none d-md-flex">
+      {% if resolved.config.theme.header.breadcrumbs.items %}
+        {% for crumb in resolved.config.theme.header.breadcrumbs.items %}
+          {% if forloop.last %}
+            <span>{{ crumb.label }}</span>
+          {% else %}
+            {% iftruthy crumb.href %}
+              <a href="{{ crumb.href }}">{{ crumb.label }}</a>
+            {% endiftruthy %}
+            {% iffalsy crumb.href %}
+              <span>{{ crumb.label }}</span>
+            {% endiffalsy %}
+            <span class="omega-topbar__crumb-sep">/</span>
+          {% endif %}
+        {% endfor %}
+      {% else %}
+        <span>{{ resolved.config.theme.header.title.content | default: resolved.meta.title | omega_liquify }}</span>
+      {% endif %}
+
+      {% iftruthy data.status.label %}
+        <span class="omega-status omega-status--{{ data.status.tone | default: 'ok' }} ms-2">
+          <span class="omega-dot omega-dot--{{ data.status.tone | default: 'ok' }}"></span>
+          {{ data.status.label }}
+        </span>
+      {% endiftruthy %}
+    </div>
+  </div>
+
+  <!-- Search (center) -->
+  {% if data.search %}
+    <div class="omega-topbar__center">
+      <form class="omega-search" action="{{ data.search.action | default: '/search' }}" method="get" role="search">
+        <i class="fa-solid fa-magnifying-glass fa-sm"></i>
+        <input
+          type="search"
+          name="{{ data.search.name | default: 'q' }}"
+          placeholder="{{ data.search.placeholder | default: 'Search…' }}"
+          aria-label="Search"
+        />
+        <kbd>⌘K</kbd>
+      </form>
+    </div>
+  {% endif %}
+
+  <div class="omega-shell__topbar-end">
+    <!-- Custom Actions -->
+    {% for action in data.actions %}
+      {% if action.type == 'notifications' %}
+        <!-- Notifications Dropdown -->
+        {% capture action_attributes %}{% if action.attributes %}{% for attr in action.attributes %} {{ attr[0] }}="{{ attr[1] }}"{% endfor %}{% endif %}{% endcapture %}
+        <div class="dropdown">
+          {% capture notif_icon %}{{ action.icon | default: "bell" }}{% endcapture %}
+          <button class="btn-icon position-relative" type="button" data-bs-toggle="dropdown" {{ action_attributes }} aria-expanded="false" aria-label="{{ action.label | default: 'Notifications' }}">
+            <i class="fa-solid fa-{{ notif_icon }} fa-sm"></i>
+            {% if action.badge %}
+              <span class="position-absolute top-0 start-100 translate-middle badge rounded-pill {{ action.badge.class | default: 'bg-danger' }}">
+                {{ action.badge.text }}
+                <span class="visually-hidden">unread notifications</span>
+              </span>
+            {% endif %}
+          </button>
+          <ul class="dropdown-menu dropdown-menu-end" style="min-width: 320px; max-height: 400px; overflow-y: auto;">
+            <li class="px-3 py-2 hairline-bottom">
+              <div class="d-flex align-items-center justify-content-between">
+                <h6 class="mb-0">{{ action.label | default: 'Notifications' }}</h6>
+                {% if action.mark_all_read %}
+                  <a href="{{ action.mark_all_read }}" class="small text-decoration-none">Mark all read</a>
+                {% endif %}
+              </div>
+            </li>
+            {% if action.dropdown %}
+              {% for notification in action.dropdown %}
+                {% capture notif_attributes %}{% if notification.attributes %}{% for attr in notification.attributes %} {{ attr[0] }}="{{ attr[1] }}"{% endfor %}{% endif %}{% endcapture %}
+                {% capture notif_class %}dropdown-item px-3 py-2 {% if notification.class %}{{ notification.class }}{% endif %}{% endcapture %}
+
+                {% if notification.divider %}
+                  <li><hr class="dropdown-divider" {{ notif_attributes }}/></li>
+                {% else %}
+                  <li>
+                    {% capture notif_content %}
+                      <div class="d-flex">
+                        {% if notification.icon %}
+                          <span class="omega-icon-chip omega-icon-chip--neutral me-3 flex-shrink-0">
+                            <i class="fa-solid fa-{{ notification.icon }} fa-sm"></i>
+                          </span>
+                        {% endif %}
+                        <div class="flex-fill">
+                          <div class="fw-semibold small">{{ notification.title }}</div>
+                          {% if notification.message %}
+                            <div class="small text-muted">{{ notification.message }}</div>
+                          {% endif %}
+                          {% if notification.time %}
+                            <div class="small text-muted mt-1">{{ notification.time }}</div>
+                          {% endif %}
+                        </div>
+                        {% if notification.unread %}
+                          <span class="omega-dot ms-2 mt-1"></span>
+                        {% endif %}
+                      </div>
+                    {% endcapture %}
+                    {% iftruthy notification.href %}
+                      <a class="{{ notif_class }}" href="{{ notification.href }}" {{ notif_attributes }}>
+                        {{ notif_content }}
+                      </a>
+                    {% endiftruthy %}
+                    {% iffalsy notification.href %}
+                      <div class="{{ notif_class }}" {{ notif_attributes }}>
+                        {{ notif_content }}
+                      </div>
+                    {% endiffalsy %}
+                  </li>
+                {% endif %}
+              {% endfor %}
+            {% else %}
+              <li class="px-3 py-4 text-center text-muted small">
+                No notifications
+              </li>
+            {% endif %}
+          </ul>
+        </div>
+      {% elsif action.type == 'account' %}
+        <!-- Account Dropdown -->
+        {% include global/sections/account.html size="sm" attributes=action.attributes %}
+      {% elsif action.dropdown %}
+        <!-- Generic Dropdown -->
+        {% comment %}Liquid's `.size` on a hash is its KEY COUNT — test the value, never truthiness (#43). The btn-sm default only applies when the author set no size.{% endcomment %}
+        {% assign action_size = '' %}{% if action.size == 'sm' or action.size == 'lg' %}{% assign action_size = action.size %}{% endif %}
+        {% capture action_class %}btn {% if action_size != '' %}btn-{{ action_size }}{% endif %} {% if action.class %}{{ action.class }}{% else %}btn-outline-adaptive{% if action_size == '' %} btn-sm{% endif %}{% endif %}{% endcapture %}
+        {% capture action_attributes %}{% if action.attributes %}{% for attr in action.attributes %} {{ attr[0] }}="{{ attr[1] }}"{% endfor %}{% endif %}{% endcapture %}
+        <div class="dropdown">
+          <button class="{{ action_class }} dropdown-toggle" type="button" data-bs-toggle="dropdown" {{ action_attributes }}>
+            {% if action.icon %}
+              <i class="fa-solid fa-{{ action.icon }} fa-sm me-2"></i>
+            {% endif %}
+            <span>{{ action.label }}</span>
+          </button>
+          <ul class="dropdown-menu dropdown-menu-end">
+            {% for child in action.dropdown %}
+              {% capture child_attributes %}{% if child.attributes %}{% for attr in child.attributes %} {{ attr[0] }}="{{ attr[1] }}"{% endfor %}{% endif %}{% endcapture %}
+              {% capture child_active %}{% urlmatches child.href, "active" %}{% endcapture %}
+              {% capture child_class %}dropdown-item {{ child_active }} {% if child.class %}{{ child.class }}{% endif %}{% endcapture %}
+              {% capture child_content %}
+                {% if child.icon %}
+                  <i class="fa-solid fa-{{ child.icon }} fa-sm me-2"></i>
+                {% endif %}
+                <span>{{ child.label }}</span>
+              {% endcapture %}
+
+              {% if child.divider %}
+                <li><hr class="dropdown-divider" {{ child_attributes }}/></li>
+              {% else %}
+                <li>
+                  {% iftruthy child.href %}
+                    <a class="{{ child_class }}" href="{{ child.href }}" {{ child_attributes }}>
+                      {{ child_content }}
+                    </a>
+                  {% endiftruthy %}
+                  {% iffalsy child.href %}
+                    <button class="{{ child_class }}" type="button" {{ child_attributes }}>
+                      {{ child_content }}
+                    </button>
+                  {% endiffalsy %}
+                </li>
+              {% endif %}
+            {% endfor %}
+          </ul>
+        </div>
+      {% else %}
+        <!-- Regular Button -->
+        {% comment %}Liquid's `.size` on a hash is its KEY COUNT — test the value, never truthiness (#43). The btn-sm default only applies when the author set no size.{% endcomment %}
+        {% assign action_size = '' %}{% if action.size == 'sm' or action.size == 'lg' %}{% assign action_size = action.size %}{% endif %}
+        {% capture action_class %}btn {% if action_size != '' %}btn-{{ action_size }}{% endif %} {% if action.class %}{{ action.class }}{% else %}btn-outline-adaptive{% if action_size == '' %} btn-sm{% endif %}{% endif %}{% endcapture %}
+        {% capture action_attributes %}{% if action.attributes %}{% for attr in action.attributes %} {{ attr[0] }}="{{ attr[1] }}"{% endfor %}{% endif %}{% endcapture %}
+        {% capture action_content %}
+          {% if action.icon %}
+            <i class="fa-solid fa-{{ action.icon }} fa-sm me-2"></i>
+          {% endif %}
+          <span>{{ action.label }}</span>
+        {% endcapture %}
+        {% iftruthy action.href %}
+          <a class="{{ action_class }}" href="{{ action.href }}" {{ action_attributes }}>
+            {{ action_content }}
+          </a>
+        {% endiftruthy %}
+        {% iffalsy action.href %}
+          <button class="{{ action_class }}" type="button" {{ action_attributes }}>
+            {{ action_content }}
+          </button>
+        {% endiffalsy %}
+      {% endif %}
+    {% endfor %}
+  </div>
+</header>

package/dist/assets/themes/base/_includes/global/sections/page-header.html

@@ -0,0 +1,99 @@
+{% comment %}
+  Shared base in-card page header: title + actions. Breadcrumbs moved to the
+  app topbar (global/sections/app-topbar.html) but keep their frontmatter API:
+  resolved.config.theme.header.{title, actions} render here.
+
+  action.size is 'sm' | 'lg' (Bootstrap's button sizes) — anything else renders
+  no size class. NEVER test it for truthiness: Liquid answers `.size` on a hash
+  with its KEY COUNT, so every action would "have" a size (#43).
+{% endcomment %}
+{% unless resolved.config.theme.header.enabled == false %}
+  <div class="page-header pb-3 mb-4 hairline-bottom">
+    <div class="row align-items-center">
+      <div class="col">
+        <!-- Page Title -->
+        {% unless resolved.config.theme.header.title.enabled == false %}
+          <h1 class="page-title mb-0 d-flex align-items-center {{ resolved.config.theme.header.title.class }}">
+            {% if resolved.config.theme.header.title.icon %}
+              <span class="omega-icon-chip omega-icon-chip--neutral me-2"><i class="fa-solid fa-{{ resolved.config.theme.header.title.icon }} fa-sm"></i></span>
+            {% endif %}
+            {{- resolved.config.theme.header.title.content | default: resolved.meta.title | omega_liquify -}}
+          </h1>
+        {% endunless %}
+      </div>
+
+      <!-- Page Actions (Right Side) -->
+      {% unless resolved.config.theme.header.actions.enabled == false %}
+        {% if resolved.config.theme.header.actions.items %}
+          <div class="col-auto">
+            <div class="d-flex gap-2">
+              {% for action in resolved.config.theme.header.actions.items %}
+                {% capture action_color %}{{ action.color | default: 'adaptive' }}{% endcapture %}
+                {% if action_color == 'primary' %}
+                  {% assign action_btn = 'btn-adaptive' %}
+                {% elsif action_color == 'adaptive' %}
+                  {% assign action_btn = 'btn-outline-adaptive' %}
+                {% else %}
+                  {% capture action_btn %}btn-{{ action_color }}{% endcapture %}
+                {% endif %}
+                {% comment %}Liquid's `.size` on a hash is its KEY COUNT — test the value, never truthiness (#43).{% endcomment %}
+                {% assign action_size = '' %}{% if action.size == 'sm' or action.size == 'lg' %}{% assign action_size = action.size %}{% endif %}
+                {% if action.dropdown %}
+                  <!-- Dropdown Button -->
+                  <div class="dropdown">
+                    <button class="btn {{ action_btn }} {% if action_size != '' %}btn-{{ action_size }}{% endif %} dropdown-toggle"
+                            type="button"
+                            data-bs-toggle="dropdown"
+                            aria-expanded="false">
+                      {% if action.icon %}
+                        <i class="fa-solid fa-{{ action.icon }} fa-sm me-2"></i>
+                      {% endif %}
+                      {{ action.label }}
+                    </button>
+                    <ul class="dropdown-menu dropdown-menu-end">
+                      {% for item in action.dropdown %}
+                        {% if item.divider %}
+                          <li><hr class="dropdown-divider"></li>
+                        {% else %}
+                          <li>
+                            <a class="dropdown-item" href="{{ item.href | default: '#' }}">
+                              {% if item.icon %}
+                                <i class="fa-solid fa-{{ item.icon }} fa-sm me-2"></i>
+                              {% endif %}
+                              {{ item.label }}
+                            </a>
+                          </li>
+                        {% endif %}
+                      {% endfor %}
+                    </ul>
+                  </div>
+                {% else %}
+                  <!-- Regular Button -->
+                  {% capture action_class %}btn {{ action_btn }} {% if action_size != '' %}btn-{{ action_size }}{% endif %} {% if action.class %}{{ action.class }}{% endif %}{% endcapture %}
+                  {% capture action_attributes %}{% if action.attributes %}{% for attr in action.attributes %} {{ attr[0] }}="{{ attr[1] }}"{% endfor %}{% endif %}{% endcapture %}
+                  {% capture action_content %}
+                    {% if action.icon %}
+                      <i class="fa-solid fa-{{ action.icon }} fa-sm me-2"></i>
+                    {% endif %}
+                    {{ action.label }}
+                  {% endcapture %}
+
+                  {% iftruthy action.href %}
+                    <a class="{{ action_class }}" href="{{ action.href }}" {{ action_attributes }}>
+                      {{ action_content }}
+                    </a>
+                  {% endiftruthy %}
+                  {% iffalsy action.href %}
+                    <button class="{{ action_class }}" type="button" {{ action_attributes }}>
+                      {{ action_content }}
+                    </button>
+                  {% endiffalsy %}
+                {% endif %}
+              {% endfor %}
+            </div>
+          </div>
+        {% endif %}
+      {% endunless %}
+    </div>
+  </div>
+{% endunless %}

package/dist/assets/themes/base/_layouts/admin/core/minimal-viewport-locked.html

@@ -0,0 +1,22 @@
+---
+layout: backend/core/minimal-viewport-locked
+
+meta:
+  index: false
+
+config:
+  client:
+    auth:
+      config:
+        policy: "authenticated"
+        roles:
+          admin: true
+    consent:
+      enabled: false
+    chatsy:
+      enabled: false
+    exitPopup:
+      enabled: false
+---
+
+{{ content | omega_content_format }}

package/dist/assets/themes/base/_layouts/admin/core/minimal.html

@@ -0,0 +1,23 @@
+---
+layout: backend/core/minimal
+
+meta:
+  index: false
+
+config:
+  client:
+    auth:
+      config:
+        policy: "authenticated"
+        roles:
+          admin: true
+    consent:
+      enabled: false
+    chatsy:
+      enabled: false
+    exitPopup:
+      enabled: false
+---
+
+{{ content | omega_content_format }}
+