{# Shared template macros.  Import with:  {% import "_macros.html" as m %}  #}

{# Figure-debug line (OCEANARRAY_REPORT_DEBUG=1): the display slot this template
   chose vs the render-side figsize/png, so a figsize≠slot mismatch is visible.
   Renders nothing unless debug capture recorded this figure (figdbg is a Jinja
   global returning "" when off), so it is a no-op in normal builds. #}
{% macro dbg(b64, slot) %}{% set d = figdbg(b64) %}{% if d %}<div class="debug">slot: {{ slot }}  |  {{ d }}</div>{% endif %}{% endmacro %}

{# Resolved-panel wrapper (section-manifest port): the single place a figure's
   "fig slot-*" class is emitted.  Branches on the panel kind so |safe applies
   only to authored table/html markup — a "figure" payload is a base64 PNG
   escaped into an img src, and captions are plain text emitted escaped (they are
   a data field that will become user-editable via YAML, so they are never
   trusted markup).  Captions render *above* the figure.  A stub (payload is
   None) renders its reason as a .warn line so an applicable-but-unavailable
   panel is visible, not hidden.  The collapse toggle is preserved for every
   figure. #}
{# Full report body for a resolved report: the generated jump-nav, the numbered
   section loop, the not-applicable footer, the footer line, and the top-link
   script — one definition shared by every manifest-ported page.  Section numbers
   render in parentheses, "(1) Files"; the "Jump to: " label comes from the
   .jump-nav::before CSS, so it is NOT written here (writing it duplicated the
   label).  `na_scope` is the noun for the not-applicable line ("deployment" /
   "instrument"); `generated`/`proc_machine` are passed in because macros do not
   see the calling template's context. #}
{% macro report_body(report, na_scope, generated, cruise, yaml_path="") %}
<nav class="jump-nav">
{%- for sec in report.sections %}
<a href="#{{ sec.id }}">{% if sec.number %}({{ sec.number }}) {% endif %}{{ sec.title }}</a>
{%- endfor %}
</nav>
{% for sec in report.sections %}
<h{{ sec.level }} id="{{ sec.id }}">{% if sec.number %}({{ sec.number }}) {% endif %}{{ sec.title }}</h{{ sec.level }}>
{%- if sec.intro %}
<p class="caption">{{ sec.intro }}</p>
{%- endif %}
{%- if sec.layout == "row" %}
{{ panel_row(sec) }}
{%- else %}
{%- for p in sec.panels %}
{{ panel(p) }}
{%- endfor %}
{%- endif %}
{% endfor %}
{% if report.not_applicable %}
<p class="none-note">Not applicable to this {{ na_scope }}: {{ report.not_applicable | join(", ") }}.</p>
{% endif %}
<div class="report-footer">
  Generated by <strong>{{ package_name }}</strong> v{{ package_version }}{% if cruise and cruise != "—" %} &bull; {{ cruise }}{% endif %} &bull; {{ generated }}{% if yaml_path %} &bull; config: <code>{{ yaml_path }}</code>{% endif %}
</div>
<script>
  document.querySelectorAll('h2').forEach(h => {
    const a = document.createElement('a'); a.href = '#top'; a.className = 'top-link'; a.textContent = '↑ top'; h.appendChild(a);
  });
</script>
{% endmacro %}

{% macro panel(p, bare=false) %}
{%- if p.is_stub %}
<p class="warn">{{ p.stub_reason }}</p>
{%- elif p.kind == "figure" %}
{% if p.caption %}<p class="caption">{{ p.caption }}</p>
{% endif -%}
<details open><summary class="collapse-toggle">show / hide</summary>
<img class="fig{% if not bare and p.slot %} slot-{{ p.slot }}{% endif %}" src="data:image/png;base64,{{ p.payload }}" alt="{{ p.id }}">
{{- dbg(p.payload, ("slot-" ~ p.slot) if p.slot else "full-canvas") }}
</details>
{%- else %}
{% if p.caption %}<p class="caption">{{ p.caption }}</p>
{% endif -%}
{{ p.payload | safe }}
{%- endif %}
{%- endmacro %}

{# Row layout for a section (Section.layout="row"): each panel sits in a flex
   cell sized by its slot (slot-half → ~50%, slot-full → 100% → wraps to its own
   line).  The figure inside the cell is rendered *bare* (class="fig", 100% of
   the cell) so the cell — not the img — controls the display width. #}
{% macro panel_row(sec) %}
<div class="fig-row">
{%- for p in sec.panels %}
<div class="fig-cell{% if p.slot %} slot-{{ p.slot }}{% endif %}">
{{- panel(p, bare=true) }}
</div>
{%- endfor %}
</div>
{% endmacro %}