{#- chirp-ui: Sidebar component
    Vertical sidebar navigation for dashboards and admin panels.

    Boosted links use the shell outlet contract: target #main, swap innerHTML,
    and select #page-content so full-page GET responses only replace the page
    outlet inside the persistent shell.

    Active state: use match= for automatic path comparison (requires current_path
    in template context), or active= for explicit control.

    match="exact"  — active when current_path == href
    match="prefix" — active when current_path starts with href (or equals it)
    active=true    — always active (explicit override)

    Badge state: badge_label gives a richer accessible label for visible counts.
    badge_expected reserves count space, and badge_loading renders a pending
    count without layout shift.

    Named slots: header, footer, default (nav content).

    aria_label: static accessible name for the <nav> landmark. Set this when a
    page has more than one navigation landmark so each has a unique name
    (axe-core landmark-unique). Default "" omits the attribute (back-compat).

    Usage:
        from "chirpui/sidebar.html" import sidebar, sidebar_link, sidebar_section,
        shell_brand_link, shell_boosted_link

        call sidebar()
            {% slot header %}<div class="chirpui-sidebar__brand">My App</div>{% end %}
            call sidebar_section("Main")
                sidebar_link("/", "Home", match="exact")
                sidebar_link("/dashboard", "Dashboard", match="prefix")
                sidebar_link("/admin", "Admin", active=is_admin)
            end
            {% slot footer %}<span>v1.0</span>{% end %}
        end
-#}
{% from "chirpui/shell_frame.html" import shell_outlet_attrs %}

{% def sidebar(cls="", current_path="", aria_label="", sliding_pill=false) %}
{# @provides _nav_current_path — consumed by: sidebar_link #}
{% provide _nav_current_path = current_path %}
{% set _responsive_dropdowns = cls and "chirpui-sidebar--responsive-dropdowns" in cls %}
<nav class="chirpui-sidebar{{ " " ~ cls if cls else "" }}"{% if aria_label %} aria-label="{{ aria_label }}"{% end %}
     {% if _responsive_dropdowns %}x-data="chirpuiResponsiveSidebar()" x-init="init()" @keydown.escape.window="closeMenus()" @click.outside="closeMenus()"{% end %}>
    <div class="chirpui-sidebar__header">{% slot header %}</div>
    <div class="chirpui-sidebar__nav{% if sliding_pill %} chirpui-sidebar__nav--sliding-pill{% end %}"
         {% if sliding_pill %}data-chirpui-sliding-pill="rail"{% endif %}>
        {% if sliding_pill %}<span class="chirpui-nav-pill" aria-hidden="true"></span>{% endif %}
        {% slot %}
    </div>
    <div class="chirpui-sidebar__footer">{% slot footer %}</div>
</nav>
{% end %}
{% end %}

{% def sidebar_section(title="", collapsible=false, cls="", open=true) %}
{% if collapsible %}
<details class="chirpui-sidebar__section{{ " " ~ cls if cls else "" }}"{% if open %} open{% end %}>
    <summary class="chirpui-sidebar__section-title">{{ title }}</summary>
    <div class="chirpui-sidebar__section-links">{% slot %}</div>
</details>
{% else %}
<div class="chirpui-sidebar__section{{ " " ~ cls if cls else "" }}">
    {% if title %}<span class="chirpui-sidebar__section-title">{{ title }}</span>{% end %}
    <div class="chirpui-sidebar__section-links">{% slot %}</div>
</div>
{% end %}
{% end %}

{% def sidebar_link(href, label, icon="", active=false, match="", boost=true, cls="", badge=none, badge_label=none, badge_expected=false, badge_loading=false) %}
{# @consumes _nav_current_path from: sidebar — falls back to "" #}
{% set _cp = (consume("_nav_current_path", "") or (current_path | default(""))) if match else "" %}
{% set _active = active if not match else ((_cp == href) if match == "exact" else (_cp == href or _cp.startswith(href ~ "/")) if match == "prefix" else active) %}
{% set _badge_expected = badge_expected or badge_loading %}
<a class="chirpui-sidebar__link{{ " chirpui-sidebar__link--active" if _active else "" }}{{ " " ~ cls if cls else "" }}"
   href="{{ href }}" title="{{ label }}"
   {% if _active %}aria-current="page"{% end %}
   {% if match %} data-chirpui-shell-match="{{ match }}"{% end %}
   {% if boost %}{{ shell_outlet_attrs() }}{% end %}>{% if icon %}<span class="chirpui-sidebar__icon">{{ icon | icon }}</span>{% end %}<span class="chirpui-sidebar__label">{{ label }}</span>{% if badge is not none or _badge_expected %}<span class="chirpui-sidebar__badge{% if badge is none %} chirpui-sidebar__badge--reserved{% end %}{% if badge_loading %} chirpui-sidebar__badge--loading{% end %}"{% if badge_label and badge is not none %} aria-label="{{ badge_label }}"{% elif badge is none %} aria-hidden="true"{% end %}>{% if badge is not none %}{{ badge }}{% end %}</span>{% end %}</a>
{% end %}

{# Topbar brand — same shell outlet contract as sidebar_link. #}
{# Do not use inside app_shell brand_slot: app_shell already wraps the slot in one <a>. #}
{% def shell_brand_link(href="/", cls="", boost=true) %}
<a href="{{ href }}" class="chirpui-app-shell__brand{{ " " ~ cls if cls else "" }}"
   {{ route_link_attrs(
       href,
       boost=boost,
       fallback=build_hx_attrs(hx_boost="true", hx_target="#main", hx_swap="innerHTML", hx_select="#page-content")
   ) | html_attrs }}
>{% slot %}</a>
{% end %}

{# In-page boosted nav (buttons, evolution links) — same shell outlet contract. #}
{% def shell_boosted_link(href, cls="", boost=true) %}
<a href="{{ href }}"{% if cls %} class="{{ cls }}"{% end %}
   {% if boost %}{{ shell_outlet_attrs() }}{% end %}
>{% slot %}</a>
{% end %}

{% def sidebar_toggle(cls="") %}
<button type="button" class="chirpui-sidebar-toggle{{ " " ~ cls if cls else "" }}"
        aria-label="Toggle sidebar" :aria-expanded="!collapsed"
        @click="toggle()">
  <span class="chirpui-sidebar-toggle__icon">◀</span>
</button>
{% end %}