/* Voxelion documentation — layout only.
 *
 * Every colour, font and spacing value comes from voxelion.css tokens, which
 * is loaded first. Nothing here redefines a token: the docs must not be able to
 * drift from the marketing site's palette, because they sit on the same domain
 * and a visitor moves between them in one click.
 */

.docs {
  display: grid;
  gap: var(--gutter);
  grid-template-columns: 1fr;
  align-items: start;
  padding-block: calc(var(--nav-h) + var(--lg)) var(--section-y);
}
@media (min-width: 960px) {
  .docs { grid-template-columns: 232px minmax(0, 1fr); }
  .docs__side { position: sticky; top: calc(var(--nav-h) + var(--md)); }
}

.docs__side nav { display: grid; gap: 2px; }
.docs__side h2 {
  margin: var(--md) 0 var(--xs);
  font-size: var(--text-label);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--on-surface-variant);
}
.docs__side h2:first-child { margin-top: 0; }
.docs__side a {
  padding: 6px 10px;
  border-radius: var(--r);
  color: var(--on-surface-variant);
  text-decoration: none;
  font-size: 0.9375rem;
}
.docs__side a:hover { background: var(--primary-05); color: var(--on-surface); }
.docs__side a[aria-current="page"] {
  background: var(--primary-10);
  color: var(--primary);
  font-weight: 600;
}

.docs__main { min-width: 0; }
.docs__main > section { scroll-margin-top: calc(var(--nav-h) + var(--md)); }
.docs__main h1 { font-size: var(--text-display-sm); margin-bottom: var(--xs); }
.docs__main h2 {
  margin-top: var(--xl);
  padding-top: var(--md);
  border-top: 1px solid var(--outline-variant);
  font-size: var(--text-headline);
}
.docs__main h3 { margin-top: var(--lg); font-size: 1.0625rem; }
.docs__main p, .docs__main li { color: var(--on-surface-variant); }
.docs__main ul, .docs__main ol { padding-left: 1.25rem; display: grid; gap: 6px; }
.docs__lede { font-size: 1.0625rem; }

/* Endpoint rows ---------------------------------------------------------- */
.ep {
  display: grid;
  gap: 6px;
  padding: var(--md) 0;
  border-bottom: 1px solid var(--outline-variant);
}
.ep__head { display: flex; align-items: center; gap: var(--sm); flex-wrap: wrap; }
.ep__path { font-family: var(--font-mono); font-size: var(--text-code); color: var(--on-surface); word-break: break-all; }
.ep__summary { margin: 0; }
.ep__note { margin: 0; font-size: 0.875rem; color: var(--on-surface-variant); opacity: 0.85; }

.verb {
  padding: 2px 8px;
  border-radius: var(--r);
  font-family: var(--font-mono);
  font-size: 0.75rem;
  font-weight: 600;
  letter-spacing: 0.04em;
}
.verb--get { background: var(--primary-10); color: var(--primary); }
.verb--post { background: var(--secondary-10); color: var(--secondary); }
.verb--put { background: var(--tertiary-10); color: var(--tertiary); }
.verb--delete { background: rgba(255, 180, 171, 0.12); color: var(--error); }

.pill {
  padding: 2px 8px;
  border: 1px solid var(--outline-variant);
  border-radius: var(--r);
  font-size: 0.75rem;
  color: var(--on-surface-variant);
}

/* Code blocks ------------------------------------------------------------ */
.docs pre {
  margin: var(--sm) 0 0;
  padding: var(--md);
  overflow-x: auto;              /* long curl lines scroll, the page does not */
  background: var(--surface-dim, #0d0d12);
  border: 1px solid var(--outline-variant);
  border-radius: var(--r-lg, 12px);
  font-family: var(--font-mono);
  font-size: var(--text-code);
  line-height: 1.6;
  color: var(--on-surface);
}
.docs code { font-family: var(--font-mono); font-size: 0.9em; }
.docs :not(pre) > code {
  padding: 1px 5px;
  background: var(--primary-05);
  border-radius: 4px;
  color: var(--primary);
}

/* Tables ----------------------------------------------------------------- */
.docs__table-wrap { overflow-x: auto; margin-top: var(--sm); }
.docs table { width: 100%; border-collapse: collapse; font-size: 0.9375rem; }
.docs th, .docs td {
  padding: 9px 12px;
  text-align: left;
  border-bottom: 1px solid var(--outline-variant);
  vertical-align: top;
}
.docs th {
  font-size: var(--text-label);
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--on-surface-variant);
  white-space: nowrap;
}
.docs td:first-child { color: var(--on-surface); }

/* Callouts --------------------------------------------------------------- */
.note {
  margin-top: var(--md);
  padding: var(--md);
  border-left: 3px solid var(--primary);
  border-radius: 0 var(--r) var(--r) 0;
  background: var(--primary-05);
}
.note--warn { border-left-color: var(--tertiary); background: var(--tertiary-10); }
.note > :last-child { margin-bottom: 0; }
.note strong { color: var(--on-surface); }

.stamp {
  margin-top: var(--xl);
  padding-top: var(--md);
  border-top: 1px solid var(--outline-variant);
  font-size: 0.8125rem;
  color: var(--on-surface-variant);
}

/* Status page ------------------------------------------------------------ */
.docs--bare { grid-template-columns: minmax(0, 1fr); max-width: 760px; }
@media (min-width: 960px) { .docs--bare { grid-template-columns: minmax(0, 1fr); } }

.status__overall {
  margin: var(--md) 0 var(--lg);
  padding: var(--md);
  border: 1px solid var(--outline-variant);
  border-radius: var(--r-lg, 12px);
  font-weight: 600;
  color: var(--on-surface);
}
.status__overall.is-up { border-color: var(--secondary-30); background: var(--secondary-10); color: var(--secondary); }
.status__overall.is-partial { border-color: var(--tertiary-30); background: var(--tertiary-10); color: var(--tertiary); }
.status__overall.is-down { border-color: rgba(255,180,171,0.35); background: rgba(255,180,171,0.1); color: var(--error); }

.status__list { display: grid; gap: 0; }
.status__row {
  display: grid;
  grid-template-columns: 12px minmax(0, 1fr) auto auto;
  gap: var(--sm);
  align-items: center;
  padding: 14px 0;
  border-bottom: 1px solid var(--outline-variant);
}
.status__name { color: var(--on-surface); font-weight: 600; }
.status__row [data-state] { color: var(--on-surface-variant); font-size: 0.9375rem; }
.status__row [data-ms] {
  min-width: 5.5rem;
  text-align: right;
  font-family: var(--font-mono);
  font-size: var(--text-code);
  color: var(--on-surface-variant);
}
@media (max-width: 560px) {
  .status__row { grid-template-columns: 12px minmax(0, 1fr) auto; }
  .status__row [data-ms] { grid-column: 2 / -1; text-align: left; min-width: 0; }
}

.status__dot { width: 10px; height: 10px; border-radius: 50%; background: var(--outline); }
.status__dot--up { background: var(--secondary); }
.status__dot--slow { background: var(--tertiary); }
.status__dot--down { background: var(--error); }
.status__dot--checking { background: var(--outline); animation: status-pulse 1.1s ease-in-out infinite; }
@keyframes status-pulse { 50% { opacity: 0.3; } }
@media (prefers-reduced-motion: reduce) { .status__dot--checking { animation: none; } }