{% extends "layouts/docs_catalog.html" %}
{% from "chirpui/breadcrumbs.html" import breadcrumbs %}

{% block catalog_hero_eyebrow %}
{{ breadcrumbs(breadcrumb_items ?? [{"label": "Home", "href": "/"}]) }}
{% end %}

{% block catalog_hero_metadata %}
{% let operation = node.meta.api_operation ?? none %}
{% if operation %}
<span>{{ operation.method }}</span>
<span>{{ operation.path }}</span>
{% if operation.tags %}
{% for tag in operation.tags %}
<span>{{ tag }}</span>
{% end %}
{% end %}
{% elif child_page_count > 0 %}
<span>{{ child_page_count }} operation{{ '' if child_page_count == 1 else 's' }}</span>
{% end %}
{% end %}

{% block catalog_article %}
{% let operation = node.meta.api_operation ?? none %}
{% let try_it = node.meta.api_try_it ?? none %}
<article class="prose chirp-theme-docs-layout__article fura-api-reference">
  {% if operation %}
  <div class="docs-content chirp-theme-docs-layout__content fura-api-reference__operation">
    <section class="fura-api-reference__summary" aria-labelledby="api-operation-summary">
      <h2 id="api-operation-summary">Operation</h2>
      <dl>
        <div>
          <dt>Operation ID</dt>
          <dd><code>{{ operation.operation_id }}</code></dd>
        </div>
        <div>
          <dt>Method</dt>
          <dd><code>{{ operation.method }}</code></dd>
        </div>
        <div>
          <dt>Path</dt>
          <dd><code>{{ operation.path }}</code></dd>
        </div>
      </dl>
      {% if operation.summary %}
      <p>{{ operation.summary }}</p>
      {% end %}
    </section>

    {% if operation.request_bodies or operation.responses or operation.schemas or operation.examples %}
    <section aria-labelledby="api-contract">
      <h2 id="api-contract">Contract</h2>
      <table>
        <tbody>
          {% if operation.request_bodies %}
          <tr>
            <th scope="row">Request bodies</th>
            <td>{% for item in operation.request_bodies %}<code>{{ item }}</code>{% if not loop.last %}, {% end %}{% end %}</td>
          </tr>
          {% end %}
          {% if operation.responses %}
          <tr>
            <th scope="row">Responses</th>
            <td>{% for item in operation.responses %}<code>{{ item }}</code>{% if not loop.last %}, {% end %}{% end %}</td>
          </tr>
          {% end %}
          {% if operation.schemas %}
          <tr>
            <th scope="row">Schemas</th>
            <td>{% for item in operation.schemas %}<code>{{ item }}</code>{% if not loop.last %}, {% end %}{% end %}</td>
          </tr>
          {% end %}
          {% if operation.examples %}
          <tr>
            <th scope="row">Examples</th>
            <td>{% for item in operation.examples %}<code>{{ item }}</code>{% if not loop.last %}, {% end %}{% end %}</td>
          </tr>
          {% end %}
        </tbody>
      </table>
    </section>
    {% end %}

    {% if operation.auth or operation.environments %}
    <section aria-labelledby="api-runtime">
      <h2 id="api-runtime">Runtime</h2>
      <table>
        <tbody>
          {% if operation.auth %}
          <tr>
            <th scope="row">Auth</th>
            <td>{% for item in operation.auth %}<code>{{ item }}</code>{% if not loop.last %}, {% end %}{% end %}</td>
          </tr>
          {% end %}
          {% if operation.environments %}
          <tr>
            <th scope="row">Environments</th>
            <td>{% for item in operation.environments %}<code>{{ item }}</code>{% if not loop.last %}, {% end %}{% end %}</td>
          </tr>
          {% end %}
        </tbody>
      </table>
    </section>
    {% end %}

    {% if try_it %}
    <section class="fura-api-reference__try-it" aria-labelledby="api-try-it">
      <h2 id="api-try-it">Try it</h2>
      <dl>
        <div>
          <dt>Tenant</dt>
          <dd><code>{{ try_it.boundaries.tenant }}</code></dd>
        </div>
        <div>
          <dt>Site</dt>
          <dd><code>{{ try_it.boundaries.site }}</code></dd>
        </div>
        <div>
          <dt>Mount</dt>
          <dd><code>{{ try_it.boundaries.mount }}</code></dd>
        </div>
        <div>
          <dt>Static export</dt>
          <dd><code>{{ try_it.static_export.fallback_mode }}</code> {{ try_it.static_export.reason }}</dd>
        </div>
      </dl>

      <table>
        <thead>
          <tr>
            <th scope="col">Mode</th>
            <th scope="col">State</th>
            <th scope="col">Behavior</th>
          </tr>
        </thead>
        <tbody>
          {% for mode in try_it.modes %}
          <tr>
            <th scope="row">{{ mode.id }}</th>
            <td>{{ 'available' if mode.available else 'unavailable' }}</td>
            <td>{{ mode.request_behavior }}{% if mode.disabled_reason | default('') %}: {{ mode.disabled_reason }}{% end %}</td>
          </tr>
          {% end %}
        </tbody>
      </table>

      {% if try_it.base_urls %}
      <h3>Base URLs</h3>
      <ul>
        {% for base in try_it.base_urls %}
        <li><strong>{{ base.label }}</strong>{% if base.url %}: <code>{{ base.url }}</code>{% end %}{% if base.base_url_env %} via <code>{{ base.base_url_env }}</code>{% end %}</li>
        {% end %}
      </ul>
      {% end %}

      {% if try_it.auth %}
      <h3>Auth boundaries</h3>
      <ul>
        {% for auth in try_it.auth %}
        <li><code>{{ auth.scheme }}</code> uses {{ auth.storage }} token storage{% if not auth.configured %}; token reference not configured{% end %}</li>
        {% end %}
      </ul>
      {% end %}
    </section>
    {% end %}

    {{ node | doc_body | boost_doc_links }}

    {% if operation.external_docs %}
    <section aria-labelledby="api-related-docs">
      <h2 id="api-related-docs">Related docs</h2>
      <ul>
        {% for item in operation.external_docs %}
        <li><a href="{{ item.url }}">{{ item.description }}</a></li>
        {% end %}
      </ul>
    </section>
    {% end %}
  </div>
  {% else %}
  <div class="docs-content chirp-theme-docs-layout__content fura-api-reference__index">
    {{ node | doc_body | boost_doc_links }}
  </div>
  {% end %}

  {% if backlinks %}
  <footer class="docs-footer chirp-theme-docs-layout__footer">
    <span class="docs-footer-label">Linked from</span>
    <ul class="chirpui-list">
      {% for ref in backlinks %}
      <li><a href="{{ ref.href }}">{{ ref.title }}</a></li>
      {% end %}
    </ul>
  </footer>
  {% end %}
</article>
{% end %}

{% block catalog_doc_nav %}
{% include "partials/doc_nav.html" %}
{% end %}

{% block catalog_toc_aside %}
{% if node.toc | length > 0 %}
<aside id="toc-panel" class="chirp-theme-docs-layout__toc" role="complementary" aria-label="API reference contents">
  {% include "partials/doc_toc.html" %}
</aside>
{% end %}
{% end %}