{{define "figure" -}}
<figure>
{{- range .Pictures}}
<img src="{{.Src}}"{{if .Srcset}} srcset="{{.Srcset}}"{{end}}{{if .Width}} width="{{.Width}}" height="{{.Height}}"{{end}} alt="{{$.Args.alt}}">
{{- end}}
{{- if not .Pictures}}
<img src="{{.Args.src}}" alt="{{.Args.alt}}">
{{- end}}
{{- if .Args.caption}}
<figcaption>{{.Args.caption}}</figcaption>
{{- end}}
</figure>
{{- end}}

{{define "gallery" -}}
{{if .Pictures -}}
<div class="gallery">
{{- range .Pictures}}
<figure><img src="{{.Src}}"{{if .Srcset}} srcset="{{.Srcset}}"{{end}}{{if .Width}} width="{{.Width}}" height="{{.Height}}"{{end}} alt=""></figure>
{{- end}}
</div>
{{- end}}
{{- end}}

{{/* One template for the whole set: which names exist is the theme's business, never the engine's
     (ADR-0063). Unicode here, so the reference theme ships no sprite, no font and no asset — a theme
     wanting drawn icons redefines this block and emits <use> against its own sprite. An unknown name
     renders nothing, which is how a theme says so, and the engine puts the author's text back. */}}
{{define "icon"}}
{{- if eq .Args.name "warn"}}⚠️
{{- else if eq .Args.name "note"}}ℹ️
{{- else if eq .Args.name "tip"}}💡
{{- else if eq .Args.name "star"}}⭐
{{- else if eq .Args.name "check"}}✅
{{- else if eq .Args.name "cross"}}❌
{{- end}}
{{- end}}

{{/* Admonitions. One template per kind, because a call renders through a template of its own name — the
     markup is the theme's and the engine supplies only the name, the arguments and the rendered body
     (ADR-0064). `.Body` is already HTML. A theme with no template for a kind renders nothing, and the
     engine writes the body out unwrapped rather than losing it. */}}
{{define "note"}}<aside class="admonition note">{{with .Args.title}}<p class="admonition-title">{{.}}</p>{{end}}{{.Body}}</aside>{{end}}
{{define "warn"}}<aside class="admonition warn">{{with .Args.title}}<p class="admonition-title">{{.}}</p>{{end}}{{.Body}}</aside>{{end}}
{{define "tip"}}<aside class="admonition tip">{{with .Args.title}}<p class="admonition-title">{{.}}</p>{{end}}{{.Body}}</aside>{{end}}

{{/* A flat list with a level class per entry, so nesting is a CSS decision rather than a markup one: the
     engine supplies depth and the theme decides whether to indent (ADR-0065). An entry with no id is
     skipped rather than linked nowhere. */}}
{{define "toc"}}
{{- if .Headings}}<nav class="toc"><ol>
{{- range .Headings}}{{if .ID}}
<li class="toc-{{.Level}}"><a href="#{{.ID}}">{{.Text}}</a></li>
{{- end}}{{end}}
</ol></nav>
{{- end}}
{{- end}}