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

    Boosted links use hx-select="#page-content" so full-page GET responses only
    swap the page content inside #main (avoids nesting a second 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)

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

    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
-#}

{% def sidebar(cls="") %}
<nav class="chirpui-sidebar{{ " " ~ cls if cls else "" }}">
    <div class="chirpui-sidebar__header">{% slot header %}</div>
    <div class="chirpui-sidebar__nav">
        {% slot %}
    </div>
    <div class="chirpui-sidebar__footer">{% slot footer %}</div>
</nav>
{% end %}

{% def sidebar_section(title="", collapsible=false, cls="") %}
{% if collapsible %}
<details class="chirpui-sidebar__section{{ " " ~ cls if cls else "" }}" open>
    <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="") %}
{% set _cp = 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) %}
<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 boost %}
   hx-boost="true"
   hx-target="#main"
   hx-swap="innerHTML"
   hx-select="#page-content"
   {% end %}>{% if icon %}<span class="chirpui-sidebar__icon">{{ icon | icon }}</span>{% end %}<span class="chirpui-sidebar__label">{{ label }}</span></a>
{% end %}

{# Topbar brand — same HTMX contract as sidebar_link (full-page GET + select #page-content). #}
{% def shell_brand_link(href="/", cls="", boost=true) %}
<a href="{{ href }}" class="chirpui-app-shell__brand{{ " " ~ cls if cls else "" }}"
   {% if boost %}
   hx-boost="true"
   hx-target="#main"
   hx-swap="innerHTML"
   hx-select="#page-content"
   {% end %}
>{% slot %}</a>
{% end %}

{# In-page boosted nav (buttons, evolution links) — same contract; slot for HTML labels. #}
{% def shell_boosted_link(href, cls="", boost=true) %}
<a href="{{ href }}"{% if cls %} class="{{ cls }}"{% end %}
   {% if boost %}
   hx-boost="true"
   hx-target="#main"
   hx-swap="innerHTML"
   hx-select="#page-content"
   {% 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 %}