{#- chirp-ui: Navbar component
    Top navigation bar with brand and links.

    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 (Kida 0.3+, use_slots=true): default (links), end (right-aligned),
    brand (brand area, when brand_slot=true).

    aria_label: static accessible name for the <nav> landmark. Pass a unique
    name (e.g. "Primary") when the page has multiple navigation landmarks so
    each is distinct (axe-core landmark-unique). Default "" omits the attribute.

    Usage:
        from "chirpui/navbar.html" import navbar, navbar_link, navbar_end, navbar_dropdown

        call navbar(brand="My App", brand_url="/", use_slots=true)
            navbar_link("/docs", "Docs", match="prefix")
            navbar_link("/about", "About", match="exact")
            {% slot end %}btn("Login", href="/login"){% end %}
        end

        call navbar(brand_url="/", use_slots=true, brand_slot=true)
            {% slot brand %}logo(text="My App", image_src="/static/logo.svg", variant="both"){% end %}
            navbar_link("/docs", "Docs", match="prefix")
        end

    Legacy: wrap right-aligned content in navbar_end(). Add cls="chirpui-navbar--sticky" for sticky nav.
-#}

{% def navbar(brand=none, brand_url="/", cls="", use_slots=false, brand_slot=false, current_path="", aria_label="") %}
{# @provides _nav_current_path — consumed by: navbar_link, navbar_dropdown #}
{% provide _nav_current_path = current_path %}
<nav class="chirpui-navbar{{ " " ~ cls if cls else "" }}"{% if aria_label %} aria-label="{{ aria_label }}"{% end %}>
    {% if brand or brand_slot %}
    <a class="chirpui-navbar__brand" href="{{ brand_url }}"{{ route_link_attrs(brand_url) | html_attrs }}>
        {% if brand_slot %}
        {% slot brand %}
        {% else %}
        {{ brand }}
        {% end %}
    </a>
    {% end %}
    {% if use_slots %}
    <div class="chirpui-navbar__links">{% slot %}</div>
    <div class="chirpui-navbar__links chirpui-navbar__links--end">{% slot end %}</div>
    {% else %}
    <div class="chirpui-navbar__links">
        {% slot %}
    </div>
    {% end %}
</nav>
{% end %}
{% end %}

{% def navbar_link(href, label, active=false, match="", cls="") %}
{# @consumes _nav_current_path from: navbar — 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) %}
<a class="chirpui-navbar__link{{ " chirpui-navbar__link--active" if _active else "" }}{{ " " ~ cls if cls else "" }}"
   href="{{ href }}"{% if _active %} aria-current="page"{% end %}{% if match %} data-chirpui-shell-match="{{ match }}"{% end %}{{ route_link_attrs(href) | html_attrs }}>{{ label }}</a>
{% end %}

{% def navbar_end(cls="") %}
<div class="chirpui-navbar__links chirpui-navbar__links--end{{ " " ~ cls if cls else "" }}">
    {% slot %}
</div>
{% end %}

{% def navbar_dropdown(label, active=false, match="", href="", cls="") %}
{# @consumes _nav_current_path from: navbar — 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) %}
<details class="chirpui-navbar-dropdown{{ " " ~ cls if cls else "" }}">
    <summary class="chirpui-navbar-dropdown__trigger chirpui-navbar__link{{ " chirpui-navbar__link--active" if _active else "" }}">{{ label }}</summary>
    <div class="chirpui-navbar-dropdown__menu chirpui-dropdown__menu">
        {% slot %}
    </div>
</details>
{% end %}