/* ──────────────────────────────────────────────────────────────────
   grove · documentation stylesheet

   Shares the "orchard-meets-engineering" design tokens with the
   landing page (docs/index.html). If you change a token here,
   change it there too.

     deep green  #1a3d2b   canopy
     citrus      #f5a623   fruit
     cream       #f6efe2   page background
     bark        #2b1b10   deep accent

   Layout is a three-column grid on desktop:

     [ topbar ........................................... ]
     [  sidebar  |         main  article         |  toc  ]
                 [       prev / next nav         ]

   At ≤1180px the right TOC collapses.  At ≤900px the left sidebar
   collapses into a hamburger-triggered drawer and everything stacks.
   ────────────────────────────────────────────────────────────────── */

:root {
  --canopy: #1a3d2b;
  --canopy-2: #2a5a40;
  --citrus: #f5a623;
  --citrus-2: #ffb944;
  --cream: #f6efe2;
  --cream-2: #efe6d2;
  --bark: #2b1b10;
  --ink: #1a1a1a;
  --muted: #5d5b54;
  --line: #e2dac6;

  --bg: var(--cream);
  --bg-elev: #fbf6e9;
  --bg-code: #fbf6e9;
  --fg: var(--ink);
  --fg-soft: var(--muted);
  --accent: var(--canopy);
  --accent-fg: #ffffff;
  --pop: var(--citrus);
  --rule: var(--line);

  --serif: "Fraunces", "Iowan Old Style", "Palatino", Georgia, serif;
  --sans:  "Manrope", -apple-system, "Segoe UI", system-ui, sans-serif;
  --mono:  "JetBrains Mono", "SF Mono", Menlo, monospace;

  --r-sm: 6px;
  --r-md: 14px;
  --r-lg: 22px;

  --shadow: 0 1px 0 rgba(20, 14, 5, 0.04), 0 14px 28px -18px rgba(20, 14, 5, 0.18);
  --shadow-pop: 0 22px 38px -22px rgba(245, 166, 35, 0.55);

  --topbar-h: 64px;
  --content-max: 760px;
  --sidebar-w: 256px;
  --toc-w: 220px;
}

@media (prefers-color-scheme: dark) {
  :root {
    --canopy: #6dd99a;
    --canopy-2: #4cb079;
    --citrus: #ffb83a;
    --cream: #0d1410;
    --cream-2: #131c16;
    --bark: #f6efe2;

    --bg: #0a0f0c;
    --bg-elev: #121a14;
    --bg-code: #0f1713;
    --fg: #ece7d8;
    --fg-soft: #a39d8d;
    --accent: var(--canopy);
    --accent-fg: #0a0f0c;
    --rule: #1f2a23;

    --shadow: 0 1px 0 rgba(0, 0, 0, 0.6), 0 22px 50px -28px rgba(0, 0, 0, 0.7);
    --shadow-pop: 0 22px 38px -22px rgba(255, 184, 58, 0.4);
  }
}

*, *::before, *::after { box-sizing: border-box; }
html, body { margin: 0; padding: 0; }
html { -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale; }
body {
  font-family: var(--sans);
  color: var(--fg);
  background: var(--bg);
  line-height: 1.62;
  font-size: 16.5px;
  background-image:
    radial-gradient(1200px 600px at 90% -10%, rgba(245,166,35,0.10), transparent 60%),
    radial-gradient(900px 500px at -10% 30%, rgba(26,61,43,0.07), transparent 60%);
  background-attachment: fixed;
}
@media (prefers-color-scheme: dark) {
  body {
    background-image:
      radial-gradient(1200px 600px at 90% -10%, rgba(255,184,58,0.07), transparent 60%),
      radial-gradient(900px 500px at -10% 30%, rgba(109,217,154,0.05), transparent 60%);
  }
}

::selection { background: var(--citrus); color: var(--bark); }

/* ── Topbar (identical silhouette to landing page) ──────────────── */
.topbar {
  position: sticky; top: 0; z-index: 60;
  background: color-mix(in oklab, var(--bg) 86%, transparent);
  backdrop-filter: saturate(150%) blur(14px);
  -webkit-backdrop-filter: saturate(150%) blur(14px);
  border-bottom: 1px solid var(--rule);
}
.topbar-row {
  display: flex; align-items: center; justify-content: space-between;
  gap: 20px;
  height: var(--topbar-h);
  max-width: 1420px;
  margin: 0 auto;
  padding: 0 28px;
}
.topbar .brand {
  font-family: var(--serif); font-weight: 800; font-size: 22px;
  color: var(--fg); border: 0; letter-spacing: -0.01em;
  text-decoration: none;
  display: inline-flex; align-items: baseline; gap: 10px;
}
.topbar .brand .brand-suffix {
  font-family: var(--mono); font-weight: 500; font-size: 12px;
  color: var(--fg-soft); text-transform: uppercase; letter-spacing: 0.16em;
  padding: 3px 8px; border: 1px solid var(--rule); border-radius: 999px;
  background: var(--bg-elev);
  position: relative; top: -3px;
}
.topbar-links { display: flex; gap: 24px; font-weight: 500; font-size: 14.5px; align-items: center; }
.topbar-links a {
  color: var(--fg-soft); text-decoration: none; border: 0;
  padding: 6px 2px;
}
.topbar-links a:hover { color: var(--citrus); }
.topbar-links a[aria-current="page"] { color: var(--fg); border-bottom: 2px solid var(--canopy); }

.hamburger {
  display: none; cursor: pointer;
  width: 40px; height: 40px; align-items: center; justify-content: center;
  border-radius: var(--r-sm); border: 1px solid var(--rule);
  background: var(--bg-elev); color: var(--fg);
}
.hamburger svg { width: 20px; height: 20px; }

@media (max-width: 900px) {
  .topbar-links a.nav-only-wide { display: none; }
  .hamburger { display: inline-flex; }
}

/* ── Three-column doc layout ────────────────────────────────────── */
.doc-layout {
  display: grid;
  grid-template-columns: var(--sidebar-w) minmax(0, 1fr) var(--toc-w);
  gap: 48px;
  max-width: 1420px;
  margin: 0 auto;
  padding: 0 28px;
  align-items: start;
}
@media (max-width: 1180px) {
  .doc-layout { grid-template-columns: var(--sidebar-w) minmax(0, 1fr); }
  .toc { display: none; }
}
@media (max-width: 900px) {
  .doc-layout { grid-template-columns: 1fr; gap: 0; }
}

/* ── Sidebar ────────────────────────────────────────────────────── */
.sidebar {
  position: sticky;
  top: var(--topbar-h);
  max-height: calc(100vh - var(--topbar-h));
  overflow-y: auto;
  padding: 32px 0 48px;
  font-size: 14.5px;
}
.sidebar-group { margin-bottom: 22px; }
.sidebar-group-title {
  font-family: var(--mono); font-size: 11px;
  text-transform: uppercase; letter-spacing: 0.18em;
  color: var(--fg-soft); margin: 0 0 10px;
  padding-left: 10px;
}
.sidebar ul { list-style: none; margin: 0; padding: 0; }
.sidebar li { margin: 0; }
.sidebar a {
  display: block; padding: 7px 10px;
  color: var(--fg-soft); text-decoration: none; border: 0;
  border-left: 2px solid transparent;
  border-radius: 0 6px 6px 0;
  transition: color 120ms, background-color 120ms, border-color 120ms;
}
.sidebar a:hover { color: var(--fg); background: color-mix(in oklab, var(--canopy) 8%, transparent); }
.sidebar a[aria-current="page"] {
  color: var(--canopy);
  font-weight: 600;
  border-left-color: var(--canopy);
  background: color-mix(in oklab, var(--canopy) 10%, transparent);
}

@media (max-width: 900px) {
  .sidebar {
    position: fixed;
    top: var(--topbar-h);
    left: 0;
    width: min(300px, 84vw);
    max-height: calc(100vh - var(--topbar-h));
    background: var(--bg);
    border-right: 1px solid var(--rule);
    padding: 24px 18px 48px;
    transform: translateX(-110%);
    transition: transform 200ms ease;
    z-index: 55;
    box-shadow: var(--shadow);
  }
  .sidebar.open { transform: translateX(0); }
  .drawer-scrim {
    display: none;
    position: fixed; inset: var(--topbar-h) 0 0;
    background: rgba(0, 0, 0, 0.35);
    z-index: 54;
  }
  .drawer-scrim.open { display: block; }
}

/* ── Main content ───────────────────────────────────────────────── */
.doc-main {
  padding: 48px 0 96px;
  min-width: 0;
}
.doc-content {
  max-width: var(--content-max);
}

.doc-eyebrow {
  display: inline-block;
  font-family: var(--mono); font-size: 11px;
  text-transform: uppercase; letter-spacing: 0.2em;
  color: var(--citrus); margin-bottom: 14px;
}

.doc-content h1 {
  font-family: var(--serif); font-weight: 600;
  font-size: clamp(34px, 4.2vw, 44px);
  line-height: 1.08; letter-spacing: -0.02em;
  margin: 0 0 18px;
  color: var(--fg);
}
.doc-content h1 em { font-style: italic; color: var(--canopy); }

.doc-lede {
  font-size: 18px; color: var(--fg-soft);
  margin: 0 0 36px; max-width: 62ch;
}

.doc-content h2 {
  font-family: var(--serif); font-weight: 600;
  font-size: 26px; line-height: 1.2; letter-spacing: -0.01em;
  margin: 56px 0 14px;
  padding-top: 24px;
  border-top: 1px solid var(--rule);
  color: var(--fg);
  scroll-margin-top: calc(var(--topbar-h) + 12px);
}
.doc-content h2:first-of-type { border-top: 0; padding-top: 0; margin-top: 40px; }

.doc-content h3 {
  font-family: var(--serif); font-weight: 600;
  font-size: 19.5px; line-height: 1.25; letter-spacing: -0.005em;
  margin: 34px 0 10px;
  color: var(--fg);
  scroll-margin-top: calc(var(--topbar-h) + 12px);
}

.doc-content p, .doc-content ul, .doc-content ol {
  margin: 0 0 16px; max-width: 68ch;
}
.doc-content ul, .doc-content ol { padding-left: 22px; }
.doc-content li { margin: 4px 0; }
.doc-content li > p { margin: 0 0 8px; }

.doc-content a {
  color: var(--canopy);
  text-decoration: underline;
  text-decoration-color: color-mix(in oklab, var(--canopy) 40%, transparent);
  text-underline-offset: 3px;
  border: 0;
}
.doc-content a:hover {
  color: var(--citrus);
  text-decoration-color: var(--citrus);
}

.doc-content strong { font-weight: 700; color: var(--fg); }

/* Heading anchors */
.heading-anchor {
  color: var(--fg-soft);
  text-decoration: none;
  font-family: var(--mono);
  font-size: 0.75em;
  margin-left: 10px;
  opacity: 0;
  transition: opacity 120ms;
  border: 0;
}
.doc-content h2:hover .heading-anchor,
.doc-content h3:hover .heading-anchor { opacity: 1; }
.heading-anchor:hover { color: var(--citrus); }

/* Inline code */
.doc-content :not(pre) > code {
  font-family: var(--mono);
  font-size: 0.88em;
  background: color-mix(in oklab, var(--canopy) 8%, transparent);
  color: var(--fg);
  padding: 2px 6px;
  border-radius: 5px;
  border: 1px solid color-mix(in oklab, var(--canopy) 18%, transparent);
  white-space: nowrap;
}

/* Code blocks (highlight.js fills the colours) */
.doc-content pre {
  margin: 18px 0 22px;
  padding: 20px 22px;
  background: var(--bg-code);
  border: 1px solid var(--rule);
  border-radius: var(--r-md);
  box-shadow: var(--shadow);
  overflow-x: auto;
  font-family: var(--mono);
  font-size: 13.5px;
  line-height: 1.6;
}
.doc-content pre code {
  font-family: var(--mono);
  background: transparent;
  padding: 0;
  border: 0;
  white-space: pre;
}

/* Blockquote / callout */
.doc-content blockquote, .callout {
  margin: 24px 0;
  padding: 16px 18px 16px 20px;
  background: var(--bg-elev);
  border: 1px solid var(--rule);
  border-left: 3px solid var(--canopy);
  border-radius: var(--r-md);
  color: var(--fg);
  font-size: 15px;
}
.doc-content blockquote p:last-child, .callout p:last-child { margin-bottom: 0; }
.callout.callout-warn { border-left-color: var(--citrus); }
.callout.callout-warn .callout-label { color: #8a5b08; }
@media (prefers-color-scheme: dark) {
  .callout.callout-warn .callout-label { color: var(--citrus); }
}
.callout-label {
  display: inline-block;
  font-family: var(--mono); font-size: 11px;
  text-transform: uppercase; letter-spacing: 0.16em;
  color: var(--canopy);
  margin-bottom: 6px;
}

/* Tables */
.doc-content table {
  width: 100%;
  border-collapse: collapse;
  margin: 20px 0 24px;
  font-size: 14.5px;
  background: var(--bg-elev);
  border: 1px solid var(--rule);
  border-radius: var(--r-md);
  overflow: hidden;
}
.doc-content th, .doc-content td {
  padding: 12px 14px;
  text-align: left;
  border-bottom: 1px solid var(--rule);
  vertical-align: top;
}
.doc-content th {
  font-family: var(--mono); font-weight: 600;
  font-size: 11.5px; text-transform: uppercase; letter-spacing: 0.14em;
  color: var(--fg-soft);
  background: color-mix(in oklab, var(--bg-elev) 70%, var(--bg));
}
.doc-content tr:last-child td { border-bottom: 0; }

/* HR */
.doc-content hr { border: 0; border-top: 1px solid var(--rule); margin: 40px 0; }

/* Definition grid — used in API reference */
.def-grid { display: grid; gap: 22px; margin: 18px 0 24px; }
.def-grid .def {
  padding: 16px 18px;
  background: var(--bg-elev);
  border: 1px solid var(--rule);
  border-radius: var(--r-md);
}
.def .sig {
  font-family: var(--mono); font-size: 13.5px;
  color: var(--canopy);
  margin-bottom: 8px;
  display: block;
  word-break: break-word;
}
.def p { margin: 4px 0; font-size: 14.5px; color: var(--fg-soft); }

/* Prev / Next nav at page bottom */
.prev-next {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 14px;
  margin-top: 56px;
  padding-top: 32px;
  border-top: 1px solid var(--rule);
  max-width: var(--content-max);
}
.prev-next a {
  display: block;
  padding: 16px 18px;
  background: var(--bg-elev);
  border: 1px solid var(--rule);
  border-radius: var(--r-md);
  color: var(--fg);
  text-decoration: none;
  transition: transform 160ms, border-color 160ms, box-shadow 160ms;
  box-shadow: var(--shadow);
}
.prev-next a:hover {
  transform: translateY(-2px);
  border-color: var(--citrus);
  box-shadow: var(--shadow-pop);
}
.prev-next a.prev { grid-column: 1; text-align: left; }
.prev-next a.next { grid-column: 2; text-align: right; }
.prev-next .label {
  display: block;
  font-family: var(--mono); font-size: 11px;
  text-transform: uppercase; letter-spacing: 0.16em;
  color: var(--fg-soft);
  margin-bottom: 4px;
}
.prev-next .title {
  font-family: var(--serif); font-weight: 600; font-size: 17px;
  color: var(--fg);
}
.prev-next a.next.only-next {
  grid-column: 2;
}
.prev-next a.prev.only-prev {
  grid-column: 1;
}
@media (max-width: 600px) {
  .prev-next { grid-template-columns: 1fr; }
  .prev-next a.prev, .prev-next a.next { grid-column: 1; text-align: left; }
}

/* ── Right-rail "on this page" TOC ──────────────────────────────── */
.toc {
  position: sticky;
  top: var(--topbar-h);
  max-height: calc(100vh - var(--topbar-h));
  overflow-y: auto;
  padding: 48px 0;
  font-size: 13.5px;
}
.toc-title {
  font-family: var(--mono); font-size: 11px;
  text-transform: uppercase; letter-spacing: 0.18em;
  color: var(--fg-soft); margin: 0 0 10px; padding-left: 10px;
}
.toc ul { list-style: none; margin: 0; padding: 0; }
.toc a {
  display: block;
  padding: 5px 10px;
  color: var(--fg-soft); text-decoration: none; border: 0;
  border-left: 2px solid transparent;
  transition: color 120ms, border-color 120ms;
  line-height: 1.4;
}
.toc a:hover { color: var(--fg); }
.toc a.h3 { padding-left: 22px; font-size: 12.5px; }
.toc a.active {
  color: var(--canopy);
  font-weight: 600;
  border-left-color: var(--canopy);
}

/* ── Footer ─────────────────────────────────────────────────────── */
.doc-footer {
  border-top: 1px solid var(--rule);
  padding: 32px 0;
  color: var(--fg-soft); font-size: 13.5px;
  margin-top: 64px;
}
.doc-footer .inner {
  display: flex; justify-content: space-between; gap: 24px; flex-wrap: wrap;
  max-width: 1420px;
  margin: 0 auto;
  padding: 0 28px;
}
.doc-footer a { color: var(--fg-soft); text-decoration: none; border-bottom: 1px dashed currentColor; }
.doc-footer a:hover { color: var(--citrus); }
.doc-footer .leaf { color: var(--canopy); }

/* ── Utility classes for content ────────────────────────────────── */
.doc-content .pill {
  display: inline-block; font-family: var(--mono); font-size: 11px;
  padding: 2px 9px; border-radius: 999px;
  background: var(--cream-2); color: var(--bark);
  border: 1px solid var(--rule);
  white-space: nowrap;
}
@media (prefers-color-scheme: dark) {
  .doc-content .pill { background: #16201a; color: var(--fg); }
}
.doc-content .pill.ok { background: color-mix(in oklab, var(--canopy) 18%, transparent); color: var(--canopy); border-color: transparent; }
.doc-content .pill.warn { background: color-mix(in oklab, var(--citrus) 22%, transparent); color: #8a5b08; border-color: transparent; }
@media (prefers-color-scheme: dark) {
  .doc-content .pill.warn { color: var(--citrus); }
}