/* Docs layout and prose, on top of ../tokens.css and ../site.css.
   The usual docs layout readers already know (Jakob): sections on the left, "on this page"
   on the right, previous / next at the end. Sidebar groups stay small (Miller); on phones the
   section list folds into one menu (Hick). */

.docs { font-size: 16px; }

.docs__layout { display: grid; gap: var(--space-6); padding-top: var(--space-6); padding-bottom: var(--space-16); }
@media (min-width: 960px) {
  .docs__layout { grid-template-columns: 220px minmax(0, 1fr); gap: var(--space-12); padding-top: var(--space-12); }
}
@media (min-width: 1240px) {
  .docs__layout { grid-template-columns: 220px minmax(0, 760px) 200px; max-width: 1320px; }
}

.docs__side, .docs__toc { font-size: 15px; }
@media (min-width: 960px) {
  .docs__side, .docs__toc { position: sticky; top: 88px; align-self: start; max-height: calc(100vh - 110px); overflow: auto; }
}
.docs__toc { display: none; }
@media (min-width: 1240px) { .docs__toc { display: block; } }

.docs__menu summary { display: none; }
@media (max-width: 959px) {
  .docs__menu { border: 1px solid var(--border); border-radius: var(--radius-md); background: var(--surface); }
  .docs__menu summary { display: flex; align-items: center; justify-content: space-between; min-height: var(--target); padding: 0 var(--space-4); cursor: pointer; font-weight: 500; list-style: none; }
  .docs__menu summary::-webkit-details-marker { display: none; }
  .docs__menu summary::after { content: "+"; font-size: 20px; font-weight: 300; color: var(--muted); }
  .docs__menu[open] summary::after { content: "\2212"; }
  .docs__menu nav { padding: 0 var(--space-2) var(--space-3); }
}
.docs__group { margin: var(--space-5) 0 var(--space-1); padding: 0 var(--space-3); font-size: 12px; font-weight: 500; letter-spacing: 0.04em; color: var(--faint); }
.docs__side ul, .docs__toc ul { list-style: none; margin: 0; padding: 0; }
/* Full-row links, 36px tall (44px on touch screens): big, close targets (Fitts). */
.docs__side li a, .docs__toc li a { display: flex; align-items: center; min-height: 36px; padding: var(--space-1) var(--space-3); border-radius: var(--radius-sm); color: var(--muted); text-decoration: none; transition: color var(--fast) var(--ease), background-color var(--fast) var(--ease); }
.docs__side li a:hover, .docs__toc li a:hover { color: var(--text); background: var(--tint); }
.docs__side li a[aria-current="page"] { color: var(--text); background: var(--brand-soft); box-shadow: inset 2px 0 0 var(--brand); font-weight: 500; }
.docs__toc .toc--h3 a { padding-left: var(--space-6); font-size: 14px; }
@media (pointer: coarse) { .docs__side li a { min-height: var(--target); } }

/* Prose */
.prose { min-width: 0; }
.prose p, .prose ul, .prose ol, .prose table, .prose pre { margin: 0 0 1em; }
.prose h1 { font-size: clamp(34px, 4.4vw, 46px); margin-bottom: var(--space-4); }
.prose h2 { font-size: 28px; margin: 2.2em 0 0.6em; padding-top: 0.8em; border-top: 1px solid var(--border); }
.prose h3 { font-size: 20px; font-weight: 700; margin: 1.8em 0 0.5em; }
.prose h4 { font-size: 16px; margin: 0 0 0.4em; }
.prose h2, .prose h3, .prose h4 { scroll-margin-top: 88px; }
.prose p, .prose li { color: var(--text); }
.prose .lead { font-size: 19px; color: var(--muted); margin-bottom: var(--space-6); }
.prose .eyebrow { margin-bottom: var(--space-3); color: var(--brand); }
.prose ul, .prose ol { padding-left: 1.3em; }
.prose li + li { margin-top: 0.3em; }
.prose code { background: var(--tint); border: 1px solid var(--border); border-radius: 6px; padding: 0.08em 0.35em; }
.prose pre { position: relative; background: var(--code-bg); color: var(--text); border: 1px solid var(--border); border-radius: var(--radius-md); padding: var(--space-4); overflow-x: auto; font: 14px/1.65 var(--mono); }
.prose pre code { background: none; border: 0; padding: 0; color: inherit; font-size: inherit; }
.has-copy { position: relative; }
.prose .copy { position: absolute; right: var(--space-3); margin-top: var(--space-3); z-index: 1; }
.prose figure { margin: 1.2em 0; }

.anchor { margin-left: var(--space-2); opacity: 0; color: var(--faint); text-decoration: none; font-weight: 400; }
h2:hover .anchor, h3:hover .anchor, .anchor:focus { opacity: 1; }

table { width: 100%; border-collapse: collapse; font-size: 15px; display: block; overflow-x: auto; }
th, td { text-align: left; padding: var(--space-2) var(--space-3); border-bottom: 1px solid var(--border); vertical-align: top; }
th { color: var(--muted); font-weight: 500; white-space: nowrap; }
td code { white-space: nowrap; }

/* Callouts: pink for notes, orange for "in progress / take care", green for done. */
.callout { border: 1px solid var(--border); border-left: 3px solid var(--brand); background: var(--surface); border-radius: var(--radius-md); padding: var(--space-3) var(--space-4); margin: 1.2em 0; }
.callout--warn { border-left-color: var(--color-action); }
.callout--ok { border-left-color: var(--accent); }
.callout p:last-child { margin-bottom: 0; }

/* Status pills use the palette's roles: green done, purple local only, neutral planned. */
.status { display: inline-block; font-size: 12px; font-weight: 500; padding: 2px var(--space-2); border-radius: var(--radius-sm); white-space: nowrap; border: 1px solid transparent; }
.status--built { color: var(--accent); border-color: rgba(20, 241, 149, 0.4); }
.status--local { color: #c4a0ff; border-color: rgba(153, 69, 255, 0.55); }
.status--planned { color: var(--muted); border-color: var(--border); }

.kv { display: flex; flex-wrap: wrap; gap: var(--space-2) var(--space-3); align-items: center; }
.kv span { color: var(--muted); font-size: 14px; }

.ref { border: 1px solid var(--border); border-radius: var(--radius-md); padding: var(--space-4) var(--space-5); margin: var(--space-3) 0; background: var(--surface); }
.ref table { margin-bottom: 0; }
.ref__label { margin: var(--space-3) 0 var(--space-1); font-size: 12px; letter-spacing: 0.04em; font-weight: 500; color: var(--faint); }
.params { list-style: none; padding: 0; margin: 0; display: flex; flex-wrap: wrap; gap: 6px 14px; }
.type { font: 13px var(--mono); color: var(--accent); }
.flag { display: inline-block; font-size: 12px; font-weight: 500; padding: 1px 7px; border-radius: var(--radius-sm); background: var(--brand-soft); color: var(--brand); }

.diagram { background: var(--surface); border: 1px solid var(--border); border-radius: var(--radius-md); padding: var(--space-4); font: 14px/1.5 var(--mono); white-space: pre; overflow-x: auto; color: var(--text); }

/* Previous / next: every page ends on a clear next step (peak-end). */
.pager { display: grid; grid-template-columns: 1fr 1fr; gap: var(--space-3); margin-top: var(--space-16); }
.pager a { display: block; padding: var(--space-4); border: 1px solid var(--border); border-radius: var(--radius-md); text-decoration: none; color: var(--text); font-weight: 500; background: var(--surface); transition: border-color var(--fast) var(--ease); }
.pager a:hover { border-color: var(--brand); }
.pager a span { display: block; font-size: 13px; font-weight: 400; color: var(--muted); }
.pager__next { text-align: right; grid-column: 2; }

.cards { display: grid; gap: var(--space-3); }
@media (min-width: 720px) { .cards--3 { grid-template-columns: repeat(2, 1fr); } }
@media (min-width: 1000px) { .cards--3 { grid-template-columns: repeat(3, 1fr); } }
.cards--docs { margin-top: var(--space-4); }
.cards--docs .card { display: block; padding: var(--space-5); text-decoration: none; color: inherit; transition: border-color var(--fast) var(--ease); }
.cards--docs .card:hover { border-color: var(--brand); }
.cards--docs .card h3 { margin: 0 0 var(--space-2); font-size: 18px; font-weight: 700; }
.cards--docs .card p { margin: 0; color: var(--muted); font-size: 15px; }
