{{ define "main" }}
{{ partial "page-heading.html" . }}
<div class="docs-layout wrap">
  <aside class="side-nav"><span class="eyebrow">Reference library</span><nav aria-label="Documentation sections"><a href="#start">Start here</a><a href="#formats">File formats <span>14</span></a><a href="#behavior">Engine behavior <span>08</span></a><a href="#development">Development</a></nav><div class="aside-status"><span class="status-dot"></span> Living documentation<p>References currently open on GitHub. An integrated reading experience is planned.</p></div></aside>
  <div class="article reference-article">
    <section id="start"><h2>A reference you can build on.</h2><p>The Total Annihilation format reference describes how to read the original game’s files. The clean-room specification describes what the original engine does. Nanolathe’s design documents explain how this implementation is built.</p><p>References retain their evidence labels: <strong>Established</strong>, <strong>Supported inference</strong>, and <strong>Unknown</strong>. Open questions stay visible.</p><a class="text-link" href="{{ "get-started/" | relURL }}">New here? Build and run Nanolathe {{ partial "arrow.html" . }}</a></section>
    <section id="formats"><div class="reference-heading"><div><span class="eyebrow">Total Annihilation data</span><h2>File formats</h2></div><span class="count-label">14 references</span></div><p>Byte layouts, fields, conversions, and worked examples. Each link opens the maintained reference on GitHub.</p><div class="format-list">{{ range hugo.Data.references.formats }}<a href="{{ site.Params.engineRepo }}/blob/{{ site.Params.engineBranch }}/research/formats/{{ .slug }}.md"><span class="format-tag">{{ .label }}</span><div><h3>{{ .title }}</h3><p>{{ .description }}</p></div><span class="external-arrow" aria-hidden="true">↗</span></a>{{ end }}</div></section>
    <section id="behavior"><div class="reference-heading"><div><span class="eyebrow">Total Annihilation engine</span><h2>Clean-room behavior</h2></div><span class="count-label">08 categories</span></div><p>Independently worded behavioral contracts, with sources of confidence and unresolved questions. <a href="{{ site.Params.engineRepo }}/blob/{{ site.Params.engineBranch }}/research/retail-executable-spec/README.md">Read the evidence guide first.</a></p><div class="behavior-list">{{ range hugo.Data.references.behavior }}<a href="{{ site.Params.engineRepo }}/blob/{{ site.Params.engineBranch }}/research/retail-executable-spec/{{ .slug }}.md"><span class="item-number">{{ .number }}</span><span>{{ .title }}</span><span class="external-arrow" aria-hidden="true">↗</span></a>{{ end }}</div></section>
    <section id="development"><span class="eyebrow">Building Nanolathe</span><h2>Implementation &amp; contribution</h2><div class="behavior-list">{{ range slice (dict "title" "Architecture and package boundaries" "path" "docs/ARCHITECTURE.md") (dict "title" "Contribution and clean-room rules" "path" "AGENTS.md") (dict "title" "Implementation invariants" "path" "docs/INVARIANTS.md") (dict "title" "GPU renderer design" "path" "docs/DESIGN_GPU_RENDERER.md") }}<a href="{{ site.Params.engineRepo }}/blob/{{ site.Params.engineBranch }}/{{ .path }}"><span>{{ .title }}</span><span class="external-arrow" aria-hidden="true">↗</span></a>{{ end }}</div></section>
  </div>
</div>
{{ end }}