{#- chirp-ui: Nav tree component
    Hierarchical navigation for docs sidebar, admin nav, settings tree.
    Data-in: items = [{title, href?, children?, active?, open?, badge?, muted?}].
    Default branch_mode="disclosure" uses native <details> for expand/collapse.
    branch_mode="linked" renders branch parents as direct links and only renders
    children when open=true, for server-controlled section trees.
    Item hint="..." renders a reusable tooltip wrapper around that item's trigger.

    Named slot: header (version selector, search, etc.).

    Usage:
        from "chirpui/nav_tree.html" import nav_tree

        call nav_tree(items=items, show_icons=false)
            slot header: version selector, search
        end
-#}
{% from "chirpui/tooltip.html" import tooltip %}

{% def nav_tree_item_content(item, show_icons=false) %}
{% if show_icons and item.get("icon") %}
<span class="chirpui-nav-tree__icon">{{ item.icon | icon }}</span>
{% end %}
<span class="chirpui-nav-tree__title">{{ item.title | default("") }}</span>
{% if item.get("badge") is not none %}
<span class="chirpui-nav-tree__badge">{{ item.get("badge") }}</span>
{% end %}
{% end %}

{% def nav_tree_link_anchor(item, show_icons=false, leaf=false) %}
{% set active_class = " chirpui-nav-tree__link--active" if item.get("active") else "" %}
{% set leaf_class = " chirpui-nav-tree__link--leaf" if leaf else "" %}
<a href="{{ item.href }}" class="chirpui-nav-tree__link{{ leaf_class }}{{ active_class }}"{% if item.get("active") %} aria-current="page"{% end %}{{ route_link_attrs(item.href) | html_attrs }}>{{ nav_tree_item_content(item, show_icons) }}</a>
{% end %}

{% def nav_tree_link(item, show_icons=false, leaf=false, block_hint=true) %}
{% if item.get("hint") %}
{% call tooltip(item.hint, position=item.get("hint_position") or "right", block=block_hint, cls="chirpui-nav-tree__hint") %}
{{ nav_tree_link_anchor(item, show_icons, leaf) }}
{% end %}
{% else %}
{{ nav_tree_link_anchor(item, show_icons, leaf) }}
{% end %}
{% end %}

{% def nav_tree_text_span(item, show_icons=false, leaf=false) %}
{% set leaf_class = " chirpui-nav-tree__text--leaf" if leaf else "" %}
<span class="chirpui-nav-tree__text{{ " " ~ leaf_class if leaf_class else "" }}">{{ nav_tree_item_content(item, show_icons) }}</span>
{% end %}

{% def nav_tree_text(item, show_icons=false, leaf=false, block_hint=true) %}
{% if item.get("hint") %}
{% call tooltip(item.hint, position=item.get("hint_position") or "right", block=block_hint, cls="chirpui-nav-tree__hint") %}
{{ nav_tree_text_span(item, show_icons, leaf) }}
{% end %}
{% else %}
{{ nav_tree_text_span(item, show_icons, leaf) }}
{% end %}
{% end %}

{% def nav_tree(items, show_icons=false, branch_mode="disclosure", cls="") %}
<nav class="chirpui-nav-tree{% if branch_mode == "linked" %} chirpui-nav-tree--linked-branches{% end %}{{ " " ~ cls if cls else "" }}" aria-label="Navigation">
    <div class="chirpui-nav-tree__header">{% slot header %}</div>
    <ul class="chirpui-nav-tree__list">
        {% for item in items %}
        <li class="chirpui-nav-tree__item{% if item.get("active") %} chirpui-nav-tree__item--active{% end %}{% if item.get("children") %} chirpui-nav-tree__item--branch{% end %}{% if item.get("open") %} chirpui-nav-tree__item--open{% end %}{% if item.get("muted") %} chirpui-nav-tree__item--muted{% end %}">
            {% if item.get("children") %}
            {% if branch_mode == "linked" %}
            {% if item.get("href") %}
            {{ nav_tree_link(item, show_icons) }}
            {% else %}
            {{ nav_tree_text(item, show_icons) }}
            {% end %}
            {% if item.get("open") %}
            {{ nav_tree_items(item.children, show_icons, branch_mode=branch_mode) }}
            {% end %}
            {% else %}
            <details class="chirpui-nav-tree__node"{% if item.get("active") or item.get("open") %} open{% end %}>
                <summary class="chirpui-nav-tree__label">
                    {% if item.get("href") %}
                    {{ nav_tree_link(item, show_icons, block_hint=false) }}
                    {% else %}
                    {{ nav_tree_text(item, show_icons, block_hint=false) }}
                    {% end %}
                </summary>
                {{ nav_tree_items(item.children, show_icons, branch_mode=branch_mode) }}
            </details>
            {% end %}
            {% else %}
            {% if item.get("href") %}
            {{ nav_tree_link(item, show_icons, leaf=true) }}
            {% else %}
            {{ nav_tree_text(item, show_icons, leaf=true) }}
            {% end %}
            {% end %}
        </li>
        {% end %}
    </ul>
</nav>
{% end %}

{% def nav_tree_items(items, show_icons, branch_mode="disclosure") %}
<ul class="chirpui-nav-tree__list chirpui-nav-tree__list--nested">
    {% for item in items %}
    <li class="chirpui-nav-tree__item chirpui-nav-tree__item--child{% if item.get("active") %} chirpui-nav-tree__item--active{% end %}{% if item.get("children") %} chirpui-nav-tree__item--branch{% end %}{% if item.get("open") %} chirpui-nav-tree__item--open{% end %}{% if item.get("muted") %} chirpui-nav-tree__item--muted{% end %}">
        {% if item.get("children") %}
        {% if branch_mode == "linked" %}
        {% if item.get("href") %}
        {{ nav_tree_link(item, show_icons) }}
        {% else %}
        {{ nav_tree_text(item, show_icons) }}
        {% end %}
        {% if item.get("open") %}
        {{ nav_tree_items(item.children, show_icons, branch_mode=branch_mode) }}
        {% end %}
        {% else %}
        <details class="chirpui-nav-tree__node"{% if item.get("active") or item.get("open") %} open{% end %}>
            <summary class="chirpui-nav-tree__label">
                {% if item.get("href") %}
                {{ nav_tree_link(item, show_icons, block_hint=false) }}
                {% else %}
                {{ nav_tree_text(item, show_icons, block_hint=false) }}
                {% end %}
            </summary>
            {{ nav_tree_items(item.children, show_icons, branch_mode=branch_mode) }}
        </details>
        {% end %}
        {% else %}
        {% if item.get("href") %}
        {{ nav_tree_link(item, show_icons, leaf=true) }}
        {% else %}
        {{ nav_tree_text(item, show_icons, leaf=true) }}
        {% end %}
        {% end %}
    </li>
    {% end %}
</ul>
{% end %}