/* Garvan C++ documentation layout
   Builds on Bootstrap 5 + app.css (bg-garvan #783698).
   Adds three-column docs shell, sidebar, TOC, code blocks, language switcher.
*/

:root {
  --garvan-purple: #783698;
  --garvan-purple-dark: #5b2575;
  --garvan-purple-light: #f3eaf8;
  --garvan-border: #e5e7eb;
  --garvan-text: #1f2937;
  --garvan-muted: #6b7280;
  --garvan-code-bg: #0d1117;
  --docs-sidebar-w: 260px;
  --docs-toc-w: 220px;
  --docs-topnav-h: 60px;
}

html, body {
  scroll-behavior: smooth;
}

body.docs-body {
  background: #ffffff;
  color: var(--garvan-text);
  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
}

/* ---------- Top navigation ---------- */
.docs-topnav {
  position: sticky;
  top: 0;
  z-index: 1030;
  background-color: var(--garvan-purple);
  height: var(--docs-topnav-h);
  display: flex;
  align-items: center;
  padding: 0 24px;
  box-shadow: 0 2px 6px rgba(0,0,0,0.1);
}

.docs-topnav .brand {
  display: flex;
  align-items: center;
  gap: 10px;
  color: #fff;
  text-decoration: none;
  font-weight: 600;
  font-size: 1.15rem;
}

.docs-topnav .brand img {
  width: 36px;
  height: 36px;
  border-radius: 4px;
}

.docs-topnav .nav-links {
  display: flex;
  gap: 8px;
  margin-left: 32px;
  list-style: none;
  padding: 0;
  margin-bottom: 0;
}

.docs-topnav .nav-links a {
  color: rgba(255,255,255,0.9);
  text-decoration: none;
  padding: 8px 14px;
  border-radius: 6px;
  font-size: 0.95rem;
  transition: background 0.15s ease;
}

.docs-topnav .nav-links a:hover,
.docs-topnav .nav-links a.active {
  background: rgba(255,255,255,0.15);
  color: #fff;
}

.docs-topnav .topnav-right {
  margin-left: auto;
  display: flex;
  align-items: center;
  gap: 8px;
}

.docs-topnav .github-link,
.docs-topnav .lang-toggle {
  color: rgba(255,255,255,0.9);
  background: rgba(255,255,255,0.1);
  border: 1px solid rgba(255,255,255,0.2);
  border-radius: 6px;
  padding: 6px 12px;
  text-decoration: none;
  font-size: 0.9rem;
  cursor: pointer;
}

.docs-topnav .github-link:hover,
.docs-topnav .lang-toggle:hover {
  background: rgba(255,255,255,0.2);
}

.docs-topnav .lang-menu {
  position: absolute;
  top: calc(var(--docs-topnav-h) - 4px);
  right: 24px;
  background: #fff;
  border: 1px solid var(--garvan-border);
  border-radius: 6px;
  box-shadow: 0 4px 14px rgba(0,0,0,0.12);
  list-style: none;
  padding: 6px 0;
  margin: 0;
  min-width: 140px;
  display: none;
  z-index: 1040;
}

.docs-topnav .lang-menu.open {
  display: block;
}

.docs-topnav .lang-menu a {
  display: block;
  padding: 8px 14px;
  color: var(--garvan-text);
  text-decoration: none;
  font-size: 0.9rem;
}

.docs-topnav .lang-menu a:hover {
  background: var(--garvan-purple-light);
  color: var(--garvan-purple-dark);
}

.docs-topnav .lang-menu a.active {
  font-weight: 600;
  color: var(--garvan-purple-dark);
}

.docs-sidebar-toggle {
  display: none;
  background: transparent;
  border: 1px solid rgba(255,255,255,0.3);
  color: #fff;
  border-radius: 6px;
  padding: 6px 10px;
  margin-right: 10px;
  cursor: pointer;
}

/* ---------- Three-column shell ---------- */
.docs-shell {
  display: grid;
  grid-template-columns: var(--docs-sidebar-w) minmax(0, 1fr) var(--docs-toc-w);
  gap: 32px;
  max-width: 1400px;
  margin: 0 auto;
  padding: 24px;
}

.docs-sidebar {
  position: sticky;
  top: calc(var(--docs-topnav-h) + 16px);
  align-self: start;
  max-height: calc(100vh - var(--docs-topnav-h) - 32px);
  overflow-y: auto;
  padding-right: 8px;
}

.docs-main {
  min-width: 0;
  padding: 8px 0 64px;
}

.docs-toc {
  position: sticky;
  top: calc(var(--docs-topnav-h) + 16px);
  align-self: start;
  max-height: calc(100vh - var(--docs-topnav-h) - 32px);
  overflow-y: auto;
  font-size: 0.875rem;
}

/* ---------- Sidebar ---------- */
.docs-sidebar details {
  margin-bottom: 4px;
}

.docs-sidebar summary {
  cursor: pointer;
  font-weight: 600;
  font-size: 0.95rem;
  padding: 8px 10px;
  border-radius: 6px;
  color: var(--garvan-text);
  list-style: none;
}

.docs-sidebar summary::-webkit-details-marker { display: none; }

.docs-sidebar summary::before {
  content: "▸";
  display: inline-block;
  margin-right: 6px;
  color: var(--garvan-muted);
  transition: transform 0.15s ease;
}

.docs-sidebar details[open] > summary::before {
  transform: rotate(90deg);
}

.docs-sidebar summary:hover {
  background: var(--garvan-purple-light);
  color: var(--garvan-purple-dark);
}

.docs-sidebar ul {
  list-style: none;
  padding-left: 18px;
  margin: 4px 0;
}

.docs-sidebar a {
  display: block;
  padding: 6px 10px;
  color: var(--garvan-text);
  text-decoration: none;
  font-size: 0.9rem;
  border-radius: 4px;
  border-left: 2px solid transparent;
}

.docs-sidebar a:hover {
  background: var(--garvan-purple-light);
  color: var(--garvan-purple-dark);
}

.docs-sidebar a.active {
  background: var(--garvan-purple-light);
  color: var(--garvan-purple-dark);
  border-left-color: var(--garvan-purple);
  font-weight: 600;
}

/* ---------- TOC ---------- */
.docs-toc h6 {
  font-size: 0.78rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--garvan-muted);
  margin-bottom: 10px;
  font-weight: 700;
}

.docs-toc ul {
  list-style: none;
  padding: 0;
  margin: 0;
  border-left: 2px solid var(--garvan-border);
}

.docs-toc li {
  padding: 0;
}

.docs-toc a {
  display: block;
  padding: 4px 12px;
  color: var(--garvan-muted);
  text-decoration: none;
  font-size: 0.85rem;
  border-left: 2px solid transparent;
  margin-left: -2px;
  transition: color 0.1s ease, border-color 0.1s ease;
}

.docs-toc a:hover {
  color: var(--garvan-purple-dark);
  border-left-color: var(--garvan-purple);
}

.docs-toc .toc-sub { padding-left: 12px; }

/* ---------- Article ---------- */
.docs-main article {
  max-width: 820px;
}

.docs-main h1 {
  font-size: 2.25rem;
  font-weight: 700;
  margin: 0 0 24px;
  padding-bottom: 12px;
  border-bottom: 1px solid var(--garvan-border);
}

.docs-main h2 {
  font-size: 1.6rem;
  font-weight: 700;
  margin: 40px 0 16px;
  scroll-margin-top: 80px;
}

.docs-main h3 {
  font-size: 1.25rem;
  font-weight: 600;
  margin: 28px 0 12px;
  scroll-margin-top: 80px;
}

.docs-main h4 {
  font-size: 1.05rem;
  font-weight: 600;
  margin: 22px 0 10px;
  scroll-margin-top: 80px;
}

.docs-main p {
  line-height: 1.7;
  margin-bottom: 14px;
}

.docs-main a {
  color: var(--garvan-purple);
  text-decoration: underline;
  text-decoration-thickness: 1px;
  text-underline-offset: 2px;
}

.docs-main a:hover { color: var(--garvan-purple-dark); }

.docs-main ul, .docs-main ol {
  line-height: 1.7;
  padding-left: 24px;
  margin-bottom: 16px;
}

.docs-main li { margin-bottom: 4px; }

.docs-main code {
  background: rgba(120, 54, 152, 0.08);
  color: var(--garvan-purple-dark);
  padding: 2px 6px;
  border-radius: 4px;
  font-family: "SFMono-Regular", Menlo, Monaco, Consolas, "Courier New", monospace;
  font-size: 0.88em;
}

.docs-main pre {
  background: var(--garvan-code-bg);
  color: #e6edf3;
  padding: 16px 18px;
  border-radius: 8px;
  overflow-x: auto;
  margin: 16px 0;
  font-size: 0.875rem;
  line-height: 1.55;
  position: relative;
}

.docs-main pre code {
  background: transparent;
  color: inherit;
  padding: 0;
  border-radius: 0;
  font-size: inherit;
}

.docs-main blockquote {
  border-left: 4px solid var(--garvan-purple);
  background: var(--garvan-purple-light);
  padding: 12px 16px;
  margin: 16px 0;
  border-radius: 0 6px 6px 0;
}

.docs-main blockquote p:last-child { margin-bottom: 0; }

.docs-main .admonition {
  border-left: 4px solid var(--garvan-purple);
  background: #f8f9fa;
  padding: 12px 16px;
  margin: 16px 0;
  border-radius: 0 6px 6px 0;
}

.docs-main .admonition.note { border-left-color: #0d6efd; background: #e7f1ff; }
.docs-main .admonition.warning { border-left-color: #fd7e14; background: #fff3e0; }
.docs-main .admonition.tip { border-left-color: #198754; background: #e6f4ec; }

.docs-main .admonition .admonition-title {
  font-weight: 700;
  text-transform: uppercase;
  font-size: 0.78rem;
  letter-spacing: 0.05em;
  margin-bottom: 6px;
}

.docs-main table {
  width: 100%;
  border-collapse: collapse;
  margin: 16px 0;
}

.docs-main table th,
.docs-main table td {
  padding: 8px 12px;
  border: 1px solid var(--garvan-border);
  text-align: left;
}

.docs-main table th {
  background: var(--garvan-purple-light);
  font-weight: 600;
}

/* ---------- Page nav (prev/next) ---------- */
.page-nav {
  display: flex;
  justify-content: space-between;
  gap: 12px;
  margin-top: 48px;
  padding-top: 20px;
  border-top: 1px solid var(--garvan-border);
}

.page-nav a {
  flex: 1;
  display: block;
  padding: 12px 16px;
  border: 1px solid var(--garvan-border);
  border-radius: 8px;
  text-decoration: none;
  color: var(--garvan-text);
  transition: border-color 0.15s ease, background 0.15s ease;
}

.page-nav a:hover {
  border-color: var(--garvan-purple);
  background: var(--garvan-purple-light);
}

.page-nav .label {
  font-size: 0.78rem;
  color: var(--garvan-muted);
  display: block;
  margin-bottom: 2px;
}

.page-nav .title {
  font-weight: 600;
  color: var(--garvan-purple-dark);
}

.page-nav .next { text-align: right; }

/* ---------- Footer ---------- */
.docs-footer {
  background: #f8f9fa;
  border-top: 1px solid var(--garvan-border);
  padding: 28px 24px;
  margin-top: 40px;
  text-align: center;
  color: var(--garvan-muted);
  font-size: 0.875rem;
}

.docs-footer a {
  color: var(--garvan-purple-dark);
  text-decoration: none;
}

.docs-footer a:hover { text-decoration: underline; }

.docs-footer .social {
  display: flex;
  justify-content: center;
  gap: 14px;
  margin-top: 10px;
}

.docs-footer .social a {
  display: inline-flex;
  width: 32px;
  height: 32px;
  border-radius: 50%;
  background: var(--garvan-purple);
  color: #fff;
  align-items: center;
  justify-content: center;
  text-decoration: none;
}

.docs-footer .social a:hover { background: var(--garvan-purple-dark); }

/* ---------- Home page ---------- */
.home-hero {
  text-align: center;
  padding: 60px 20px 40px;
  background: linear-gradient(180deg, var(--garvan-purple-light) 0%, #ffffff 100%);
  border-radius: 12px;
  margin-bottom: 40px;
}

.home-hero img.hero-logo {
  width: 180px;
  height: auto;
  margin-bottom: 18px;
}

.home-hero h1 {
  font-size: 2.4rem;
  font-weight: 700;
  border-bottom: none;
  margin-bottom: 12px;
  padding-bottom: 0;
}

.home-hero .lead {
  font-size: 1.15rem;
  color: var(--garvan-muted);
  max-width: 720px;
  margin: 0 auto 24px;
  line-height: 1.6;
}

.home-hero .cta-row {
  display: flex;
  gap: 12px;
  justify-content: center;
  flex-wrap: wrap;
}

.home-hero .btn-primary-garvan,
.home-hero .btn-outline-garvan {
  display: inline-block;
  padding: 10px 22px;
  border-radius: 6px;
  text-decoration: none;
  font-weight: 500;
  font-size: 0.95rem;
}

.home-hero .btn-primary-garvan {
  background: var(--garvan-purple);
  color: #fff;
}

.home-hero .btn-primary-garvan:hover {
  background: var(--garvan-purple-dark);
}

.home-hero .btn-outline-garvan {
  background: transparent;
  border: 1px solid var(--garvan-purple);
  color: var(--garvan-purple-dark);
}

.home-hero .btn-outline-garvan:hover {
  background: var(--garvan-purple-light);
}

.feature-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
  gap: 20px;
  margin: 40px 0;
}

.feature-card {
  border: 1px solid var(--garvan-border);
  border-radius: 10px;
  padding: 24px 20px;
  text-align: center;
  background: #fff;
  transition: transform 0.15s ease, box-shadow 0.15s ease;
}

.feature-card:hover {
  transform: translateY(-2px);
  box-shadow: 0 8px 24px rgba(120,54,152,0.12);
}

.feature-card .icon {
  font-size: 2rem;
  margin-bottom: 10px;
  color: var(--garvan-purple);
}

.feature-card h3 {
  margin: 8px 0 6px;
  font-size: 1.05rem;
}

.feature-card p {
  font-size: 0.88rem;
  color: var(--garvan-muted);
  margin: 0;
}

.code-feature {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 32px;
  align-items: center;
  margin: 48px 0;
}

.code-feature.reverse { direction: rtl; }
.code-feature.reverse > * { direction: ltr; }

.code-feature h2 {
  font-size: 1.5rem;
  margin: 0 0 8px;
}

.code-feature p {
  color: var(--garvan-muted);
  margin: 0;
}

.packages-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
  gap: 16px;
  margin-top: 24px;
}

.packages-grid a {
  display: block;
  text-align: center;
  padding: 18px 14px;
  border: 1px solid var(--garvan-border);
  border-radius: 8px;
  color: var(--garvan-text);
  text-decoration: none;
  background: #fff;
}

.packages-grid a:hover {
  border-color: var(--garvan-purple);
  background: var(--garvan-purple-light);
}

.packages-grid .pkg-name {
  font-weight: 600;
  display: block;
  color: var(--garvan-purple-dark);
}

.packages-grid .pkg-desc {
  font-size: 0.82rem;
  color: var(--garvan-muted);
  display: block;
  margin-top: 4px;
}

/* ---------- Responsive ---------- */
@media (max-width: 1100px) {
  .docs-shell {
    grid-template-columns: var(--docs-sidebar-w) minmax(0, 1fr);
  }
  .docs-toc { display: none; }
}

@media (max-width: 768px) {
  .docs-shell {
    grid-template-columns: 1fr;
    padding: 16px;
  }
  .docs-sidebar {
    display: none;
    position: fixed;
    top: var(--docs-topnav-h);
    left: 0;
    width: 280px;
    max-width: 80vw;
    height: calc(100vh - var(--docs-topnav-h));
    background: #fff;
    padding: 16px;
    z-index: 1020;
    box-shadow: 4px 0 20px rgba(0,0,0,0.1);
    overflow-y: auto;
  }
  .docs-sidebar.open { display: block; }
  .docs-sidebar-toggle { display: inline-block; }
  .docs-topnav .nav-links {
    display: none;
  }
  .docs-main h1 { font-size: 1.75rem; }
  .home-hero h1 { font-size: 1.75rem; }
  .code-feature {
    grid-template-columns: 1fr;
  }
}

/* highlight.js overrides to fit our pre block */
.hljs {
  background: var(--garvan-code-bg) !important;
  color: #e6edf3 !important;
  padding: 0 !important;
}