/* ============================================================================
   docs.css — shared stylesheet for the konareef /docs/ section.

   Self-contained: re-declares the site palette tokens so each static docs page
   is standalone (the marketing index.html keeps its own CSS inline). Reuses the
   konareef cyan/green brand (fonts: Inter body, Manrope headings, JetBrains
   Mono code). Layout = fixed top nav + sticky left sidebar + content column,
   collapsing to a single column on narrow viewports.

   Structure:
     - Tokens & base
     - Top nav (mirrors site-nav from index.html)
     - Docs shell: sidebar + content
     - Typography, code blocks, tables, callouts
     - Cards (landing learning-map)
     - Buttons, prev/next, footer
     - Responsive
   ========================================================================== */

/* ── Tokens & base ────────────────────────────────────────────────────── */
:root {
  --bg-deepest: #061318;
  --bg:         #07171E;
  --bg2:        #0A1B24;
  --surface:    #0F2A36;
  --teal-deep:  #028090;
  --teal:       #00A896;
  --mint:       #02C39A;
  --mint-soft:  #6FE3CF;
  --ink:        #F3F8F8;
  --ink-muted:  #B9D6D2;
  --ink-dim:    #5B7480;

  --nav-h: 4rem;
  --sidebar-w: 16rem;
  --content-max: 52rem;
  --radius: 12px;
  --border: 1px solid rgba(0, 168, 150, 0.15);
}

*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
html { scroll-behavior: smooth; }
body {
  font-family: 'Inter', sans-serif;
  background: var(--bg);
  color: var(--ink);
  line-height: 1.65;
  overflow-x: hidden;
  -webkit-font-smoothing: antialiased;
}
a { color: var(--mint); text-decoration: none; }
a:hover { color: var(--mint-soft); }
img { max-width: 100%; display: block; }

/* ── Top nav (mirrors index.html .site-nav) ───────────────────────────── */
nav.site-nav {
  position: fixed; top: 0; left: 0; right: 0; z-index: 100;
  display: flex; align-items: center; justify-content: space-between;
  height: var(--nav-h); padding: 0 2rem;
  background: rgba(7, 23, 30, 0.85);
  backdrop-filter: blur(12px); -webkit-backdrop-filter: blur(12px);
  border-bottom: var(--border);
}
.nav-logo-wrap { display: flex; align-items: center; }
.nav-logo {
  display: flex; align-items: center; gap: 0.55rem;
  font-family: 'Manrope', system-ui, sans-serif;
  font-size: 1.3rem; font-weight: 800; letter-spacing: -0.02em;
}
.nav-logo-icon { height: 1.9rem; width: auto; }
.nav-logo .wordmark { display: inline-flex; align-items: baseline; }
.nav-logo .kona { color: var(--ink); }
.nav-logo .reef { color: var(--mint); }
.nav-logo .dot { font-size: 0.85rem; color: var(--teal); font-weight: 600; margin-left: 2px; }
.nav-badge {
  font-size: 0.6rem; font-weight: 700; letter-spacing: 0.08em; text-transform: uppercase;
  background: var(--teal-deep); color: var(--ink);
  padding: 0.2rem 0.55rem; border-radius: 100px; margin-left: 0.4rem;
}
.nav-links { display: flex; gap: 1.75rem; font-size: 0.9rem; color: var(--ink-muted); }
.nav-links a { color: var(--ink-muted); }
.nav-links a:hover, .nav-links a[aria-current="page"] { color: var(--ink); }
.nav-cta {
  border: 2px solid var(--teal); color: var(--teal);
  padding: 0.45rem 1.1rem; border-radius: 100px;
  font-size: 0.85rem; font-weight: 600; transition: all 0.2s;
}
.nav-cta:hover { background: var(--teal); color: var(--bg-deepest); }

/* ── Docs shell: sidebar + content ────────────────────────────────────── */
.docs-shell {
  display: grid;
  grid-template-columns: var(--sidebar-w) minmax(0, 1fr);
  gap: 2.5rem;
  max-width: 76rem; margin: 0 auto;
  padding: calc(var(--nav-h) + 2.5rem) 2rem 5rem;
}
.docs-sidebar {
  position: sticky; top: calc(var(--nav-h) + 2rem);
  align-self: start; height: fit-content;
  max-height: calc(100vh - var(--nav-h) - 3rem); overflow-y: auto;
  font-size: 0.9rem;
}
.docs-sidebar h4 {
  font-family: 'Manrope', sans-serif; font-size: 0.7rem; font-weight: 800;
  letter-spacing: 0.1em; text-transform: uppercase; color: var(--ink-dim);
  margin: 1.4rem 0 0.5rem;
}
.docs-sidebar h4:first-child { margin-top: 0; }
.docs-sidebar ul { list-style: none; }
.docs-sidebar li { margin: 0.1rem 0; }
.docs-sidebar a {
  display: block; padding: 0.35rem 0.7rem; border-radius: 8px;
  color: var(--ink-muted); border-left: 2px solid transparent;
}
.docs-sidebar a:hover { color: var(--ink); background: rgba(255, 255, 255, 0.03); }
.docs-sidebar a[aria-current="page"] {
  color: var(--mint); background: rgba(2, 195, 154, 0.08);
  border-left-color: var(--mint); font-weight: 600;
}
.docs-sidebar .soon {
  display: block; padding: 0.35rem 0.7rem; border-left: 2px solid transparent;
  color: var(--ink-dim); font-size: 0.85rem; cursor: default;
}
.docs-content { min-width: 0; max-width: var(--content-max); }

/* ── Typography ───────────────────────────────────────────────────────── */
.docs-content h1 {
  font-family: 'Manrope', sans-serif; font-size: 2.4rem; font-weight: 800;
  letter-spacing: -0.02em; line-height: 1.15; margin-bottom: 0.75rem;
}
.docs-content h2 {
  font-family: 'Manrope', sans-serif; font-size: 1.5rem; font-weight: 700;
  letter-spacing: -0.01em; margin: 2.75rem 0 0.9rem;
  padding-top: 1.25rem; border-top: var(--border);
}
.docs-content h3 { font-size: 1.15rem; font-weight: 700; margin: 1.9rem 0 0.6rem; color: var(--ink); }
.docs-content p { color: var(--ink-muted); margin: 0.9rem 0; }
.docs-content strong { color: var(--ink); font-weight: 600; }
.docs-content ul, .docs-content ol { color: var(--ink-muted); margin: 0.9rem 0 0.9rem 1.4rem; }
.docs-content li { margin: 0.35rem 0; }
.lead { font-size: 1.15rem; color: var(--ink-muted); margin: 1rem 0 2rem; }

/* ── Code ─────────────────────────────────────────────────────────────── */
code {
  font-family: 'JetBrains Mono', monospace; font-size: 0.85em;
  background: rgba(2, 195, 154, 0.1); color: var(--mint-soft);
  padding: 0.15em 0.4em; border-radius: 5px;
}
pre {
  background: var(--bg2); border: var(--border); border-left: 3px solid var(--teal);
  border-radius: var(--radius); padding: 1.1rem 1.25rem; margin: 1.25rem 0;
  overflow-x: auto; font-size: 0.85rem; line-height: 1.55;
}
pre code {
  background: none; color: var(--ink); padding: 0; border-radius: 0;
  font-size: inherit; white-space: pre;
}

/* ── Tables ───────────────────────────────────────────────────────────── */
.docs-content table {
  width: 100%; border-collapse: collapse; margin: 1.25rem 0; font-size: 0.9rem;
}
.docs-content th, .docs-content td {
  text-align: left; padding: 0.55rem 0.8rem; border-bottom: var(--border);
  vertical-align: top;
}
.docs-content th { color: var(--ink); font-family: 'Manrope', sans-serif; font-weight: 700; }
.docs-content td { color: var(--ink-muted); }
.docs-content tr:hover td { background: rgba(255, 255, 255, 0.02); }

/* ── Callouts ─────────────────────────────────────────────────────────── */
.callout {
  border: var(--border); border-radius: var(--radius);
  padding: 1rem 1.2rem; margin: 1.5rem 0; background: var(--surface);
  border-left: 3px solid var(--teal);
}
.callout.note    { border-left-color: var(--teal); }
.callout.warning { border-left-color: #E0A030; background: rgba(224, 160, 48, 0.06); }
.callout .callout-title {
  font-family: 'Manrope', sans-serif; font-weight: 700; font-size: 0.85rem;
  text-transform: uppercase; letter-spacing: 0.06em; color: var(--ink);
  margin-bottom: 0.35rem;
}
.callout p:last-child { margin-bottom: 0; }

/* ── Learning-map cards ───────────────────────────────────────────────── */
.doc-card-grid {
  display: grid; grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr));
  gap: 1.1rem; margin: 1.75rem 0;
}
.doc-card {
  display: block; background: var(--surface); border: var(--border);
  border-radius: var(--radius); padding: 1.3rem 1.4rem; transition: all 0.2s;
}
.doc-card:hover {
  transform: translateY(-3px); border-color: rgba(0, 168, 150, 0.4);
  box-shadow: 0 10px 30px rgba(0, 0, 0, 0.35);
}
.doc-card .doc-card-icon { font-size: 1.5rem; margin-bottom: 0.6rem; }
.doc-card h3 {
  font-family: 'Manrope', sans-serif; font-size: 1.05rem; font-weight: 700;
  color: var(--ink); margin: 0 0 0.35rem;
}
.doc-card p { color: var(--ink-muted); font-size: 0.9rem; margin: 0; }

/* ── Buttons ──────────────────────────────────────────────────────────── */
.btn {
  display: inline-block; font-weight: 600; font-size: 0.95rem;
  padding: 0.7rem 1.4rem; border-radius: 100px; transition: all 0.2s;
}
.btn-primary { background: var(--mint); color: var(--bg-deepest); }
.btn-primary:hover { background: var(--mint-soft); color: var(--bg-deepest); }
.btn-secondary { border: 2px solid var(--teal); color: var(--teal); }
.btn-secondary:hover { background: var(--teal); color: var(--bg-deepest); }
.btn-row { display: flex; flex-wrap: wrap; gap: 0.9rem; margin: 1.75rem 0; }

/* ── Prev / next ──────────────────────────────────────────────────────── */
.docs-pager {
  display: flex; justify-content: space-between; gap: 1rem;
  margin-top: 3.5rem; padding-top: 1.5rem; border-top: var(--border);
}
.docs-pager a {
  flex: 1; padding: 0.9rem 1.1rem; border: var(--border); border-radius: var(--radius);
  color: var(--ink-muted); background: var(--surface); transition: all 0.2s;
}
.docs-pager a:hover { color: var(--ink); border-color: rgba(0, 168, 150, 0.4); }
.docs-pager .pager-dir { font-size: 0.7rem; text-transform: uppercase; letter-spacing: 0.08em; color: var(--ink-dim); }
.docs-pager .pager-title { font-family: 'Manrope', sans-serif; font-weight: 700; color: var(--ink); }
.docs-pager .next { text-align: right; }

/* ── Footer ───────────────────────────────────────────────────────────── */
footer.site-footer {
  display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between;
  gap: 1rem; padding: 2rem; border-top: var(--border); color: var(--ink-dim);
  font-size: 0.85rem;
}
.footer-logo { display: flex; align-items: center; gap: 0.5rem; font-family: 'Manrope', sans-serif; font-weight: 800; }
.footer-logo-icon { height: 1.5rem; }
.footer-links { display: flex; gap: 1.25rem; }
.footer-links a { color: var(--ink-muted); }
.footer-links a:hover { color: var(--ink); }

/* ── Responsive ───────────────────────────────────────────────────────── */
@media (max-width: 860px) {
  nav.site-nav { padding: 0 1.25rem; }
  .nav-links { display: none; }
  .docs-shell { grid-template-columns: 1fr; gap: 0; padding: calc(var(--nav-h) + 1.75rem) 1.25rem 4rem; }
  .docs-sidebar {
    position: static; max-height: none; overflow: visible;
    margin-bottom: 2rem; padding-bottom: 1.5rem; border-bottom: var(--border);
  }
  .docs-content h1 { font-size: 1.9rem; }
  .docs-pager { flex-direction: column; }
}