{#
Bengal OpenAPI Section Index

Generic section index for OpenAPI documentation sections.
Used for sections without consolidated endpoints (e.g., /schemas/).

Context:
- section: Section
- site: Site
- config: Config
#}
{% extends 'autodoc/openapi/layouts/reference.html' %}

{% let title = section.title ?? 'API Section' %}
{% let description = section.metadata.description ?? '' %}
{# Get pages from the section - section.pages contains Page objects #}
{% let child_pages = section.pages ?? [] %}
{# Get subsections for navigation to child sections #}
{% let child_sections = section.subsections ?? [] %}
{% let schema_items = section | schemas %}

{% block api_left %}
<nav class="openapi-nav" aria-label="{{ title }} navigation">
  {% if section.parent %}<a href="{{ section.parent.href }}" class="openapi-nav__back">{{ icon('arrow-left', size=14) }} {{ section.parent.title }}</a>{% end %}
  {% for child in child_sections %}
  <a href="{{ child.href }}">{{ child.title }}</a>
  {% end %}
  {% for child in child_pages %}
  {% if child != section.index_page %}
  <a href="{{ child.href }}">{{ child.title }}</a>
  {% end %}
  {% end %}
</nav>
{% end %}

{% block api_header %}
<span class="openapi-eyebrow">Reference section</span>
  <h1 class="api-section-index__title">{{ title }}</h1>

  {% if description %}
  <div class="api-section-index__description">
    {{ description | markdownify | safe }}
  </div>
  {% end %}
{% end %}

{% block api_main %}
<article class="api-section-index" data-autodoc="openapi">
  {# Child Sections Grid (e.g., tag groups) #}
  {% if child_sections %}
  <section class="api-section-index__sections">
    <h2 class="api-section-index__section-title">Categories</h2>
    <div class="api-section-index__grid">
      {% for child in child_sections %}
      <a href="{{ child.href }}" class="api-section-index__card card card--hoverable">
        <h3 class="api-section-index__card-title">{{ child.title }}</h3>
        {% with child.metadata.description as desc %}
        {% if desc %}
        <p class="api-section-index__card-description text-muted">
          {{ desc | truncate(120) }}
        </p>
        {% end %}
        {% end %}
      </a>
      {% end %}
    </div>
  </section>
  {% end %}

  {# Schema Catalog #}
  {% if schema_items | length > 0 %}
  <section class="api-section-index__pages">
    <div class="api-section-index__section-head">
      <h2 class="api-section-index__section-title">Schemas</h2>
      {% if schema_items | length > 4 %}
      <div class="api-catalog-filter">
        <input type="search" class="api-catalog-filter__input" data-api-filter-input
               placeholder="Filter schemas&hellip;" aria-label="Filter schemas by name or type">
      </div>
      {% end %}
    </div>
    <p class="api-catalog-filter__empty" data-api-filter-empty hidden aria-live="polite">No schemas match your filter.</p>
    <div class="api-schema-catalog">
      {% for schema in schema_items %}
      {% let property_preview = schema.properties |> items |> take(4) %}
      {% let tile_composition = schema.display_schema | schema_composition %}
      {% let tile_flags = schema.display_schema | schema_flags %}
      <a href="{{ schema.href }}" class="api-schema-catalog__tile" data-api-filter-item data-schema-name="{{ schema.name }}" data-schema-type="{{ schema.schema_type }}">
        <span class="api-schema-catalog__tile-top">
          <code>{{ schema.name }}</code>
          <span>{{ schema.schema_type }}</span>
        </span>
        {% if tile_composition is not none or tile_flags?.deprecated %}
        <span class="api-schema-catalog__chips">
          {% if tile_composition is not none %}<span class="api-schema-catalog__chip" data-kind="{{ tile_composition.kind }}">{{ tile_composition.kind }}</span>{% end %}
          {% if tile_composition?.discriminator %}<span class="api-schema-catalog__chip" data-kind="discriminator">polymorphic</span>{% end %}
          {% if tile_flags?.deprecated %}<span class="api-schema-catalog__chip" data-kind="deprecated">deprecated</span>{% end %}
        </span>
        {% end %}
        {% if schema.description %}
        <span class="api-schema-catalog__description">{{ schema.description | truncate(120) }}</span>
        {% end %}
        {% if property_preview | length > 0 %}
        <span class="api-schema-catalog__preview" aria-label="Properties">
          {% for prop_name, prop_schema in property_preview %}
          <code>{{ prop_name }}</code>
          {% end %}
        </span>
        {% end %}
        <span class="api-schema-catalog__meta">
          <span>{{ schema.properties | length }} properties</span>
          {% if schema.required | length > 0 %}
          <span>{{ schema.required | length }} required</span>
          {% end %}
          {% if schema.enum %}
          <span>{{ schema.enum | length }} values</span>
          {% end %}
        </span>
      </a>
      {% end %}
    </div>
  </section>

  {# Child Pages Grid (fallback for non-schema sections) #}
  {% elif child_pages %}
  <section class="api-section-index__pages">
    <h2 class="api-section-index__section-title">Items</h2>
    <div class="api-section-index__grid">
      {% for child in child_pages %}
      {# Skip the index page itself #}
      {% if child != section.index_page %}
      <a href="{{ child.href }}" class="api-section-index__card card card--hoverable">
        <h3 class="api-section-index__card-title">{{ child.title }}</h3>
        {% with child.metadata.description as desc %}
        {% if desc %}
        <p class="api-section-index__card-description text-muted">
          {{ desc | truncate(120) }}
        </p>
        {% end %}
        {% end %}
      </a>
      {% end %}
      {% end %}
    </div>
  </section>
  {% elif not child_sections %}
  <p class="api-section-index__empty text-muted">No items in this section.</p>
  {% end %}
</article>
{% end %}

{% block api_right %}
<div class="openapi-side-panel">
  <h2>{{ icon('folder', size=14) }} Section</h2>
  <dl class="openapi-side-panel__meta">
    <div><dt>Sections</dt><dd>{{ child_sections | length }}</dd></div>
    <div><dt>Schemas</dt><dd>{{ schema_items | length }}</dd></div>
    <div><dt>Items</dt><dd>{{ child_pages | length }}</dd></div>
  </dl>
</div>
{% end %}