/* ═══════════════════════════════════════════════════════════════
   Gravity Docs — dedicated shell, built once on gravity/main.css's
   design tokens (see architecture.md §9). Loaded after main.css.
   ═══════════════════════════════════════════════════════════════ */

body.docs {
  background: var(--color-bg);
  color: var(--color-text);
  font-family: var(--font-body);
  line-height: var(--leading-normal);
}

/* ─── TOP BAR ───────────────────────────────────────────────── */
.docs-topbar {
  position: sticky;
  top: 0;
  z-index: 50;
  background: var(--color-bg);
  border-bottom: 1px solid var(--color-border);
}
.docs-topbar__inner {
  max-width: var(--container-max);
  margin: 0 auto;
  padding: 0 var(--container-pad);
  height: 64px;
  display: flex;
  align-items: center;
  gap: var(--space-4);
}
.docs-topbar__brand {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  color: var(--color-text);
  text-decoration: none;
  font-family: var(--font-display);
  font-weight: 700;
  font-size: var(--text-lg);
}
.docs-topbar__brand img { height: 26px; width: auto; }
.docs-topbar__label {
  color: var(--color-text-muted);
  text-decoration: none;
  font-family: var(--font-mono);
  font-size: var(--text-sm);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-full);
  padding: .2rem .7rem;
}
.docs-topbar__label:hover { color: var(--color-text); border-color: var(--color-border-hover); }
.docs-topbar__spacer { flex: 1; }
.docs-topbar__links { display: flex; align-items: center; gap: var(--space-6); }
.docs-topbar__links a {
  color: var(--color-text-muted);
  text-decoration: none;
  font-size: var(--text-sm);
  transition: color var(--transition);
}
.docs-topbar__links a:hover { color: var(--color-accent-light); }

/* ─── SHELL GRID ────────────────────────────────────────────── */
.docs-shell {
  max-width: var(--container-max);
  margin: 0 auto;
  padding: 0 var(--container-pad);
  display: grid;
  grid-template-columns: 240px minmax(0, 1fr) 220px;
  gap: var(--space-12);
  align-items: start;
}

/* ─── SIDEBAR ───────────────────────────────────────────────── */
.docs-sidebar {
  position: sticky;
  top: 64px;
  max-height: calc(100vh - 64px);
  overflow-y: auto;
  padding: var(--space-10) 0 var(--space-10) 0;
}
.docs-sidebar__section { margin-bottom: var(--space-6); }
.docs-sidebar__section-title {
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  font-weight: 700;
  letter-spacing: .08em;
  text-transform: uppercase;
  color: var(--color-text-faint);
  margin-bottom: var(--space-3);
}
.docs-sidebar ul { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 2px; }
.docs-sidebar a {
  display: block;
  color: var(--color-text-muted);
  text-decoration: none;
  font-size: var(--text-sm);
  padding: .4rem .6rem;
  border-radius: var(--radius-sm);
  border-left: 2px solid transparent;
  transition: color var(--transition), background var(--transition), border-color var(--transition);
}
.docs-sidebar a:hover { color: var(--color-text); background: var(--color-surface); }
.docs-sidebar a.is-active {
  color: var(--color-accent-light);
  background: var(--color-accent-soft);
  border-left-color: var(--color-accent);
  font-weight: 600;
}

/* ─── CONTENT ───────────────────────────────────────────────── */
.docs-content { padding: var(--space-10) 0 var(--space-16); min-width: 0; }

.docs-article { max-width: var(--content-max); }
.docs-article h1 {
  font-family: var(--font-display);
  font-size: var(--text-4xl);
  color: var(--color-text);
  margin-bottom: var(--space-6);
  line-height: var(--leading-tight);
}
.docs-article h2 {
  font-family: var(--font-display);
  font-size: var(--text-2xl);
  color: var(--color-text);
  margin: var(--space-10) 0 var(--space-4);
  padding-top: var(--space-4);
  border-top: 1px solid var(--color-border);
}
.docs-article h2:first-child { margin-top: 0; padding-top: 0; border-top: none; }
.docs-article h3 {
  font-family: var(--font-body);
  font-weight: 700;
  font-size: var(--text-lg);
  color: var(--color-text);
  margin: var(--space-8) 0 var(--space-3);
}
.docs-article p { color: var(--color-text-muted); margin-bottom: var(--space-4); }
.docs-article a { color: var(--color-accent-light); text-decoration: underline; text-decoration-color: var(--color-accent-border); text-underline-offset: 2px; }
.docs-article a:hover { text-decoration-color: var(--color-accent-light); }
.docs-article ul, .docs-article ol { color: var(--color-text-muted); margin: 0 0 var(--space-4); padding-left: 1.4em; }
.docs-article li { margin-bottom: var(--space-2); }
.docs-article li > p { margin-bottom: var(--space-2); }
.docs-article strong { color: var(--color-text); }
.docs-article blockquote {
  margin: var(--space-6) 0;
  padding: var(--space-1) var(--space-5);
  border-left: 3px solid var(--color-accent-border);
  color: var(--color-text-muted);
  font-style: italic;
}
.docs-article hr { border: none; border-top: 1px solid var(--color-border); margin: var(--space-10) 0; }

/* Inline code */
.docs-article code {
  font-family: var(--font-mono);
  font-size: .875em;
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: .3rem;
  padding: .1em .4em;
  color: var(--color-accent-light);
}
.docs-article pre {
  margin: var(--space-6) 0;
  border-radius: var(--radius-md);
  overflow-x: auto;
}
.docs-article pre code {
  background: none;
  border: none;
  padding: 0;
  color: inherit;
  font-size: var(--text-sm);
}
.docs-article .codehilite {
  border-radius: var(--radius-md);
  padding: var(--space-5);
  overflow-x: auto;
  margin: var(--space-6) 0;
  font-size: var(--text-sm);
  line-height: var(--leading-normal);
  box-shadow: var(--shadow-sm);
}

/* Tables */
.docs-article table {
  width: 100%;
  border-collapse: collapse;
  margin: var(--space-6) 0;
  font-size: var(--text-sm);
}
.docs-article th, .docs-article td {
  text-align: left;
  padding: .6rem .9rem;
  border-bottom: 1px solid var(--color-border);
}
.docs-article th {
  color: var(--color-text);
  font-weight: 700;
  background: var(--color-surface);
}
.docs-article td { color: var(--color-text-muted); }
.docs-article tr:last-child td { border-bottom: none; }

/* Admonitions (!!! note / !!! warning) */
.docs-article .admonition {
  margin: var(--space-6) 0;
  padding: var(--space-4) var(--space-5);
  border-radius: var(--radius-md);
  border: 1px solid var(--color-border);
  border-left: 3px solid var(--color-accent-border);
  background: var(--color-surface);
}
.docs-article .admonition p:last-child { margin-bottom: 0; }
.docs-article .admonition-title {
  font-weight: 700;
  color: var(--color-text);
  margin-bottom: var(--space-2);
  text-transform: uppercase;
  font-size: var(--text-xs);
  letter-spacing: .06em;
}
.docs-article .admonition.warning { border-left-color: #F59E0B; }
.docs-article .admonition.danger { border-left-color: var(--color-error); }

/* Header anchor permalinks (toc extension adds id="..." to h2/h3) */
.docs-article h2, .docs-article h3 { scroll-margin-top: 80px; }

.docs-article__footer {
  max-width: var(--content-max);
  margin-top: var(--space-12);
  padding-top: var(--space-6);
  border-top: 1px solid var(--color-border);
}
.docs-edit-link {
  color: var(--color-text-faint);
  text-decoration: none;
  font-size: var(--text-xs);
  font-family: var(--font-mono);
}
.docs-edit-link:hover { color: var(--color-text-muted); }

/* ─── ON-THIS-PAGE TOC ──────────────────────────────────────── */
.docs-toc {
  position: sticky;
  top: 64px;
  max-height: calc(100vh - 64px);
  overflow-y: auto;
  padding: var(--space-10) 0;
}
.docs-toc__label {
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  font-weight: 700;
  letter-spacing: .08em;
  text-transform: uppercase;
  color: var(--color-text-faint);
  margin-bottom: var(--space-3);
}
.docs-toc .toc { font-size: var(--text-sm); }
.docs-toc ul { list-style: none; margin: 0; padding: 0; }
.docs-toc ul ul { padding-left: var(--space-4); }
.docs-toc li { margin-bottom: var(--space-2); }
.docs-toc a {
  color: var(--color-text-muted);
  text-decoration: none;
  display: block;
  border-left: 2px solid transparent;
  padding-left: var(--space-3);
}
.docs-toc a:hover { color: var(--color-text); border-left-color: var(--color-border-hover); }

/* ─── RESPONSIVE ────────────────────────────────────────────── */
@media (max-width: 1100px) {
  .docs-shell { grid-template-columns: 220px minmax(0, 1fr); }
  .docs-toc { display: none; }
}
@media (max-width: 768px) {
  .docs-shell { grid-template-columns: 1fr; }
  .docs-sidebar {
    position: static;
    max-height: none;
    padding: var(--space-6) 0;
    border-bottom: 1px solid var(--color-border);
  }
  .docs-topbar__links a:not(:last-child) { display: none; }
}

/* ─── PYGMENTS (monokai) — code block syntax highlighting ──── */
.codehilite .hll { background-color: #49483e }
.codehilite { background: #16181d; color: #F8F8F2 }
.codehilite .c { color: #959077 }
.codehilite .err { color: #ED007E; background-color: #1E0010 }
.codehilite .esc { color: #F8F8F2 }
.codehilite .g { color: #F8F8F2 }
.codehilite .k { color: #66D9EF }
.codehilite .l { color: #AE81FF }
.codehilite .n { color: #F8F8F2 }
.codehilite .o { color: #FF4689 }
.codehilite .x { color: #F8F8F2 }
.codehilite .p { color: #F8F8F2 }
.codehilite .ch { color: #959077 }
.codehilite .cm { color: #959077 }
.codehilite .cp { color: #959077 }
.codehilite .cpf { color: #959077 }
.codehilite .c1 { color: #959077 }
.codehilite .cs { color: #959077 }
.codehilite .gd { color: #FF4689 }
.codehilite .ge { color: #F8F8F2; font-style: italic }
.codehilite .ges { color: #F8F8F2; font-weight: bold; font-style: italic }
.codehilite .gr { color: #FF4689 }
.codehilite .gh { color: #F8F8F2 }
.codehilite .gi { color: #A6E22E }
.codehilite .go { color: #66D9EF }
.codehilite .gp { color: #FF4689; font-weight: bold }
.codehilite .gs { color: #F8F8F2; font-weight: bold }
.codehilite .gu { color: #959077 }
.codehilite .gt { color: #66D9EF }
.codehilite .kc { color: #66D9EF }
.codehilite .kd { color: #66D9EF }
.codehilite .kn { color: #FF4689 }
.codehilite .kp { color: #66D9EF }
.codehilite .kr { color: #66D9EF }
.codehilite .kt { color: #66D9EF }
.codehilite .ld { color: #E6DB74 }
.codehilite .m { color: #AE81FF }
.codehilite .s { color: #E6DB74 }
.codehilite .na { color: #A6E22E }
.codehilite .nb { color: #A6E22E }
.codehilite .nc { color: #A6E22E }
.codehilite .no { color: #66D9EF }
.codehilite .nd { color: #A6E22E }
.codehilite .ni { color: #F8F8F2 }
.codehilite .ne { color: #A6E22E }
.codehilite .nf { color: #A6E22E }
.codehilite .nl { color: #F8F8F2 }
.codehilite .nn { color: #F8F8F2 }
.codehilite .nx { color: #A6E22E }
.codehilite .py { color: #F8F8F2 }
.codehilite .nt { color: #FF4689 }
.codehilite .nv { color: #F8F8F2 }
.codehilite .ow { color: #FF4689 }
.codehilite .pm { color: #F8F8F2 }
.codehilite .w { color: #F8F8F2 }
.codehilite .mb { color: #AE81FF }
.codehilite .mf { color: #AE81FF }
.codehilite .mh { color: #AE81FF }
.codehilite .mi { color: #AE81FF }
.codehilite .mo { color: #AE81FF }
.codehilite .sa { color: #E6DB74 }
.codehilite .sb { color: #E6DB74 }
.codehilite .sc { color: #E6DB74 }
.codehilite .dl { color: #E6DB74 }
.codehilite .sd { color: #E6DB74 }
.codehilite .s2 { color: #E6DB74 }
.codehilite .se { color: #AE81FF }
.codehilite .sh { color: #E6DB74 }
.codehilite .si { color: #E6DB74 }
.codehilite .sx { color: #E6DB74 }
.codehilite .sr { color: #E6DB74 }
.codehilite .s1 { color: #E6DB74 }
.codehilite .ss { color: #E6DB74 }
.codehilite .bp { color: #A6E22E }
.codehilite .fm { color: #A6E22E }
.codehilite .vc { color: #F8F8F2 }
.codehilite .vg { color: #F8F8F2 }
.codehilite .vi { color: #F8F8F2 }
.codehilite .vm { color: #F8F8F2 }
.codehilite .il { color: #AE81FF }