{#
Bengal OpenAPI Home Page
========================

Bespoke REST API catalog shell. This page intentionally does not extend the
shared OpenAPI reference layout because the API landing experience is an
application surface, not a prose reference page.
#}
{% extends 'base.html' %}

{# Access metadata from section (set by section_builders.py) #}
{% let sec_meta = section?.metadata ?? {} %}
{% let api_title = section?.title ?? page?.title ?? 'API Reference' %}
{% let api_version = sec_meta?.version ?? '1.0.0' %}
{% let servers = sec_meta?.servers ?? () %}
{% let security_schemes = sec_meta?.security_schemes ?? {} %}
{% let tags = sec_meta?.tags ?? () %}
{% let description = sec_meta?.description ?? '' %}

{# Use filters for normalized access #}
{% let eps = section | endpoints %}
{% let schs = section | schemas %}

{% block site_footer %}{% end %}

{% block content %}
<div class="api-catalog-app" data-autodoc="openapi" data-element="home" data-bengal="api-catalog">
  {% let endpoint_count = eps | length %}
  {% let schema_count = schs | length %}
  {% let tag_count = tags | length %}
  {% let subsections = section?.subsections ?? () %}

  <header class="api-catalog-app__top">
    <div class="api-catalog-app__identity">
      <span class="api-catalog-app__eyebrow">REST API</span>
      <h1 class="api-catalog-app__title">{{ api_title }}</h1>
      {% if description %}
      <div class="api-catalog-app__description">
        {{ description | markdownify | safe }}
      </div>
      {% end %}
    </div>

    <div class="api-catalog-app__summary" aria-label="API summary">
      {% if api_version %}
      <span class="api-catalog-app__summary-item">
        <span>Version</span>
        <strong>v{{ api_version }}</strong>
      </span>
      {% end %}
      {% if endpoint_count > 0 %}
      <span class="api-catalog-app__summary-item">
        <span>Endpoints</span>
        <strong>{{ endpoint_count }}</strong>
      </span>
      {% end %}
      {% if tag_count > 0 %}
      <span class="api-catalog-app__summary-item">
        <span>Groups</span>
        <strong>{{ tag_count }}</strong>
      </span>
      {% end %}
      {% if schema_count > 0 %}
      <span class="api-catalog-app__summary-item">
        <span>Schemas</span>
        <strong>{{ schema_count }}</strong>
      </span>
      {% end %}
    </div>
  </header>

  <div class="api-catalog-app__workspace">
    <aside class="api-catalog-app__left-rail" aria-label="REST API navigation">
      {% if subsections | length > 0 %}
      <nav class="api-catalog-nav" aria-label="Endpoint groups" data-api-rail>
        <h2 class="api-catalog-nav__title">{{ icon('folder', size=14) }} Resources</h2>
        {% for subsec in subsections %}
        {% let tag_name = subsec?.title ?? 'Endpoints' %}
        {% let tag_endpoints = subsec | endpoints %}
        {% if tag_endpoints | length > 0 %}
        <a href="#{{ tag_name | slugify }}" class="api-catalog-nav__link">
          <span>{{ tag_name }}</span>
          <span>{{ tag_endpoints | length }}</span>
        </a>
        {% end %}
        {% end %}
      </nav>
      {% end %}

      {% if servers | length > 0 %}
      <section class="api-catalog-nav api-catalog-nav--servers">
        <h2 class="api-catalog-nav__title">{{ icon('server', size=14) }} Base URLs</h2>
        {% for server in servers %}
        {% let server_url = server if server is string else server?.url ?? server %}
        {% let server_desc = '' if server is string else server?.description ?? '' %}
        <div class="api-catalog-server">
          <code>{{ server_url }}</code>
          {% if server_desc %}
          <span>{{ server_desc }}</span>
          {% end %}
          <button data-copy="{{ server_url }}" aria-label="Copy URL">
            {{ icon('copy', size=14) }}
          </button>
        </div>
        {% end %}
      </section>
      {% end %}
    </aside>

    <section class="api-catalog-main" aria-label="Endpoint catalog">
      <header class="api-catalog-main__header">
        <div>
          <h2>Endpoint catalog</h2>
          <p>Open an endpoint for parameters, response models, examples, and generated request snippets.</p>
        </div>
        {% if endpoint_count > 4 %}
        <div class="api-catalog-filter">
          <input type="search" class="api-catalog-filter__input" data-api-filter-input
                 placeholder="Filter endpoints&hellip;" aria-label="Filter endpoints by method, path, or summary">
        </div>
        {% end %}
      </header>
      <p class="api-catalog-filter__empty" data-api-filter-empty hidden aria-live="polite">No endpoints match your filter.</p>

      {% if subsections | length > 0 %}
      <div class="api-catalog-groups">
        {% for subsec in subsections %}
        {% let tag_name = subsec?.title ?? 'Endpoints' %}
        {% let tag_desc = subsec?.metadata?.description ?? '' %}
        {% let tag_endpoints = subsec | endpoints %}
        {% let tag_href = section_href(subsec, page) %}

        {% if tag_endpoints | length > 0 %}
        <article class="api-catalog-group" id="{{ tag_name | slugify }}" data-api-filter-group>
          <header class="api-catalog-group__header">
            <div>
              <h3><a href="{{ tag_href }}">{{ tag_name }}</a></h3>
              {% if tag_desc %}
              <p>{{ tag_desc }}</p>
              {% end %}
            </div>
            <a href="{{ tag_href }}" class="api-catalog-group__open">
              Reference {{ icon('arrow-right', size=14) }}
            </a>
          </header>

          <div class="api-catalog-endpoints">
            {% for ep in tag_endpoints %}
            <a href="{{ ep.href }}" class="api-catalog-endpoint{% if ep.deprecated %} api-catalog-endpoint--deprecated{% end %}" data-api-filter-item data-method="{{ ep.method }}" data-path="{{ ep.path }}">
              <span class="api-method api-method--sm api-method--{{ ep.method |> lower }}">{{ ep.method }}</span>
              <code>{{ ep.path | highlight_path_params | safe }}</code>
              {% if ep.summary %}
              <span>{{ ep.summary }}</span>
              {% end %}
              {{ icon('arrow-right', size=14) }}
            </a>
            {% end %}
          </div>
        </article>
        {% end %}
        {% end %}
      </div>
      {% end %}

      {% if subsections | length == 0 and eps | length > 0 %}
      <div class="api-catalog-endpoints">
        {% for ep in eps %}
        <a href="{{ ep.href }}" class="api-catalog-endpoint{% if ep.deprecated %} api-catalog-endpoint--deprecated{% end %}" data-api-filter-item data-method="{{ ep.method }}" data-path="{{ ep.path }}">
          <span class="api-method api-method--sm api-method--{{ ep.method |> lower }}">{{ ep.method }}</span>
          <code>{{ ep.path | highlight_path_params | safe }}</code>
          {% if ep.summary %}
          <span>{{ ep.summary }}</span>
          {% end %}
          {{ icon('arrow-right', size=14) }}
        </a>
        {% end %}
      </div>
      {% end %}
    </section>

    <aside class="api-catalog-app__right-rail" aria-label="Reference metadata">
      {% if security_schemes | length > 0 %}
      <section class="api-catalog-panel">
        <h2>{{ icon('lock', size=14) }} Authentication</h2>
        <div class="api-catalog-auth-list">
          {% for name, scheme in security_schemes |> items %}
          {% if scheme %}
          {% let scheme_type = scheme?.type ?? 'apiKey' %}
          {% let scheme_name = scheme?.name ?? 'Authorization' %}
          <div class="api-catalog-auth">
            <span>{{ name }}</span>
            <span class="badge badge--outline badge--sm">{{ scheme_type }}</span>
            {% match scheme_type %}
            {% case 'apiKey' %}
            <code>{{ scheme_name }}: YOUR_API_KEY</code>
            {% case 'http' %}
            {% if scheme?.scheme == 'bearer' %}
            <code>Authorization: Bearer YOUR_TOKEN</code>
            {% else %}
            <code>Authorization: Basic BASE64_CREDENTIALS</code>
            {% end %}
            {% case 'oauth2' %}
            <code>Authorization: Bearer ACCESS_TOKEN</code>
            {% case _ %}
            <code>{{ scheme_name }}: YOUR_CREDENTIALS</code>
            {% end %}
          </div>
          {% end %}
          {% end %}
        </div>
      </section>
      {% end %}

      {% if schs | length > 0 %}
      <section class="api-catalog-panel api-catalog-panel--schemas">
        <h2>{{ icon('database', size=14) }} Schemas</h2>
        <div class="api-catalog-schema-list">
          {% for schema in schs %}
          <a href="{{ schema.href }}" class="api-catalog-schema">
            <code>{{ schema.name }}</code>
            <span>{{ schema.schema_type }}</span>
          </a>
          {% end %}
        </div>
      </section>
      {% end %}
    </aside>
  </div>
</div>
{% end %}