{#
  Component library for the panel.

  Every component here is driven by an explicit context, so a template never
  reaches into a manager or a model. The state vocabulary is fixed and shared:
  "active", "idle", "failed" and "busy". Those four words are what the state
  rail, the badge and the notice all agree on, so an operator learns the
  language once and it holds on every screen.
#}

{% set _STATE_ALIASES = {
  "active": "active", "running": "active", "valid": "active", "enabled": "active",
  "failed": "failed", "error": "failed", "expired": "failed", "corrupt": "failed",
  "busy": "busy", "deploying": "busy", "renewing": "busy", "expiring": "busy",
  "building": "busy", "restoring": "busy"
} %}


{% macro state_class(state) -%}
{{- _STATE_ALIASES.get(state | lower, "idle") -}}
{%- endmacro %}


{% macro badge(state, text=none) -%}
<span class="badge badge--{{ state_class(state) }}">{{ text or state }}</span>
{%- endmacro %}


{#
  A resource row. The coloured rail on the leading edge is the whole point:
  running your eye down the left border of a list tells you the health of
  everything on it without reading a word.

  meta is a list of (label, value) pairs rendered in mono. Keep it to the three
  or four facts an operator scans for, not everything the record holds.

  note is one further line, for what a tool said about this record verbatim:
  certbot's own validity line, or a backup's description. It is not a place for
  commentary.

  state_text is the state in words. The rail is a colour, and a colour on its
  own is unreadable to anyone who cannot see this particular pair of hues and
  invisible to a screen reader. Pass it wherever the record actually has a
  state worth naming; where it does not, the state is still announced, just not
  taken up screen space with.

  Used with {% call %} so the caller supplies the action buttons:

      {% call m.row("example.com", "active", meta) %}
        {{ m.action_button("Restart", "/api/apps/example.com/restart") }}
      {% endcall %}
#}
{% macro row(name, state, meta=[], href=none, row_id=none, note=none, state_text=none) %}
<div class="row row--{{ state_class(state) }}"{% if row_id %} id="{{ row_id }}"{% endif %}>
  <div class="row__main">
    <span class="row__name">
      {%- if href %}<a href="{{ href }}">{{ name }}</a>{% else %}{{ name }}{% endif -%}
    </span>
    {% if state_text %}
      {{ badge(state, state_text) }}
    {% else %}
      <span class="visually-hidden">Status: {{ state }}</span>
    {% endif %}
    {% if meta %}
      <span class="row__meta">
        {% for label, value in meta %}<span>{{ label }} {{ value }}</span>{% endfor %}
      </span>
    {% endif %}
    {% if note %}<span class="row__meta faint">{{ note }}</span>{% endif %}
  </div>
  <div class="row__actions">{{ caller() if caller else "" }}</div>
</div>
{% endmacro %}


{#
  Page header. Used with {% call %} so the caller supplies the toolbar:

      {% call m.page_head("Applications", "3 deployed") %}
        <a class="btn btn--primary" href="/apps/new">Deploy</a>
      {% endcall %}
#}
{% macro page_head(title, subtitle=none) %}
<div class="page__head">
  <div class="page__title">
    <h1>{{ title }}</h1>
    {% if subtitle %}<p class="muted">{{ subtitle }}</p>{% endif %}
  </div>
  <div class="toolbar">{{ caller() if caller else "" }}</div>
</div>
{% endmacro %}


{#
  An empty screen is an invitation to act, not a shrug. It always names the one
  thing to do next, and gives the equivalent command, because this audience
  often prefers the terminal and should not have to guess the incantation.
#}
{% macro empty(title, body, action_label=none, action_href=none, command=none) %}
<div class="empty">
  <h2>{{ title }}</h2>
  <p>{{ body }}</p>
  {% if action_label and action_href %}
    <a class="btn btn--primary" href="{{ action_href }}">{{ action_label }}</a>
  {% endif %}
  {% if command %}<p class="faint">Or run <code>{{ command }}</code></p>{% endif %}
</div>
{% endmacro %}


{#
  A message from nginx, systemd or certbot is never paraphrased. The fix goes
  above it in plain words; the tool's own output goes below it verbatim, in
  mono, because that is what the operator will search for.
#}
{% macro problem(fix, output=none) %}
<div class="problem" role="alert">
  <p class="problem__fix">{{ fix }}</p>
  {% if output %}<pre class="problem__output">{{ output }}</pre>{% endif %}
</div>
{% endmacro %}


{#
  A capacity bar reads faster than a percentage, and both together read
  fastest. Thresholds live here so every meter in the panel agrees on what
  "nearly full" means.
#}
{#
  The fill is a class, not an inline width.

  The panel sets style-src 'self' with no unsafe-inline, because it runs as
  root and a style attribute is a place markup can be injected. The browser
  refused every style="width: N%" here, so the capacity bars rendered empty on
  every page: the one element on the machine strip whose whole job is to be
  read at a glance showed nothing at all.

  Rounding to the nearest five is what makes a class per value practical. It
  costs no accuracy that matters at 3.5rem wide, and the exact figure is in the
  number beside it either way.
#}
{% macro capacity(label, used, total, human_used="", human_total="") %}
{%- set pct = (used / total * 100) if total else 0 -%}
{%- set level = "critical" if pct >= 90 else ("warn" if pct >= 75 else "ok") -%}
{%- set step = ((pct / 5) | round | int) * 5 -%}
<span class="machine__metric" title="{{ label }}: {{ human_used }} of {{ human_total }}">
  <span class="label">{{ label }}</span>
  <span class="capacity capacity--{{ level }}">
    <span class="capacity__fill capacity__fill--{{ step }}"></span>
  </span>
  <span class="num">{{ pct | round | int }}%</span>
</span>
{% endmacro %}


{% macro stat(label, value, unit=none) %}
<span class="machine__metric">
  <span class="label">{{ label }}</span>
  <span class="num">{{ value }}{% if unit %}<span class="faint">{{ unit }}</span>{% endif %}</span>
</span>
{% endmacro %}


{#
  Destructive actions ask first, and the question names the exact resource and
  the exact consequence. "Are you sure?" tells an operator nothing. Pass
  question when the caller has already composed the exact wording.

  The swap is "delete", not "outerHTML": the endpoints answer in JSON, and
  swapping a JSON body into the list is how a delete used to leave a blob of
  braces where the row had been. htmx does not swap at all on a 4xx or 5xx, so
  a row only disappears when the deletion actually happened.
#}
{% macro danger_button(label, endpoint, resource, consequence, question=none, target=none) %}
{#
  target defaults to the row this button sits in, which is where it sits
  everywhere except an application's own page: there is no .row there, so
  "closest .row" matched nothing, htmx raised targetError and never sent the
  request at all. The delete control on the detail screen was completely inert
  and said nothing about it. A caller outside a list passes its own target.
#}
<button type="button" class="btn btn--sm btn--danger"
        hx-delete="{{ endpoint }}"
        hx-confirm="{{ question or (label ~ ' ' ~ resource ~ '? ' ~ consequence) }}"
        hx-target="{{ target or 'closest .row' }}"
        hx-swap="{{ 'delete' if target is none else 'none' }}">{{ label }}</button>
{% endmacro %}


{#
  Fires an action and swaps nothing, for the same reason: the API answers with
  JSON. What comes back is a job, and the job is reported by the machine strip,
  the activity screen and the notices, not by rewriting the row from a payload
  the template cannot read.

  done is what the operator is told once it worked, and it is written in the
  past tense of the button's own label, because the design direction commits to
  an action keeping its name through the whole flow: "Restart" produces
  "Restarted". Without it the panel ran the action and said nothing at all,
  which is how an operator ends up clicking Restart four times.
#}
{% macro action_button(label, endpoint, confirm=none, done=none) %}
<button type="button" class="btn btn--sm"
        hx-post="{{ endpoint }}"
        {% if done %}data-success="{{ done }}"
        {% endif %}{% if confirm %}hx-confirm="{{ confirm }}"
        {% endif %}hx-swap="none">{{ label }}</button>
{% endmacro %}


{#
  A two column sheet of facts: label on the left in the condensed label face,
  the machine's own value on the right in mono with tabular figures. Used on
  the detail screens, where the point is to be readable next to the output of
  the command that produced it.
#}
{% macro facts(entries) %}
<table class="table">
  <tbody>
    {% for label, value in entries %}
      <tr>
        <th scope="row">{{ label }}</th>
        <td class="mono">{{ value }}</td>
      </tr>
    {% endfor %}
  </tbody>
</table>
{% endmacro %}


{#
  A value the server refused to send. It has to read as hidden, not as empty:
  a blank field says "nothing is set here" and invites someone to overwrite a
  working credential with an empty string.
#}
{% macro secret(value) %}
<span class="mono faint"
      title="Redacted. The panel never sends a stored secret to the browser.">{{ value }}</span>
{% endmacro %}


{#
  Attaches the docked drawer to a log stream. The drawer itself is in base.html
  and persists across navigation, so this only tells it what to follow.

  The source and URL travel as data attributes, picked up by a delegated
  listener. An inline onclick carrying interpolated server data is how the
  previous panel ended up with a hundred and three places where a domain name
  could break out of an attribute.
#}
{% macro follow_button(label, source, url) %}
<button type="button" class="btn btn--sm btn--quiet" data-follow-log data-source="{{ source }}"
        data-url="{{ url }}">{{ label }}</button>
{% endmacro %}