/* ════════════════════════════════════════════════════════════════════════════
   DOCS.CSS — Documentation page styles
   ════════════════════════════════════════════════════════════════════════════ */

/* ── Extended variables for docs ───────────────────────────────────────────── */
:root {
  /* Muted doc accent colors for readability */
  --doc-h1:        #5c6b7a;   /* muted steel */
  --doc-h2:        #6b5c7a;   /* muted violet */
  --doc-h3:        #5a7a6b;   /* muted teal */
  --doc-h4:        #7a6b5a;   /* muted amber */
  --doc-bold:      #3d3b37;
  --doc-link:      #4a7a6b;
  --doc-link-bg:   rgba(74,122,107,0.08);
  --doc-code-text: #6b4a8a;   /* muted purple */
  --doc-code-bg:   rgba(107,74,138,0.08);
  --doc-blockquote:#7a6b5c;
  --doc-blockquote-border: #c4b8a8;
  --doc-mark:      rgba(180,150,80,0.18);
  --doc-table-hd:  rgba(74,122,107,0.12);

  --sidebar-w:     240px;
}

@media (prefers-color-scheme: dark) {
  :root {
    --doc-h1:        #88a8c0;
    --doc-h2:        #a888c0;
    --doc-h3:        #88c0a8;
    --doc-h4:        #c0a888;
    --doc-bold:      #d8d5ce;
    --doc-link:      #7ac4a2;
    --doc-link-bg:   rgba(122,196,162,0.1);
    --doc-code-text: #b898d8;
    --doc-code-bg:   rgba(184,152,216,0.1);
    --doc-blockquote:#b8a898;
    --doc-blockquote-border: #4a4540;
    --doc-mark:      rgba(200,170,90,0.2);
    --doc-table-hd:  rgba(122,196,162,0.1);
  }
}

/* ── Page Layout ───────────────────────────────────────────────────────────── */
.page-wrap {
  padding-top: 54px;
  max-width: 1100px;
  margin: 0 auto;
  display: grid;
  grid-template-columns: var(--sidebar-w) 1fr;
  min-height: 100vh;
}

/* ── Sidebar ───────────────────────────────────────────────────────────────── */
.sidebar {
  border-right: 1px solid var(--border);
  padding: 32px 0;
  position: sticky;
  top: 54px;
  height: calc(100vh - 54px);
  overflow-y: auto;
}

.sidebar-section {
  padding: 0 18px;
  margin-bottom: 28px;
}

.sidebar-label {
  font-family: var(--font-mono);
  font-size: 10px;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--text-faint);
  margin-bottom: 8px;
  padding: 0 8px;
}

.sidebar-link {
  display: block;
  width: 100%;
  text-align: left;
  background: transparent;
  border: none;
  font-family: var(--font-body);
  font-size: 13px;
  color: var(--text-muted);
  text-decoration: none;
  padding: 5px 8px;
  border-radius: 4px;
  font-weight: 300;
  transition: color var(--transition), background var(--transition);
  cursor: pointer;
}
.sidebar-link:hover {
  color: var(--text);
  background: var(--bg-raised);
}
.sidebar-link.active {
  color: var(--doc-link);
  background: var(--doc-link-bg);
}

/* ── Doc Content ───────────────────────────────────────────────────────────── */
.doc-main {
  padding: 40px 64px 80px;
  min-width: 0;
  opacity: 0;
  animation: fadeUp 0.5s ease forwards;
}

.doc-breadcrumb {
  display: flex;
  align-items: center;
  gap: 8px;
  font-family: var(--font-mono);
  font-size: 11px;
  color: var(--text-faint);
  margin-bottom: 32px;
  letter-spacing: 0.04em;
}

.doc-breadcrumb a {
  color: var(--text-faint);
  text-decoration: none;
}
.doc-breadcrumb a:hover {
  color: var(--text-muted);
}
.doc-breadcrumb span {
  opacity: 0.5;
}

/* ── Markdown rendered content ─────────────────────────────────────────────── */
.markdown-body {
  max-width: 720px;
}

.markdown-body h1 {
  font-family: var(--font-display);
  font-size: clamp(28px, 3.5vw, 40px);
  font-weight: 400;
  color: var(--doc-h1);
  letter-spacing: -0.02em;
  line-height: 1.2;
  margin-bottom: 8px;
  padding-bottom: 16px;
  border-bottom: 1px solid var(--border);
}

.markdown-body .doc-meta {
  display: flex;
  gap: 16px;
  margin-bottom: 36px;
}

.markdown-body .doc-tag {
  font-family: var(--font-mono);
  font-size: 10.5px;
  color: var(--text-faint);
  letter-spacing: 0.06em;
}

.markdown-body h2 {
  font-family: var(--font-display);
  font-size: clamp(20px, 2.5vw, 26px);
  font-weight: 400;
  color: var(--doc-h2);
  letter-spacing: -0.01em;
  line-height: 1.3;
  margin: 44px 0 14px;
  padding-bottom: 8px;
  border-bottom: 1px solid var(--border);
}

.markdown-body h3 {
  font-size: 17px;
  font-weight: 500;
  color: var(--doc-h3);
  margin: 30px 0 10px;
}

.markdown-body h4 {
  font-size: 14px;
  font-weight: 500;
  color: var(--doc-h4);
  letter-spacing: 0.04em;
  text-transform: uppercase;
  margin: 24px 0 8px;
}

.markdown-body p {
  margin-bottom: 16px;
  color: var(--text);
  line-height: 1.8;
}

.markdown-body strong {
  font-weight: 500;
  color: var(--doc-bold);
}

.markdown-body em {
  font-style: italic;
}

.markdown-body a {
  color: var(--doc-link);
  text-decoration: none;
  border-bottom: 1px solid transparent;
  transition: border-color var(--transition), background var(--transition);
  padding: 0 2px;
  border-radius: 2px;
}
.markdown-body a:hover {
  background: var(--doc-link-bg);
  border-bottom-color: var(--doc-link);
}

.markdown-body code {
  font-family: var(--font-mono);
  font-size: 12.5px;
  color: var(--doc-code-text);
  background: var(--doc-code-bg);
  padding: 2px 6px;
  border-radius: 3px;
}

.markdown-body pre {
  background: var(--bg-code);
  border: 1px solid var(--border);
  border-radius: 8px;
  padding: 20px 24px;
  overflow-x: auto;
  margin: 20px 0;
}

.markdown-body pre code {
  color: var(--text-muted);
  background: none;
  padding: 0;
  font-size: 12.5px;
  line-height: 1.7;
}

.markdown-body blockquote {
  border-left: 3px solid var(--doc-blockquote-border);
  padding: 12px 20px;
  margin: 20px 0;
  color: var(--doc-blockquote);
  font-style: italic;
  background: var(--bg-raised);
  border-radius: 0 6px 6px 0;
}

.markdown-body blockquote p {
  color: var(--doc-blockquote);
  margin: 0;
}

.markdown-body ul,
.markdown-body ol {
  padding-left: 22px;
  margin-bottom: 16px;
}

.markdown-body li {
  margin-bottom: 6px;
  line-height: 1.7;
  color: var(--text);
}

.markdown-body li::marker {
  color: var(--doc-h3);
}

.markdown-body hr {
  border: none;
  border-top: 1px solid var(--border);
  margin: 36px 0;
}

.markdown-body table {
  width: 100%;
  border-collapse: collapse;
  margin: 20px 0;
  font-size: 13.5px;
}

.markdown-body th {
  background: var(--doc-table-hd);
  color: var(--doc-link);
  font-weight: 500;
  text-align: left;
  padding: 10px 14px;
  border-bottom: 1px solid var(--border);
  font-family: var(--font-mono);
  font-size: 11.5px;
  letter-spacing: 0.04em;
}

.markdown-body td {
  padding: 9px 14px;
  border-bottom: 1px solid var(--border);
  color: var(--text-muted);
}

.markdown-body tr:last-child td {
  border-bottom: none;
}

.markdown-body mark {
  background: var(--doc-mark);
  color: inherit;
  padding: 1px 3px;
  border-radius: 2px;
}

/* ── Callout boxes ─────────────────────────────────────────────────────────── */
.callout {
  border-radius: 6px;
  padding: 14px 18px;
  margin: 20px 0;
  display: grid;
  grid-template-columns: 18px 1fr;
  gap: 10px;
  align-items: start;
  font-size: 14px;
  line-height: 1.65;
}

.callout-note {
  background: rgba(74,122,107,0.08);
  border: 1px solid rgba(74,122,107,0.2);
  color: var(--doc-h3);
}
.callout-warn {
  background: rgba(180,130,60,0.08);
  border: 1px solid rgba(180,130,60,0.25);
  color: #b08040;
}
.callout-danger {
  background: rgba(180,60,60,0.08);
  border: 1px solid rgba(180,60,60,0.2);
  color: #a05050;
}

/* ── Doc selector (index page) ─────────────────────────────────────────────── */
.doc-index-grid {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: 14px;
  margin-top: 28px;
}

.doc-index-card {
  border: 1px solid var(--border);
  border-radius: 8px;
  padding: 20px;
  cursor: pointer;
  transition: border-color var(--transition), background var(--transition);
}

.doc-index-card:hover {
  border-color: var(--doc-link);
  background: var(--bg-raised);
}

.dic-tag {
  font-family: var(--font-mono);
  font-size: 10.5px;
  color: var(--text-faint);
  letter-spacing: 0.06em;
  margin-bottom: 8px;
}

.dic-title {
  font-family: var(--font-display);
  font-size: 18px;
  font-weight: 400;
  color: var(--text);
  margin-bottom: 6px;
  letter-spacing: -0.01em;
}

.dic-desc {
  font-size: 12.5px;
  color: var(--text-muted);
  line-height: 1.6;
}

/* ── TOC ───────────────────────────────────────────────────────────────────── */
.toc {
  position: sticky;
  top: 80px;
  font-size: 12.5px;
  color: var(--text-faint);
  border-left: 1px solid var(--border);
  padding-left: 18px;
}

.toc-label {
  font-family: var(--font-mono);
  font-size: 10px;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  margin-bottom: 10px;
  color: var(--text-faint);
}

.toc a {
  display: block;
  color: var(--text-faint);
  text-decoration: none;
  padding: 3px 0;
  transition: color var(--transition);
}
.toc a:hover {
  color: var(--text-muted);
}
.toc a.h3 {
  padding-left: 12px;
  font-size: 11.5px;
}

/* ── Mobile sidebar toggle — hidden by default ─────────────────────────────── */
.mobile-nav-bar {
  display: none;
}

/* Scrim behind the sidebar — hidden by default ─────────────────────────────── */
#sidebar-scrim {
  display: none;
  position: fixed;
  top: 54px;
  left: 0;
  right: 0;
  bottom: 0;
  background: rgba(0,0,0,0.3);
  z-index: 50;
}

#sidebar-scrim.visible {
  display: block;
}

/* ── Responsive ────────────────────────────────────────────────────────────── */
@media (max-width: 768px) {
  .page-wrap {
    grid-template-columns: 1fr;
  }

  .doc-main {
    padding: 24px 20px 60px;
  }

  .doc-index-grid {
    grid-template-columns: 1fr;
  }

  /* Show the mobile nav bar only when the sidebar has gone off-canvas */
  .mobile-nav-bar {
    display: flex;
    align-items: center;
    margin-bottom: 20px;
  }

  /* Toggle button — styled like a nav link, not a standalone widget */
  .sidebar-toggle {
    display: inline-flex;
    align-items: center;
    gap: 9px;
    padding: 5px 10px;
    background: transparent;
    border: none;
    color: var(--text-muted);
    font-family: var(--font-mono);
    font-size: 11.5px;
    letter-spacing: 0.02em;
    border-radius: var(--radius);
    cursor: pointer;
    -webkit-appearance: none;
    appearance: none;
    transition: color var(--transition), background var(--transition);
    margin-left: -10px; /* align left edge with content */
  }

  .sidebar-toggle:hover {
    color: var(--text);
    background: var(--bg-raised);
  }

  .sidebar-toggle.open {
    color: var(--doc-link);
    background: var(--doc-link-bg);
  }

  /* Three-line icon — matches the site's weight and muted palette */
  .toggle-icon {
    display: inline-flex;
    flex-direction: column;
    justify-content: center;
    gap: 3.5px;
    width: 14px;
    flex-shrink: 0;
  }

  .toggle-icon span {
    display: block;
    height: 1.5px;
    background: currentColor;
    border-radius: 1px;
    transition: opacity var(--transition), transform var(--transition);
  }

  /* Animate middle bar out and rotate outer bars when open */
  .sidebar-toggle.open .toggle-icon span:nth-child(1) {
    transform: translateY(5px) rotate(45deg);
  }
  .sidebar-toggle.open .toggle-icon span:nth-child(2) {
    opacity: 0;
    transform: scaleX(0.4);
  }
  .sidebar-toggle.open .toggle-icon span:nth-child(3) {
    transform: translateY(-5px) rotate(-45deg);
  }

  /* Off-canvas sidebar panel */
  .sidebar {
    display: block;
    position: fixed;
    top: 54px;
    left: 0;
    width: min(80%, 300px);
    height: calc(100vh - 54px);
    padding: 20px 12px;
    background: var(--bg);
    border-right: 1px solid var(--border);
    transform: translateX(-110%);
    transition: transform 0.25s ease;
    z-index: 60;
    overflow-y: auto;
    box-shadow: 4px 0 20px rgba(0,0,0,0.06);
  }

  .sidebar.open {
    transform: translateX(0);
  }
}