/* ============================================================================
   Ryvem — docs layout: sidebar + content column, prose, mobile collapse
   ============================================================================ */

.docs {
  display: grid;
  grid-template-columns: var(--sidebar-w) minmax(0, 1fr);
  gap: var(--sp-7);
  align-items: start;
  padding-block: var(--sp-6) var(--sp-9);
}

/* ---- sidebar ----------------------------------------------------------- */
.docs__sidebar {
  position: sticky;
  top: calc(var(--nav-h) + var(--sp-5));
  align-self: start;
  max-height: calc(100vh - var(--nav-h) - var(--sp-7));
  overflow-y: auto;
}
.docs-nav__group + .docs-nav__group { margin-top: var(--sp-5); }
.docs-nav__title {
  font-size: var(--fs-xs);
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--faint);
  padding: 0 var(--sp-3);
  margin-bottom: var(--sp-2);
}
.docs-nav__link {
  display: block;
  padding: 0.4rem var(--sp-3);
  margin-bottom: 2px;
  font-size: var(--fs-sm);
  color: var(--muted);
  text-decoration: none;
  border-radius: var(--r-sm);
  border-left: 2px solid transparent;
  transition: color var(--t) var(--ease), background-color var(--t) var(--ease);
}
.docs-nav__link:hover { color: var(--text); background: var(--surface); text-decoration: none; }
.docs-nav__link.is-active {
  color: var(--text);
  background: var(--accent-soft);
  border-left-color: var(--accent);
  font-weight: var(--fw-medium);
}

/* Sidebar toggle button — mobile only */
.docs__sidebar-toggle {
  display: none;
  align-items: center;
  gap: var(--sp-2);
  width: 100%;
  padding: var(--sp-3) var(--sp-4);
  margin-bottom: var(--sp-4);
  font-size: var(--fs-sm);
  font-weight: var(--fw-medium);
  color: var(--text);
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--r-md);
}
.docs__sidebar-toggle svg { width: 15px; height: 15px; transition: transform var(--t) var(--ease); }
.docs__sidebar-toggle[aria-expanded="true"] svg { transform: rotate(180deg); }

/* ---- content column ---------------------------------------------------- */
.docs__main { min-width: 0; max-width: 760px; }
.docs__header { margin-bottom: var(--sp-6); }
.docs__eyebrow { margin-bottom: var(--sp-3); }
.docs__header h1 { margin-bottom: var(--sp-3); }
.docs__header .lede { font-size: var(--fs-md); color: var(--muted); line-height: 1.55; }

/* ---- prose (rendered documentation content) --------------------------- */
.prose { font-size: var(--fs-base); line-height: var(--lh-body); color: var(--text); }
.prose > * + * { margin-top: var(--sp-4); }
.prose h2 {
  font-size: var(--fs-xl);
  margin-top: var(--sp-7);
  padding-top: var(--sp-2);
  scroll-margin-top: calc(var(--nav-h) + var(--sp-4));
}
.prose h3 {
  font-size: var(--fs-md);
  margin-top: var(--sp-6);
  scroll-margin-top: calc(var(--nav-h) + var(--sp-4));
}
.prose h2 + p, .prose h3 + p { margin-top: var(--sp-3); }
.prose p, .prose li { color: var(--text); }
.prose strong { font-weight: var(--fw-semi); }
.prose a { text-decoration: none; border-bottom: 1px solid color-mix(in srgb, var(--accent) 40%, transparent); }
.prose a:hover { border-bottom-color: var(--accent); }
.prose ul, .prose ol { padding-left: 1.35em; }
.prose li + li { margin-top: var(--sp-2); }
.prose li::marker { color: var(--faint); }
.prose .code { margin: var(--sp-4) 0; }
.prose blockquote {
  margin: var(--sp-4) 0;
  padding: var(--sp-1) var(--sp-4);
  border-left: 3px solid var(--border);
  color: var(--muted);
}

/* a small ordered "what the wizard asks" list style, reused across docs */
.field-list { display: grid; gap: var(--sp-3); margin: var(--sp-4) 0; }
.field-list__item {
  padding: var(--sp-4);
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--r-md);
}
.field-list__item h4 { font-size: var(--fs-sm); margin-bottom: var(--sp-1); }
.field-list__item p { font-size: var(--fs-sm); color: var(--muted); margin: 0; }
.field-list__item code { font-family: var(--mono); }

/* ---- responsive -------------------------------------------------------- */
@media (max-width: 900px) {
  .docs { grid-template-columns: 1fr; gap: var(--sp-4); }
  .docs__sidebar-toggle { display: flex; }
  .docs__sidebar {
    position: static;
    max-height: none;
    overflow: visible;
    margin-bottom: var(--sp-4);
  }
  .docs__sidebar:not(.is-open) { display: none; }
  .docs__main { max-width: none; }
}