/* ═══════════════════════════════════════════════════════════════════════════
   Ginkgo documentation theme — "Botanical Modern"

   Light, crisp, contemporary. One confident teal accent, drawn straight from
   the ginkgo-leaf logo mark.

   Display  Space Grotesk — technical grotesk with a quirky lowercase "g"
   Body     Hanken Grotesk — clean modern sans
   Mono     IBM Plex Mono — engineered monospace
   ═══════════════════════════════════════════════════════════════════════════ */

@import url('https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@500..700&family=Hanken+Grotesk:ital,wght@0,300..700;1,400..600&family=IBM+Plex+Mono:wght@400;500;600&display=swap');


/* ─── Design tokens ───────────────────────────────────────────────────────── */
:root {
  /* Paper & surfaces */
  --gk-paper:        #fbfbf9;
  --gk-paper-raised: #ffffff;
  --gk-paper-sunken: #f3f3ee;
  --gk-paper-tint:   #edeee4;

  /* Ink */
  --gk-ink-950: #16170f;
  --gk-ink-800: #292a20;
  --gk-ink-700: #3a3b30;
  --gk-ink-500: #63655a;
  --gk-ink-400: #8a8b7e;

  /* Hairlines */
  --gk-line:        #e6e6dd;
  --gk-line-strong: #d7d7ca;

  /* Teal — the single accent, drawn from the ginkgo-leaf logo mark */
  --gk-green-950: #062120;
  --gk-green-900: #093534;
  --gk-green-800: #0b4b49;
  --gk-green-700: #006e70;
  --gk-green-600: #04898c;
  --gk-green-500: #14a3a6;
  --gk-green-300: #7ed3d3;
  --gk-green-100: #cdeeee;
  --gk-green-50:  #eefaf9;

  /* Font stacks */
  --gk-font-body:    "Hanken Grotesk", -apple-system, "Segoe UI", system-ui, sans-serif;
  --gk-font-display: "Space Grotesk", -apple-system, "Segoe UI", system-ui, sans-serif;
  --gk-font-mono:    "IBM Plex Mono", "SFMono-Regular", "Consolas", monospace;

  /* Furo also reads these names directly */
  --font-stack:           var(--gk-font-body);
  --font-stack--headings: var(--gk-font-display);
  --font-stack--monospace:var(--gk-font-mono);
}


/* ─── Furo colour mapping ─────────────────────────────────────────────────────
   Furo declares its theme variables on `body`, with dark variants at higher
   specificity. `body:not([data-theme="dark"])` outranks the light defaults and
   loads after furo.css, so the palette below always wins — the site stays
   light regardless of OS colour-scheme. */
body:not([data-theme="dark"]) {
  --font-stack:           var(--gk-font-body);
  --font-stack--headings: var(--gk-font-display);
  --font-stack--monospace:var(--gk-font-mono);

  /* Content surfaces */
  --color-background-primary:   var(--gk-paper);
  --color-background-secondary: var(--gk-paper-sunken);
  --color-background-hover:     var(--gk-paper-tint);
  --color-background-hover--transparent: transparent;
  --color-background-border:    var(--gk-line);
  --color-background-item:      var(--gk-paper-sunken);

  /* Text */
  --color-foreground-primary:   var(--gk-ink-950);
  --color-foreground-secondary: var(--gk-ink-700);
  --color-foreground-muted:     var(--gk-ink-400);
  --color-foreground-border:    var(--gk-line);

  /* Brand & links */
  --color-brand-primary: var(--gk-green-700);
  --color-brand-content: var(--gk-green-700);
  --color-brand-visited: var(--gk-green-800);
  --color-link:                  var(--gk-green-700);
  --color-link--hover:           var(--gk-green-600);
  --color-link-underline:        rgba(0, 110, 112, 0.28);
  --color-link-underline--hover: var(--gk-green-600);

  /* Code */
  --color-code-background: var(--gk-paper-sunken);
  --color-code-foreground: var(--gk-ink-800);

  /* Selection / search highlight */
  --color-highlighted-background: var(--gk-green-100);
  --color-highlight-on-target:    var(--gk-green-50);

  /* Mobile header */
  --color-header-background: var(--gk-paper-sunken);
  --color-header-border:     var(--gk-line);
  --color-header-text:       var(--gk-ink-950);

  /* Sidebar — now light */
  --color-sidebar-background:                      var(--gk-paper-sunken);
  --color-sidebar-background-border:               var(--gk-line);
  --color-sidebar-brand-text:                      var(--gk-ink-950);
  --color-sidebar-caption-text:                    var(--gk-ink-400);
  --color-sidebar-link-text:                       var(--gk-ink-700);
  --color-sidebar-link-text--top-level:            var(--gk-ink-800);
  --color-sidebar-item-background--hover:          var(--gk-paper-tint);
  --color-sidebar-item-background--current:        var(--gk-green-50);
  --color-sidebar-item-expander-background--hover: var(--gk-paper-tint);
  --color-sidebar-search-background:               var(--gk-paper-raised);
  --color-sidebar-search-background--focus:        var(--gk-paper-raised);
  --color-sidebar-search-border:                   var(--gk-line-strong);
  --color-sidebar-search-foreground:               var(--gk-ink-800);
  --color-sidebar-search-icon:                     var(--gk-ink-400);

  /* Admonitions — note/tip pulled into the green family; warnings stay warm */
  --color-admonition-title--note:            var(--gk-green-800);
  --color-admonition-title-background--note: var(--gk-green-50);
  --color-admonition-title--tip:             var(--gk-green-800);
  --color-admonition-title-background--tip:  var(--gk-green-50);
  --color-admonition-title--important:       var(--gk-green-800);
  --color-admonition-title-background--important: var(--gk-green-50);
}


/* ─── Base ────────────────────────────────────────────────────────────────── */
html {
  scroll-behavior: smooth;
  scroll-padding-top: 1.25rem;
}

body {
  font-family: var(--gk-font-body);
  background: var(--gk-paper);
  color: var(--gk-ink-800);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  font-optical-sizing: auto;
}

::selection {
  background: var(--gk-green-100);
  color: var(--gk-green-950);
}


/* ─── Sidebar ─────────────────────────────────────────────────────────────── */
.sidebar-drawer,
.sidebar-container,
.sidebar-sticky {
  background: var(--gk-paper-sunken);
}

.sidebar-drawer {
  border-right: 1px solid var(--gk-line);
}

.sidebar-brand {
  padding-bottom: 0.4rem;
}

.sidebar-brand-text {
  font-family: var(--gk-font-display);
  font-size: 1.4rem;
  font-weight: 600;
  letter-spacing: -0.01em;
  color: var(--gk-ink-950) !important;
}

/* Thin green rule under the brand block */
.sidebar-brand::after {
  content: "";
  display: block;
  width: 2rem;
  height: 2px;
  margin-top: 0.7rem;
  border-radius: 2px;
  background: var(--gk-green-600);
}

/* Section caption labels */
.sidebar-tree .caption-text {
  font-family: var(--gk-font-body);
  font-size: 0.66rem;
  font-weight: 700;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--gk-ink-400);
}

.sidebar-tree .reference {
  transition: color 0.12s ease;
}

/* Current page — green text with a green indicator bar */
.sidebar-tree .current-page > .reference {
  color: var(--gk-green-700) !important;
  font-weight: 600;
  box-shadow: inset 2px 0 0 var(--gk-green-600);
}

.sidebar-search-container input {
  background: var(--gk-paper-raised);
  border: 1px solid var(--gk-line-strong);
  border-radius: 8px;
  color: var(--gk-ink-800);
  transition: border-color 0.15s ease, box-shadow 0.15s ease;
}

.sidebar-search-container input:focus {
  outline: none;
  border-color: var(--gk-green-500);
  box-shadow: 0 0 0 3px var(--gk-green-50);
}

.sidebar-search-container input::placeholder {
  color: var(--gk-ink-400);
}

/* Light-only site — keep the theme toggle hidden */
.theme-toggle-container {
  display: none !important;
}


/* ─── Typography ──────────────────────────────────────────────────────────── */
h1, h2,
.sidebar-brand-text,
.toc-title {
  font-family: var(--gk-font-display);
}

.content h1 {
  font-family: var(--gk-font-display);
  font-size: clamp(2.3rem, 4.6vw, 3.4rem);
  font-weight: 600;
  line-height: 1.08;
  letter-spacing: -0.015em;
  color: var(--gk-ink-950);
  margin-bottom: 0.6rem;
}

.content h2 {
  font-family: var(--gk-font-display);
  font-size: clamp(1.5rem, 3vw, 2rem);
  font-weight: 600;
  letter-spacing: -0.01em;
  color: var(--gk-ink-950);
  margin-top: 2.8rem;
  padding-top: 1.4rem;
  border-top: 1px solid var(--gk-line);
}

/* h3–h6 — clean sans, deep green for a quiet botanical tie */
.content h3,
.content h4,
.content h5,
.content h6 {
  font-family: var(--gk-font-body);
  font-weight: 700;
  letter-spacing: -0.005em;
}

.content h3 {
  font-size: 1.16rem;
  color: var(--gk-green-800);
  margin-top: 2rem;
}

.content h4 {
  font-size: 1rem;
  color: var(--gk-ink-950);
  margin-top: 1.6rem;
}

.content p,
.content li {
  font-size: 1.02rem;
  line-height: 1.72;
  color: var(--gk-ink-700);
}

.content {
  max-width: 51rem;
}

/* First h2 right after the h1 needs no divider rule */
.content h1 + h2,
.content > section > h2:first-of-type {
  border-top: none;
  margin-top: 1.4rem;
  padding-top: 0;
}

/* Content links — thin green underline that warms on hover */
.content a.reference {
  color: var(--gk-green-700);
  text-decoration: underline;
  text-decoration-color: rgba(0, 110, 112, 0.3);
  text-decoration-thickness: 1px;
  text-underline-offset: 0.18em;
  transition: color 0.12s ease, text-decoration-color 0.12s ease;
}

.content a.reference:hover {
  color: var(--gk-green-600);
  text-decoration-color: var(--gk-green-600);
}


/* ─── Code ────────────────────────────────────────────────────────────────── */
div.highlight,
pre {
  border: 1px solid var(--gk-line);
  border-radius: 12px;
  background: var(--gk-paper-sunken);
}

.highlight pre,
pre {
  font-family: var(--gk-font-mono);
  font-size: 0.85rem;
  line-height: 1.6;
}

code.literal {
  font-family: var(--gk-font-mono);
  background: var(--gk-green-50);
  border: 1px solid var(--gk-green-100);
  border-radius: 5px;
  padding: 0.08em 0.38em;
  font-size: 0.86em;
  color: var(--gk-green-800);
}

/* sphinx-copybutton */
.highlight button.copybtn {
  border-radius: 6px;
}


/* ─── Tables ──────────────────────────────────────────────────────────────── */
table.docutils {
  border: 1px solid var(--gk-line);
  border-radius: 10px;
  overflow: hidden;
  font-size: 0.96rem;
}

table.docutils thead {
  background: var(--gk-paper-sunken);
}

table.docutils thead th {
  font-family: var(--gk-font-body);
  font-weight: 700;
  font-size: 0.72rem;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--gk-ink-500);
  padding: 0.6rem 0.9rem;
  border-bottom: 1px solid var(--gk-line);
}

table.docutils td {
  padding: 0.55rem 0.9rem;
  border-color: var(--gk-line);
}


/* ─── Right-hand table of contents ────────────────────────────────────────── */
.toc-title {
  font-family: var(--gk-font-body);
  font-size: 0.66rem;
  font-weight: 700;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--gk-ink-400);
}

.toc-tree a {
  font-size: 0.86rem;
  color: var(--gk-ink-500);
  transition: color 0.12s ease;
}

.toc-tree a:hover,
.toc-tree li.scroll-current > a {
  color: var(--gk-green-700);
  text-decoration: none;
}

.toc-tree li.scroll-current > a {
  font-weight: 600;
}


/* ─── Homepage: feature & contents cards ──────────────────────────────────── */
.quick-grid,
.contents-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr));
  gap: 0.9rem;
  margin: 1.5rem 0 2.4rem;
}

.quick-card,
.contents-block {
  padding: 1.3rem 1.35rem;
  background: var(--gk-paper-raised);
  border: 1px solid var(--gk-line);
  border-radius: 16px;
  transition: border-color 0.15s ease, box-shadow 0.15s ease,
              transform 0.15s ease;
}

.quick-card:hover {
  border-color: var(--gk-green-300);
  box-shadow: 0 14px 30px -20px rgba(9, 53, 52, 0.45);
  transform: translateY(-2px);
}

/* Green accent chip above each feature card */
.quick-card::before {
  content: "";
  display: block;
  width: 26px;
  height: 3px;
  margin-bottom: 0.85rem;
  border-radius: 2px;
  background: var(--gk-green-600);
}

.quick-card h3 {
  margin: 0 0 0.4rem !important;
  font-family: var(--gk-font-body);
  font-size: 0.8rem;
  font-weight: 700;
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: var(--gk-ink-950);
}

.quick-card p {
  margin: 0;
  font-size: 0.94rem;
  line-height: 1.58;
  color: var(--gk-ink-500);
}

.contents-block h3 {
  margin: 0 0 0.7rem !important;
  font-family: var(--gk-font-body);
  font-size: 0.74rem;
  font-weight: 700;
  letter-spacing: 0.11em;
  text-transform: uppercase;
  color: var(--gk-green-700);
}

.contents-block ul {
  margin: 0;
  padding-left: 0;
  list-style: none;
}

.contents-block li {
  font-size: 0.94rem;
  line-height: 1.5;
}

.contents-block li + li {
  margin-top: 0.34rem;
}

.contents-block a {
  color: var(--gk-ink-800);
  text-decoration: none;
  border-bottom: 1px solid transparent;
  transition: color 0.12s ease, border-color 0.12s ease;
}

.contents-block a:hover {
  color: var(--gk-green-700);
  border-bottom-color: var(--gk-green-300);
}


/* ─── Callout / section note ──────────────────────────────────────────────── */
.section-note {
  margin: 2rem 0;
  padding: 0.95rem 1.2rem;
  border-left: 3px solid var(--gk-green-600);
  border-radius: 0 10px 10px 0;
  background: var(--gk-green-50);
  font-size: 0.95rem;
  color: var(--gk-ink-700);
}

.section-note strong {
  color: var(--gk-green-800);
}


/* ─── Surface container ───────────────────────────────────────────────────── */
.surface {
  margin: 1.6rem 0 2rem;
  padding: 1.4rem 1.5rem;
  background: var(--gk-paper-raised);
  border: 1px solid var(--gk-line);
  border-radius: 16px;
}

.surface h2:first-child,
.surface h3:first-child {
  margin-top: 0;
}


/* ─── Toctree links ───────────────────────────────────────────────────────── */
.toctree-wrapper ul {
  padding-left: 1rem;
}

.toctree-wrapper a {
  color: var(--gk-green-700);
  text-decoration: none;
}

.toctree-wrapper a:hover {
  text-decoration: underline;
  text-decoration-color: var(--gk-green-300);
}


/* ─── API / reference page ────────────────────────────────────────────────── */
.reference-page h1 {
  font-size: clamp(2rem, 4vw, 2.6rem);
}

dl.py dt {
  background: var(--gk-paper-sunken);
  border-left: 3px solid var(--gk-green-600);
  border-radius: 0 8px 8px 0;
  padding: 0.5rem 0.8rem;
  font-family: var(--gk-font-mono);
  font-size: 0.88rem;
}

dl.py dd {
  margin-left: 1.2rem;
  padding-left: 0.85rem;
  border-left: 1px solid var(--gk-line);
}


/* ─── Pagination (prev / next) ────────────────────────────────────────────── */
.prev-next-area a {
  border: 1px solid var(--gk-line);
  border-radius: 12px;
  background: var(--gk-paper-raised);
  transition: border-color 0.15s ease, box-shadow 0.15s ease;
}

.prev-next-area a:hover {
  border-color: var(--gk-green-300);
  box-shadow: 0 10px 24px -18px rgba(9, 53, 52, 0.4);
}

.prev-next-area .title {
  color: var(--gk-green-700);
  font-weight: 600;
}


/* ─── Sidebar scrollbar ───────────────────────────────────────────────────── */
.sidebar-sticky::-webkit-scrollbar {
  width: 5px;
}

.sidebar-sticky::-webkit-scrollbar-track {
  background: transparent;
}

.sidebar-sticky::-webkit-scrollbar-thumb {
  background: var(--gk-line-strong);
  border-radius: 3px;
}


/* ─── Page-load motion ────────────────────────────────────────────────────── */
@media (prefers-reduced-motion: no-preference) {
  @keyframes gk-rise {
    from { opacity: 0; transform: translateY(12px); }
    to   { opacity: 1; transform: translateY(0); }
  }

  .quick-grid .quick-card {
    animation: gk-rise 0.5s cubic-bezier(0.2, 0.7, 0.2, 1) both;
  }

  .quick-grid .quick-card:nth-child(1) { animation-delay: 0.06s; }
  .quick-grid .quick-card:nth-child(2) { animation-delay: 0.12s; }
  .quick-grid .quick-card:nth-child(3) { animation-delay: 0.18s; }
  .quick-grid .quick-card:nth-child(4) { animation-delay: 0.24s; }
}