/* Amanu docs styling. Web-authored (there is no docs mockup in design/), but
   built entirely on the design tokens so it speaks the same language as the
   landing page: Newsreader display headings, SF Pro body, SF Mono for code and
   keys, the one oxblood accent, warm-night surfaces, hairline separation. */

/* ---------- nav (mirrors the landing nav) ---------- */
.doc-nav {
  position: sticky; top: 0; z-index: 50;
  display: flex; align-items: center; gap: 32px;
  height: 72px; padding: 0 40px;
  background: var(--surface-page);
  border-bottom: 1px solid var(--line-soft);
}
.doc-nav .nav-brand { display: flex; align-items: center; gap: 10px; margin-right: auto; }
.doc-nav .nav-brand svg { width: 34px; height: 34px; color: var(--text-primary); display: block; }
.doc-nav .wordmark {
  font-family: var(--font-display); font-weight: var(--weight-medium);
  letter-spacing: var(--tracking-display); font-size: 30px; color: var(--text-primary);
}
.doc-nav-links { display: flex; align-items: center; gap: 26px; }
.doc-nav-links a:not(.btn) {
  font-size: var(--text-web-sm); color: var(--text-secondary);
  transition: color var(--dur-instant) var(--ease-house, ease-out);
}
.doc-nav-links a:not(.btn):hover { color: var(--text-primary); }
.doc-nav-links a[aria-current="page"] { color: var(--accent); }
.btn {
  display: inline-flex; align-items: center; justify-content: center; gap: 10px;
  border-radius: var(--radius-capsule); border: 1px solid transparent;
  font-family: var(--font-app); cursor: pointer;
  transition: background var(--dur-instant) var(--ease-house, ease-out);
}
.btn-primary { background: var(--paper-0); color: var(--ink-900); }
.btn-primary:hover { background: var(--paper-100); }
.btn-nav { padding: 8px 18px; font-size: var(--text-web-sm); font-weight: var(--weight-semibold); }

/* ---------- shell: sticky TOC + content ---------- */
.doc-shell {
  margin: 0 auto; padding: 0 40px;
  display: grid; grid-template-columns: 244px minmax(0, 1fr); gap: 64px; align-items: start;
}
.doc-sidebar {
  position: sticky; top: 72px; align-self: start;
  max-height: calc(100vh - 72px); overflow-y: auto;
  padding: 44px 0;
}
.doc-sidebar .section-label {
  display: block; margin-bottom: 14px;
  font-family: var(--font-mono); font-size: var(--text-footnote);
  letter-spacing: var(--tracking-caps); text-transform: uppercase; color: var(--text-tertiary);
}
.doc-toc { list-style: none; margin: 0; padding: 0; border-left: 1px solid var(--line-soft); }
.doc-toc a {
  display: block; padding: 6px 0 6px 16px; margin-left: -1px;
  border-left: 1px solid transparent;
  font-size: var(--text-web-sm); color: var(--text-secondary);
  transition: color var(--dur-instant) var(--ease-house, ease-out), border-color var(--dur-instant) var(--ease-house, ease-out);
}
.doc-toc a:hover { color: var(--text-primary); }
.doc-toc a.active { color: var(--accent); border-left-color: var(--accent); }
.doc-toc .depth-3 a { padding-left: 28px; font-size: 13px; color: var(--text-tertiary); }
.doc-toc .depth-3 a:hover { color: var(--text-secondary); }
.doc-toc .depth-3 a.active { color: var(--accent); }

/* ---------- prose ---------- */
.doc-main { min-width: 0; padding: 44px 0 110px; }
/* Full width — fills the content column rather than a narrow reading measure. */
.doc-prose { max-width: none; }
.doc-prose .doc-eyebrow {
  font-family: var(--font-mono); font-size: var(--text-footnote);
  letter-spacing: var(--tracking-caps); text-transform: uppercase; color: var(--text-tertiary);
  margin: 0;
}
.doc-prose h1 {
  font-family: var(--font-display); font-weight: var(--weight-medium);
  font-size: clamp(34px, 4vw, 48px); line-height: var(--leading-tight);
  letter-spacing: var(--tracking-display); color: var(--text-primary); margin: 12px 0 0;
}
.doc-prose .doc-lede {
  margin: 20px 0 0; max-width: 60ch;
  font-size: var(--text-web-lg); line-height: var(--leading-relaxed);
  color: var(--text-secondary); text-wrap: pretty;
}
.doc-prose h2 {
  font-family: var(--font-display); font-weight: var(--weight-medium);
  font-size: clamp(24px, 2.4vw, 30px); letter-spacing: var(--tracking-display);
  color: var(--text-primary); margin: 60px 0 0; padding-top: 28px;
  border-top: 1px solid var(--line-soft); scroll-margin-top: 88px;
}
.doc-prose h3 {
  font-family: var(--font-display); font-weight: var(--weight-medium);
  font-size: var(--text-web-lg); letter-spacing: var(--tracking-display);
  color: var(--text-primary); margin: 34px 0 0; scroll-margin-top: 88px;
}
.doc-prose p {
  margin: 16px 0 0; font-size: var(--text-web-body); line-height: var(--leading-relaxed);
  color: var(--text-secondary); text-wrap: pretty;
}
/* Links follow the site convention: color, not a persistent underline.
   Oxblood-toned, with an underline only on hover for affordance. */
.doc-prose a { color: var(--text-link); text-decoration: none; }
.doc-prose a:hover { color: var(--accent); text-decoration: underline; text-underline-offset: 3px; text-decoration-thickness: 1px; }
.doc-prose strong { color: var(--text-primary); font-weight: var(--weight-semibold); }
.doc-prose em { color: var(--text-primary); }
.doc-prose ul, .doc-prose ol {
  margin: 14px 0 0; padding-left: 22px;
  color: var(--text-secondary); font-size: var(--text-web-body); line-height: var(--leading-relaxed);
}
.doc-prose li { margin: 8px 0 0; text-wrap: pretty; }
.doc-prose li::marker { color: var(--text-tertiary); }
.doc-prose code {
  font-family: var(--font-mono); font-size: 0.86em;
  background: var(--surface-sunken); border: 1px solid var(--line-soft);
  border-radius: var(--radius-sm); padding: 1px 6px; color: var(--text-primary);
}
.doc-prose pre {
  margin: 20px 0 0; padding: 16px 18px;
  background: var(--surface-sunken); border: 1px solid var(--line-soft);
  border-radius: var(--radius-md); overflow-x: auto;
}
.doc-prose pre code { background: none; border: 0; padding: 0; font-size: var(--text-body); color: var(--text-secondary); }
.doc-prose kbd {
  display: inline-flex; align-items: center; justify-content: center;
  min-width: 24px; height: 24px; padding: 0 7px;
  border-radius: var(--radius-sm); border: 1px solid var(--line-strong); border-bottom-width: 2px;
  background: var(--surface-card); font-family: var(--font-mono); font-size: 12px;
  color: var(--text-secondary); vertical-align: middle;
}
.doc-prose table { width: 100%; margin: 22px 0 0; border-collapse: collapse; font-size: var(--text-web-sm); }
.doc-prose thead th {
  text-align: left; font-family: var(--font-mono); font-size: var(--text-footnote);
  letter-spacing: var(--tracking-caps); text-transform: uppercase; color: var(--text-tertiary);
  font-weight: var(--weight-medium); padding: 0 16px 10px 0; border-bottom: 1px solid var(--line-strong);
}
.doc-prose tbody td { padding: 12px 16px 12px 0; border-bottom: 1px solid var(--line-soft); color: var(--text-secondary); vertical-align: top; }
.doc-prose tbody td:first-child { font-family: var(--font-mono); color: var(--text-primary); white-space: nowrap; }

/* callout */
.doc-note {
  margin: 24px 0 0; padding: 16px 18px;
  border: 1px solid var(--line-soft); border-left: 2px solid var(--accent);
  border-radius: var(--radius-md); background: var(--surface-window);
}
.doc-note p { margin: 0; font-size: var(--text-web-sm); }
.doc-note p + p { margin-top: 8px; }
.doc-note .doc-note-label {
  font-family: var(--font-mono); font-size: var(--text-footnote);
  letter-spacing: var(--tracking-caps); text-transform: uppercase; color: var(--accent);
}

/* docs footer */
.doc-foot { border-top: 1px solid var(--line-soft); margin-top: 72px; padding-top: 26px; }
.doc-foot p {
  margin: 0; font-family: var(--font-display); font-style: italic;
  font-size: var(--text-web-sm); color: var(--text-tertiary);
}
.doc-foot .copy { font-family: var(--font-mono); font-style: normal; font-size: var(--text-footnote); margin-top: 8px; }
.doc-foot-links { display: flex; flex-wrap: wrap; gap: 22px; margin-bottom: 22px; }
.doc-foot-links a { font-size: var(--text-web-sm); color: var(--text-secondary); text-decoration: none; }
.doc-foot-links a:hover { color: var(--text-primary); }

/* back to top (matches the landing) */
.to-top {
  position: fixed; right: 28px; bottom: 28px; z-index: 60;
  width: 46px; height: 46px; display: inline-flex; align-items: center; justify-content: center;
  border-radius: var(--radius-capsule); border: 1px solid var(--line-strong);
  background: var(--surface-card); color: var(--accent); cursor: pointer;
  box-shadow: var(--shadow-3);
  opacity: 0; transform: translateY(10px); pointer-events: none;
  transition: opacity var(--dur-base) var(--ease-house, ease-out), transform var(--dur-base) var(--ease-house, ease-out), background var(--dur-instant) var(--ease-house, ease-out);
}
.to-top.show { opacity: 1; transform: none; pointer-events: auto; }
.to-top:hover { background: var(--surface-raised); }
.to-top:active { transform: scale(0.96); }
.to-top svg { width: 22px; height: 22px; display: block; }

/* ---------- responsive ---------- */
/* Scroll-reveal — a subtle one-way fade-up per block as it enters the viewport,
   matching the landing's motion. Gated behind .doc-anim, which JS adds only when
   motion is allowed and IntersectionObserver exists, so content is fully visible
   without JS and under reduced motion. */
@media (prefers-reduced-motion: no-preference) {
  .doc-anim .doc-prose > * {
    opacity: 0; transform: translateY(12px);
    transition: opacity 0.55s var(--ease-house, ease-out), transform 0.55s var(--ease-house, ease-out);
  }
  .doc-anim .doc-prose > *.in { opacity: 1; transform: none; }
  .doc-anim .doc-sidebar { opacity: 0; transition: opacity 0.7s var(--ease-house, ease-out); }
  .doc-anim .doc-sidebar.in { opacity: 1; }
}

@media (max-width: 900px) {
  .doc-shell { grid-template-columns: 1fr; gap: 0; }
  .doc-sidebar { display: none; }
  .doc-main { padding-top: 32px; }
}
@media (max-width: 720px) {
  .doc-nav { padding: 0 20px; gap: 16px; }
  .doc-nav-links { gap: 16px; }
  .doc-nav-links a:not(.btn) { display: none; }
  .doc-shell { padding: 0 20px; }
  .to-top { right: 16px; bottom: 16px; }
}