{#
Documentation navigation.

The primary icon rail mirrors the top-level `main` menu (Home + top bar
sections). The secondary panel shows the active section's children from that
menu, or the scoped documentation tree on /docs/ and /api/ pages.
#}

{% from 'chirpui/sidebar.html' import sidebar %}
{% from 'chirpui/workspace_primitives.html' import filter_rail %}
{% from 'partials/nav-icons.html' import section_icon_name %}

{% def catalog_mark(title, href, index, icon_name=none) %}
{% let _name = (icon_name ?? (section_icon_name(title, href) | trim)) | trim %}
{% if _name %}
{{ icon(_name, size=18) }}
{% else %}
<span>{{ index }}</span>
{% end %}
{% end %}

{% def menu_rail_href(item) %}
{% let item_href = item?.href ?? item?.url ?? '#' %}
{% let item_children = item?.children ?? [] %}
{% let item_identifier = item?.identifier ?? '' %}
{% if item_href in ['#', '#dev'] and item_identifier == 'layouts' %}
/layouts/
{% elif item_href in ['#', '#dev'] and item_identifier == 'dev' %}
/dev/
{% elif item_href == '#' and item_children | length > 0 %}
{{ (item_children[0]?.href ?? item_children[0]?.url ?? item_href) | trim }}
{% elif item_href == '#dev' %}
{% let resolved = item_href %}
{% for child in item_children %}
{% let child_href = child?.href ?? child?.url ?? '#' %}
{% if child_href != '#' and not (child_href.startswith('http://') or child_href.startswith('https://')) %}
{% let resolved = child_href %}
{% end %}
{% end %}
{% if resolved == '#dev' and item_children | length > 0 %}
{{ (item_children[0]?.href ?? item_children[0]?.url ?? resolved) | trim }}
{% else %}
{{ resolved | trim }}
{% end %}
{% else %}
{{ item_href | trim }}
{% end %}
{% end %}

{% def menu_nav_leaf(child) %}
{% let child_title = child?.name ?? child?.title ?? 'Untitled' %}
{% let child_href = child?.href ?? child?.url ?? '#' %}
{% let child_current = current_path == child_href %}
{% let child_active = child_href != '#' and (child_current or (child_href != '/' and current_path.startswith(child_href))) %}
{% let child_icon = child?.icon ?? (section_icon_name(child_title, child_href) | trim) %}
<a class="chirpui-sidebar__link chirp-theme-docs-nav__link chirp-theme-docs-nav__leaf-link chirp-theme-docs-nav__menu-leaf{{ ' chirpui-sidebar__link--active' if child_active else '' }}"
   href="{{ child_href | absolute_url }}"
   title="{{ child_title }}"
   {% if child_current %}aria-current="page"{% end %}{{ route_link_attrs(child_href | absolute_url) | html_attrs }}>
  <span class="chirpui-sidebar__icon chirp-theme-docs-nav__type-icon" aria-hidden="true">
  {% if child_icon %}{{ icon(child_icon, size=14) }}{% else %}{{ icon('article', size=14) }}{% end %}
  </span>
  <span class="chirpui-sidebar__label chirp-theme-docs-nav__label">{{ child_title }}</span>
</a>
{% end %}

{% def nav_type_icon(kind, branch=false) %}
{% if branch %}
{{ icon('folder', size=14) }}
{% elif kind == 'api' %}
{{ icon('file-code', size=14) }}
{% else %}
{{ icon('article', size=14) }}
{% end %}
{% end %}

{% def nav_node(item, depth=0) %}
{% let item_title = item?.title ?? 'Untitled' %}
{% let item_href = item?.href ?? '' %}
{% let item_children = item?.children ?? [] %}
{% let is_current = item?.is_current ?? false %}
{% let is_branch_active = is_current or (item?.is_in_trail ?? false) or (item?.is_expanded ?? false) %}
{% let has_children = item_children | length > 0 %}
{% let item_key = (item_title ~ ' ' ~ item_href) | lower %}
{% let item_kind = 'component' if 'component' in item_key else ('release' if 'release' in item_key else ('api' if ('api' in item_key or 'reference' in item_key) else ('pattern' if 'pattern' in item_key else ('guide' if ('guide' in item_key or 'doc' in item_key or 'start' in item_key or 'install' in item_key or 'theme' in item_key) else 'page')))) %}

{% if has_children %}
  {% if depth > 0 %}
  {% let section_slug = (item_href if item_href else (item_title | lower)) | replace('/', '-') | replace(' ', '-') | replace('.', '-') | trim('-') %}
  {% let section_id = 'docs-nav-sect-' ~ section_slug %}
  <div class="chirpui-sidebar__section chirp-theme-docs-nav__section chirp-theme-docs-nav__section--has-toggle chirp-theme-docs-nav__section--depth-{{ depth }}{{ ' is-active' if is_branch_active else '' }}">
    <div class="chirp-theme-docs-nav__section-header">
      <button type="button"
              class="chirp-theme-docs-nav__toggle"
              aria-expanded="{{ 'true' if is_branch_active else 'false' }}"
              aria-controls="{{ section_id }}"
              aria-label="Toggle {{ item_title }} section">
        <span class="chirp-theme-docs-nav__disclosure" aria-hidden="true">
          <span class="chirp-theme-docs-nav__folder chirp-theme-docs-nav__folder--closed">{{ icon('folder', size=14) }}</span>
          <span class="chirp-theme-docs-nav__folder chirp-theme-docs-nav__folder--open">{{ icon('folder-open', size=14) }}</span>
        </span>
      </button>
      {% if item_href %}
      <a class="chirp-theme-docs-nav__summary-link chirp-theme-docs-nav__link--{{ item_kind }}{{ ' chirp-theme-docs-nav__summary-link--active' if is_current else '' }}"
         href="{{ item_href | absolute_url }}"
         title="{{ item_title }}"
         {% if is_current %}aria-current="page"{% end %}{{ route_link_attrs(item_href | absolute_url) | html_attrs }}>
        <span class="chirp-theme-docs-nav__summary-copy">
          <span class="chirpui-sidebar__label chirp-theme-docs-nav__label">{{ item_title }}</span>
        </span>
      </a>
      {% else %}
      <span class="chirp-theme-docs-nav__summary-link chirp-theme-docs-nav__link--{{ item_kind }}">
        <span class="chirp-theme-docs-nav__summary-copy">
          <span class="chirpui-sidebar__label chirp-theme-docs-nav__label">{{ item_title }}</span>
        </span>
      </span>
      {% end %}
    </div>
    <div class="chirpui-sidebar__section-links chirp-theme-docs-nav__section-links" id="{{ section_id }}">
      {% for child in item_children %}
      {{ nav_node(child, depth + 1) }}
      {% end %}
    </div>
  </div>
  {% else %}
  <div class="chirpui-sidebar__section chirp-theme-docs-nav__section chirp-theme-docs-nav__section--depth-{{ depth }}{{ ' is-active' if is_branch_active else '' }}">
    {% if item_href %}
    <a class="chirpui-sidebar__section-title chirp-theme-docs-nav__summary-link chirp-theme-docs-nav__link--{{ item_kind }}{{ ' chirp-theme-docs-nav__summary-link--active' if is_current else '' }}"
       href="{{ item_href | absolute_url }}"
       title="{{ item_title }}"
       {% if is_current %}aria-current="page"{% end %}{{ route_link_attrs(item_href | absolute_url) | html_attrs }}>
      <span class="chirpui-sidebar__icon chirp-theme-docs-nav__type-icon" aria-hidden="true">{{ nav_type_icon(item_kind, true) }}</span>
      <span class="chirp-theme-docs-nav__summary-copy">
        <span class="chirpui-sidebar__label chirp-theme-docs-nav__label">{{ item_title }}</span>
      </span>
    </a>
    {% else %}
    <span class="chirpui-sidebar__section-title chirp-theme-docs-nav__summary-link chirp-theme-docs-nav__link--{{ item_kind }}">
      <span class="chirpui-sidebar__icon chirp-theme-docs-nav__type-icon" aria-hidden="true">{{ nav_type_icon(item_kind, true) }}</span>
      <span class="chirp-theme-docs-nav__summary-copy">
        <span class="chirpui-sidebar__label chirp-theme-docs-nav__label">{{ item_title }}</span>
      </span>
    </span>
    {% end %}
    <div class="chirpui-sidebar__section-links chirp-theme-docs-nav__section-links">
    {% for child in item_children %}
    {{ nav_node(child, depth + 1) }}
    {% end %}
    </div>
  </div>
  {% end %}
{% else %}
  {% if item_href %}
  <a class="chirpui-sidebar__link chirp-theme-docs-nav__link chirp-theme-docs-nav__leaf-link{{ ' chirp-theme-docs-nav__root-leaf' if depth == 1 else '' }} chirp-theme-docs-nav__link--{{ item_kind }}{{ ' chirpui-sidebar__link--active' if is_current else '' }}"
     href="{{ item_href | absolute_url }}"
     title="{{ item_title }}"
     {% if is_current %}aria-current="page"{% end %}>
    <span class="chirpui-sidebar__icon chirp-theme-docs-nav__type-icon" aria-hidden="true">{{ nav_type_icon(item_kind) }}</span>
    <span class="chirpui-sidebar__label chirp-theme-docs-nav__label">{{ item_title }}</span>
  </a>
  {% else %}
  <span class="chirpui-sidebar__link chirp-theme-docs-nav__link chirp-theme-docs-nav__leaf-link{{ ' chirp-theme-docs-nav__root-leaf' if depth == 1 else '' }} chirp-theme-docs-nav__link--{{ item_kind }}">
    <span class="chirpui-sidebar__icon chirp-theme-docs-nav__type-icon" aria-hidden="true">{{ nav_type_icon(item_kind) }}</span>
    <span class="chirpui-sidebar__label chirp-theme-docs-nav__label">{{ item_title }}</span>
  </span>
  {% end %}
{% end %}
{% end %}

{% let nav_page = page ?? none %}
{% let is_autodoc = is_autodoc_page(nav_page) if (is_autodoc_page is defined and nav_page) else false %}
{% let page_section = nav_page?._section %}
{% let root_section = page_section?.root ?? none %}
{% let current_path = catalog_current_path ?? nav_page?._path ?? nav_page?.href ?? '' %}
{% let rail_items = get_menu_lang("main", _current_lang ?? current_lang()) ?? [] %}
{% let use_doc_tree = nav_page and (current_path.startswith('/docs/') or current_path == '/docs/' or current_path.startswith('/api/') or current_path == '/api/') and root_section %}
{% let in_layouts_section = current_path.startswith('/layouts/') or current_path == '/layouts/' or current_path.startswith('/blog/') or current_path == '/blog/' or current_path.startswith('/tutorial/') or current_path == '/tutorial/' or current_path.startswith('/tracks/') or current_path == '/tracks/' or current_path.startswith('/resume/') or current_path == '/resume/' or current_path.startswith('/notebook/') or current_path == '/notebook/' or current_path.startswith('/authors/') or current_path == '/authors/' or current_path.startswith('/changelog/') or current_path == '/changelog/' %}
{% let in_dev_section = current_path.startswith('/dev/') or current_path == '/dev/' or current_path.startswith('/api/') or current_path == '/api/' %}
{% let in_releases_section = current_path.startswith('/releases/') or current_path == '/releases/' %}

<div class="chirp-theme-doc-catalog" data-chirp-theme-doc-nav="catalog" data-bengal="docs-nav">
  {% if rail_items | length > 0 %}
  <div class="chirp-theme-doc-catalog__primary">
    {% let rail_label = 'Documentation catalog' if use_doc_tree else 'Site navigation' %}
    {% call filter_rail(label=rail_label, cls='chirp-theme-doc-catalog-rail') %}
      <div class="chirp-theme-doc-catalog-rail__group chirp-theme-doc-catalog-rail__group--home">
        <a class="chirpui-filter-rail__item chirp-theme-doc-catalog-rail__item chirp-theme-doc-catalog-rail__home{{ ' is-active' if current_path == '/' else '' }}"
           href="{{ '/' | absolute_url }}"
           aria-label="Home"
           title="Home"
           data-chirpui-role="nav"
           data-chirpui-pressure="compress"
           data-chirpui-rhythm="group"{{ route_link_attrs('/' | absolute_url) | html_attrs }}>
          <span class="chirpui-filter-rail__mark chirp-theme-doc-catalog-rail__mark chirp-theme-doc-catalog-rail__brand-mark" aria-hidden="true">ᗢ</span>
          <span class="chirpui-filter-rail__body">
            <strong class="chirpui-filter-rail__label chirp-theme-doc-catalog-rail__label">Home</strong>
          </span>
        </a>
      </div>

      <div class="chirp-theme-doc-catalog-rail__group chirp-theme-doc-catalog-rail__group--sections">
      {% for item in rail_items %}
      {% let item_title = item?.name ?? item?.title ?? 'Untitled' %}
      {% let item_href = menu_rail_href(item) | trim %}
      {% let item_icon = item?.icon ?? none %}
      {% let item_children = item?.children ?? [] %}
      {% set active_children = [] %}
      {% for child in item_children %}
      {% let child_href = child?.href ?? child?.url ?? '#' %}
      {% if child_href != '#' and (current_path == child_href or (child_href != '/' and current_path.startswith(child_href))) %}
      {% set _ = active_children.append(true) %}
      {% end %}
      {% end %}
      {% let is_active = (current_path == item_href) or (item_href != '/' and item_href != '#' and item_href != '#dev' and current_path.startswith(item_href)) or (active_children | length > 0) or (item_title == 'Layouts' and in_layouts_section) or (item_title == 'Dev' and in_dev_section) or (item_title == 'Documentation' and (current_path.startswith('/docs/') or current_path == '/docs/')) or (item_title == 'Releases' and in_releases_section) %}
      <a class="chirpui-filter-rail__item chirp-theme-doc-catalog-rail__item{{ ' is-active' if is_active else '' }}"
         href="{{ item_href | absolute_url }}"
         aria-label="{{ item_title }}"
         {% if current_path == item_href %}aria-current="page"{% end %}
         data-chirpui-role="nav"
         data-chirpui-pressure="compress"
         data-chirpui-rhythm="group"{{ route_link_attrs(item_href | absolute_url) | html_attrs }}>
        <span class="chirpui-filter-rail__mark chirp-theme-doc-catalog-rail__mark" aria-hidden="true">{{ catalog_mark(item_title, item_href, loop.index, icon_name=item_icon) }}</span>
        <span class="chirpui-filter-rail__body">
          <strong class="chirpui-filter-rail__label chirp-theme-doc-catalog-rail__label">{{ item_title }}</strong>
        </span>
      </a>
      {% end %}
      </div>

      <div class="chirp-theme-doc-catalog-rail__group chirp-theme-doc-catalog-rail__group--actions" aria-label="Global actions">
        {% with config.search.ui as ui %}
        {% if ui.modal ?? false %}
        <button type="button"
                class="chirpui-filter-rail__item chirp-theme-doc-catalog-rail__item chirp-theme-doc-catalog-rail__button nav-search-trigger"
                title="Search (⌘K)"
                aria-label="Search">
          <span class="chirpui-filter-rail__mark chirp-theme-doc-catalog-rail__mark" aria-hidden="true">{{ icon('magnifying-glass', size=18) }}</span>
          <span class="chirpui-filter-rail__body">
            <strong class="chirpui-filter-rail__label chirp-theme-doc-catalog-rail__label">Search</strong>
          </span>
        </button>
        {% else %}
        <a class="chirpui-filter-rail__item chirp-theme-doc-catalog-rail__item nav-search-trigger"
           href="{{ '/search/' | absolute_url }}"
           title="Search"
           aria-label="Search">
          <span class="chirpui-filter-rail__mark chirp-theme-doc-catalog-rail__mark" aria-hidden="true">{{ icon('magnifying-glass', size=18) }}</span>
          <span class="chirpui-filter-rail__body">
            <strong class="chirpui-filter-rail__label chirp-theme-doc-catalog-rail__label">Search</strong>
          </span>
        </a>
        {% end %}
        {% end %}
        <div class="chirp-theme-doc-catalog-rail__theme" title="Appearance">
          {% with theme_menu_id='theme-menu-rail' %}{% include 'partials/theme-controls.html' %}{% end %}
        </div>
      </div>
    {% end %}
  </div>
  {% end %}

  <div class="chirp-theme-doc-catalog__secondary" data-chirp-theme-doc-nav="sections">
  {% let sidebar_label = 'Documentation sections' if use_doc_tree else 'Section navigation' %}
  {% call sidebar(cls='chirp-theme-docs-nav', current_path=current_path, aria_label=sidebar_label) %}
    {% slot header %}
    {% if use_doc_tree and not is_autodoc %}
    {% include 'partials/version-selector.html' %}
    {% end %}
    {% end %}

    {% if use_doc_tree %}
    {% let nav_context = get_nav_context(nav_page, root_section=root_section) %}
    {% with nav_context?.root as root_item %}
    {{ nav_node(root_item, 0) }}
    {% end %}
    {% elif in_releases_section %}
    {% include 'partials/releases-nav.html' %}
    {% else %}
    {% for item in rail_items %}
    {% let item_href = item?.href ?? item?.url ?? '#' %}
    {% let item_children = item?.children ?? [] %}
    {% set active_children = [] %}
    {% for child in item_children %}
    {% let child_href = child?.href ?? child?.url ?? '#' %}
    {% if child_href != '#' and (current_path == child_href or (child_href != '/' and current_path.startswith(child_href))) %}
    {% set _ = active_children.append(true) %}
    {% end %}
    {% end %}
    {% let item_title = item?.name ?? item?.title ?? 'Untitled' %}
    {% let is_active = (current_path == item_href) or (item_href != '/' and item_href != '#' and item_href != '#dev' and current_path.startswith(item_href)) or (active_children | length > 0) or (item_title == 'Layouts' and in_layouts_section) or (item_title == 'Dev' and in_dev_section and not use_doc_tree) or (item_title == 'Documentation' and (current_path.startswith('/docs/') or current_path == '/docs/')) or (item_title == 'Releases' and in_releases_section) %}
    {% if is_active %}
    {% let section_children = item?.children ?? [] %}
    {% if section_children | length > 0 %}
    <div class="chirpui-sidebar__section-links chirp-theme-docs-nav__section-links chirp-theme-docs-nav__menu-section">
      {% for child in section_children %}
      {{ menu_nav_leaf(child) }}
      {% end %}
    </div>
    {% end %}
    {% end %}
    {% end %}
    {% end %}
  {% end %}
  </div>
</div>