/* framebuff.online docs: the layout and prose that only the docs pages use.
   Loaded after site.css and uses only its colour tokens, so light and dark mode both follow it. */

.docs { padding-block: clamp(32px, 6vw, 72px); }

/* docs home */
.docs-hero { display: flex; flex-direction: column; gap: 14px; max-width: 46rem; margin-bottom: clamp(32px, 5vw, 56px); }
.docs-hero h1 { font-size: var(--step-4); }
.docs-hero p { font-size: var(--step-1); color: var(--muted); }
.docs-hero .pill { margin-bottom: 4px; }
.docs-index .group-head h2 { font-size: var(--step-2); }
.docs-index .card { position: relative; }
.docs-index .card h3 { font-family: var(--f-display); font-size: 1.25rem; letter-spacing: -0.01em; line-height: 1.2; margin: 0; }
.docs-index .card h3 a { color: var(--fg); text-decoration: none; }
.docs-index .card h3 a::after { content: ""; position: absolute; inset: 0; border-radius: var(--radius); }
.docs-index .card:hover { border-color: var(--brand); }
.docs-index .card:has(a:focus-visible) { outline: 3px solid var(--focus); outline-offset: 3px; }
.docs-index .card a:focus-visible { outline: none; }

/* article pages: content first in the source, the nav drawn on the left */
.docs-layout {
  display: grid;
  grid-template-columns: 15rem minmax(0, 1fr);
  grid-template-areas: "nav main";
  gap: clamp(28px, 5vw, 64px);
  align-items: start;
}
.docs-layout > .prose { grid-area: main; }
.docs-layout > .docs-nav { grid-area: nav; }

.docs-nav {
  position: sticky; top: 88px;
  max-height: calc(100vh - 104px); overflow-y: auto;
  display: flex; flex-direction: column; gap: 20px;
  font-size: 0.9375rem; min-width: 0;
  padding-right: 4px;
}
.docs-nav .docs-home { font-family: var(--f-display); font-weight: 700; color: var(--fg); text-decoration: none; }
.docs-nav .docs-home:hover { color: var(--brand); }
.docs-nav-group { display: flex; flex-direction: column; gap: 6px; }
.docs-nav-group .eyebrow { font-size: 0.75rem; }
.docs-nav ul { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 2px; border-left: 1px solid var(--line); }
.docs-nav li a { display: block; padding: 5px 0 5px 14px; margin-left: -1px; border-left: 2px solid transparent; color: var(--muted); text-decoration: none; line-height: 1.35; }
.docs-nav li a:hover { color: var(--fg); }
.docs-nav li a[aria-current="page"] { color: var(--fg); font-weight: 600; border-left-color: var(--brand); }

/* prose */
.prose { max-width: 65ch; min-width: 0; }
.prose .crumbs { font-family: var(--f-mono); font-size: 0.8125rem; color: var(--muted); margin-bottom: 14px; }
.prose .crumbs a { color: var(--muted); }
.prose h1 { font-size: var(--step-3); margin-bottom: 16px; }
.prose .lede { font-size: var(--step-1); color: var(--muted); margin-bottom: 28px; }
.prose h2 { font-size: var(--step-2); margin: 44px 0 14px; padding-top: 4px; scroll-margin-top: 90px; }
.prose h3 { font-size: 1.15rem; letter-spacing: -0.01em; margin: 28px 0 10px; scroll-margin-top: 90px; }
.prose p { margin: 0 0 1em; }
.prose ul, .prose ol { margin: 0 0 1em; padding-left: 1.3em; display: flex; flex-direction: column; gap: 6px; }
.prose li > ul, .prose li > ol { margin: 6px 0 0; }
.prose li::marker { color: var(--brand); }
.prose strong { font-weight: 600; }
.prose dl { margin: 0 0 1em; display: grid; gap: 4px; }
.prose dt { font-weight: 600; margin-top: 12px; }
.prose dt:first-child { margin-top: 0; }
.prose dd { margin: 0; color: var(--muted); }
.prose code { font-family: var(--f-mono); font-size: 0.85em; background: var(--pill-bg); color: var(--pill-fg); padding: 1px 6px; border-radius: 6px; overflow-wrap: anywhere; }
.prose pre {
  margin: 0 0 1.2em; padding: 16px 18px;
  background: var(--screen); color: var(--screen-fg);
  border-radius: 12px; overflow-x: auto;
  font-family: var(--f-mono); font-size: 0.8125rem; line-height: 1.6;
}
.prose pre code { background: none; color: inherit; padding: 0; border-radius: 0; font-size: inherit; overflow-wrap: normal; }
.prose .table-box { margin: 0 0 1.2em; }
.prose table { min-width: 34rem; }
.prose th, .prose td { padding: 10px 14px; }
.prose tbody th { font-family: var(--f-mono); font-size: 0.875rem; font-weight: 500; white-space: nowrap; }
.prose kbd { font-family: var(--f-mono); font-size: 0.85em; border: 1px solid var(--line); border-bottom-width: 2px; border-radius: 6px; padding: 0 5px; background: var(--surface); }

.note {
  margin: 0 0 1.2em; padding: 14px 18px;
  background: var(--surface); border: 1px solid var(--line); border-left: 3px solid var(--brand);
  border-radius: 10px; font-size: 0.9375rem;
}
.note p:last-child { margin-bottom: 0; }
.note .eyebrow { display: block; margin-bottom: 4px; color: var(--brand); }

.pager { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; margin-top: 56px; padding-top: 24px; border-top: 1px solid var(--line); }
.pager a { display: flex; flex-direction: column; gap: 2px; padding: 14px 16px; border: 1px solid var(--line); border-radius: 12px; background: var(--surface); text-decoration: none; color: var(--fg); min-width: 0; }
.pager a:hover { border-color: var(--brand); }
.pager .eyebrow { font-size: 0.75rem; }
.pager .next { grid-column: 2; text-align: right; }

@media (max-width: 900px) {
  .docs-layout { grid-template-columns: minmax(0, 1fr); grid-template-areas: "main" "nav"; }
  .docs-nav { position: static; max-height: none; overflow: visible; padding: 24px 0 0; border-top: 1px solid var(--line); }
}
@media (max-width: 520px) {
  .pager { grid-template-columns: minmax(0, 1fr); }
  .pager .next { grid-column: 1; }
}