{% load brickwork_icons %}
{% comment %}
Compact rail renderer (brickwork#82): an icon+label primary-navigation
column over the SAME prepared NavItem tree the sidebar renderer consumes
(one nav data model, several renderers). This is tier one of the
capability-rail + contextual-sidebar (two-tier) layout.

Contract:
  Consumption  This is the private render target of {% bw_nav_rail %}
               (load brickwork_nav): call the tag, never include this
               partial. Items arrive prepared (URL resolved via
               safe_reverse per BR-BW-NAV-003, active/ancestor state
               computed, visibility filtered upstream), so this template is
               pure presentation.
  Landmark     Emits a <ul> only, never a <nav>: callers place the tag
               inside a labelled <nav> landmark. The app shell's sidebar
               block and regions {% block rail %} already sit inside one.
  Pairing      layout="sidebar" (default): wrap the rail and the contextual
               {% bw_nav %} in a .bw-nav-two-tier container inside
               {% block sidebar %}; widen --bw-density-sidebar-width in your
               brand CSS to seat both tiers. layout="regions" (brickwork#700):
               put {% bw_nav_rail %} in {% block rail %} and {% bw_nav %} in
               {% block sidebar %} as sibling shell regions under a full-width
               topbar. In the mobile drawer, render the full tree through a
               plain {% bw_nav %} (the drawer keeps the no-JS floor fully
               navigable, NAV-016/BR-BW-HTMX-001).
  Density      "labelled" (default): caption-size labels stay VISIBLE, a
               designed compact state, not the collapsed sidebar's clipped
               labels (SHL-004). "icons" (brickwork#701): resting state is
               icon-only at --bw-density-rail-width; hover/focus-within
               expands to --bw-density-rail-width-expanded and reveals
               labels. Labels stay in the accessibility tree (clip technique)
               so the no-JS floor remains fully named without hover.
  Link items   Every navigable rail entry is a REAL link (never a JS-only
               navigate trigger). Flat by design: a section header
               contributes its children as rail entries and its own label is
               not rendered; a link item's own children are NOT rendered here
               (they belong to the contextual second tier / mobile tree).
  Menu trigger menu_trigger=True items render as
               <button type="button" aria-haspopup="menu" aria-expanded="false">
               (brickwork#702). The flyout panel is consumer-owned; wire
               aria-expanded and the panel against this button. Children of a
               trigger are not rendered in the rail: surface them via
               {% bw_nav %} in the mobile drawer (or as the contextual tier)
               for the no-JS floor.
  A11y         Link entries: real anchors, fully navigable with no JS. The
               exact active item carries aria-current="page"; an active
               ancestor gets the visual treatment only. Disabled fallback
               items (BRICKWORK_NAV_FALLBACK="disabled") render as
               aria-disabled spans. Icons are decorative: the visible (or
               clipped) label is the accessible name. External links keep the
               external glyph and new-tab affordance. Menu triggers: button
               with aria-haspopup/aria-expanded; consumer owns the panel.
{% endcomment %}

{% partialdef nav_rail_item %}
  {% comment %} `item` is a RenderedNavItem. {% endcomment %}
  {% if item.is_section_header %}
    {% for item in item.children %}{% partial nav_rail_item %}{% endfor %}
  {% else %}
    <li class="bw-nav-rail__item">
      {% if item.is_menu_trigger %}
        <button type="button"
                class="bw-nav-rail__link bw-nav-rail__trigger{% if item.is_active %} bw-nav-rail__link--active{% endif %}{% if item.is_active_ancestor %} bw-nav-rail__link--active-ancestor{% endif %}"
                aria-haspopup="menu"
                aria-expanded="false"
                data-bw-nav-menu-trigger="{{ item.key }}">
          {% if item.icon %}{% bw_icon item.icon decorative=True css_class="bw-nav-rail__icon" %}{% endif %}
          <span class="bw-nav-rail__label">{{ item.label }}</span>
          {% if item.badge is not None %}<span class="bw-nav-rail__badge">{{ item.badge }}</span>{% endif %}
        </button>
      {% elif item.is_disabled %}
        <span class="bw-nav-rail__link bw-nav-rail__link--disabled" aria-disabled="true">
          {% if item.icon %}{% bw_icon item.icon decorative=True css_class="bw-nav-rail__icon" %}{% endif %}
          <span class="bw-nav-rail__label">{{ item.label }}</span>
        </span>
      {% else %}
        <a class="bw-nav-rail__link{% if item.is_active %} bw-nav-rail__link--active{% endif %}{% if item.is_active_ancestor %} bw-nav-rail__link--active-ancestor{% endif %}"
           href="{{ item.href|default:'#' }}"
           {% if item.is_active %}aria-current="page"{% endif %}
           {% if item.opens_in_new_tab %}target="_blank" rel="noopener noreferrer"{% endif %}>
          {% if item.icon %}{% bw_icon item.icon decorative=True css_class="bw-nav-rail__icon" %}{% endif %}
          <span class="bw-nav-rail__label">{{ item.label }}</span>
          {% if item.is_external %}{% bw_icon "external-link" size="sm" decorative=True css_class="bw-nav-rail__external" %}{% endif %}
          {% if item.badge is not None %}<span class="bw-nav-rail__badge">{{ item.badge }}</span>{% endif %}
        </a>
      {% endif %}
    </li>
  {% endif %}
{% endpartialdef %}

<ul class="bw-nav-rail__list{% if density == 'icons' %} bw-nav-rail__list--icons{% endif %}" role="list">
  {% for item in bw_nav_tree %}{% partial nav_rail_item %}{% endfor %}
</ul>