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

/* ── Extended variables for docs (docs-only additions) ─────────────────────── */
:root {
  --sidebar-w: 15rem;
}

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

/* ── Sidebar ───────────────────────────────────────────────────────────────── */
.sidebar {
  border-right: var(--border-w) solid var(--border);
  padding: 2rem 0;
  position: sticky;
  top: 3.375rem;
  height: calc(100vh - 3.375rem);
  overflow-y: auto;
  scrollbar-width: thin;
  scrollbar-color: var(--border-strong) transparent;
}

.sidebar::-webkit-scrollbar {
  width: 0.25rem;
}

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

.sidebar::-webkit-scrollbar-thumb {
  background: var(--border-strong);
  border-radius: 0.125rem;
}

.sidebar::-webkit-scrollbar-thumb:hover {
  background: var(--text-faint);
}

.sidebar-section {
  padding: 0 1.125rem;
  margin-bottom: 1.75rem;
}

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

.sidebar-link {
  display: block;
  width: 100%;
  text-align: left;
  background: transparent;
  border: none;
  font-family: var(--font-body);
  font-size: 0.8125rem;
  color: var(--text-muted);
  text-decoration: none;
  padding: 0.3125rem 0.5rem;
  border-radius: 0.25rem;
  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: 3rem 1.125rem 5rem;
  min-width: 0;
}

.doc-animate {
  opacity: 0;
  animation: fadeUp var(--anim-reveal);
}

.doc-breadcrumb {
  display: flex;
  align-items: center;
  gap: 0.5rem;
  font-family: var(--font-mono);
  font-size: 0.6875rem;
  color: var(--text-faint);
  margin-bottom: 2rem;
  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: 100%;
}

.markdown-body h1 {
  font-family: var(--font-display);
  font-size: clamp(1.75rem, 3.5vw, 2.5rem);
  font-weight: 400;
  color: var(--doc-h1);
  letter-spacing: -0.02em;
  line-height: 1.2;
  margin-bottom: 0.5rem;
  padding-bottom: 1rem;
  border-bottom: var(--border-w) solid var(--border);
}

.markdown-body .doc-meta {
  display: flex;
  gap: 1rem;
  margin-bottom: 2.25rem;
}

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

.markdown-body h2 {
  font-family: var(--font-display);
  font-size: clamp(1.25rem, 2.5vw, 1.625rem);
  font-weight: 400;
  color: var(--doc-h2);
  letter-spacing: -0.01em;
  line-height: 1.3;
  margin: 2.75rem 0 0.875rem;
  padding-bottom: 0.5rem;
  border-bottom: var(--border-w) solid var(--border);
}

.markdown-body h3 {
  font-size: 1.0625rem;
  font-weight: 500;
  color: var(--doc-h3);
  margin: 1.875rem 0 0.625rem;
}

.markdown-body h4 {
  font-size: 0.875rem;
  font-weight: 500;
  color: var(--doc-h4);
  letter-spacing: 0.04em;
  text-transform: uppercase;
  margin: 1.5rem 0 0.5rem;
}

.markdown-body p {
  margin-bottom: 1rem;
  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: var(--border-w) solid transparent;
  transition: border-color var(--transition), background var(--transition);
  padding: 0 0.125rem;
  border-radius: 0.125rem;
}

.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: 0.78125rem;
  color: var(--doc-code-text);
  background: var(--doc-code-bg);
  padding: 0.125rem 0.375rem;
  border-radius: 0.1875rem;
}

.markdown-body pre {
  background: var(--bg-code);
  border: var(--border-w) solid var(--border);
  border-radius: 0.5rem;
  padding: 1.25rem 1.5rem;
  overflow-x: auto;
  margin: 1.25rem 0;
}

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

.markdown-body blockquote {
  border-left: 0.1875rem solid var(--doc-blockquote-border);
  padding: 0.75rem 1.25rem;
  margin: 1.25rem 0;
  color: var(--doc-blockquote);
  font-style: italic;
  background: var(--bg-raised);
  border-radius: 0 0.375rem 0.375rem 0;
}

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

.markdown-body ul,
.markdown-body ol {
  padding-left: 1.375rem;
  margin-bottom: 1rem;
}

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

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

.markdown-body hr {
  border: none;
  border-top: var(--border-w) solid var(--border);
  margin: 2.25rem 0;
}

.markdown-body table {
  width: 100%;
  border-collapse: collapse;
  margin: 1.25rem 0;
  font-size: 0.84375rem;
}

.markdown-body th {
  background: var(--doc-table-hd);
  color: var(--doc-link);
  font-weight: 500;
  text-align: left;
  padding: 0.625rem 0.875rem;
  border-bottom: var(--border-w) solid var(--border);
  font-family: var(--font-mono);
  font-size: 0.71875rem;
  letter-spacing: 0.04em;
}

.markdown-body td {
  padding: 0.5625rem 0.875rem;
  border-bottom: var(--border-w) 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: 0.0625rem 0.1875rem;
  border-radius: 0.125rem;
}

/* ── Callout boxes ─────────────────────────────────────────────────────────── */
.callout {
  border-radius: 0.375rem;
  padding: 0.875rem 1.125rem;
  margin: 1.25rem 0;
  display: grid;
  grid-template-columns: 1.125rem 1fr;
  gap: 0.625rem;
  align-items: start;
  font-size: 0.875rem;
  line-height: 1.65;
}

.callout-note {
  background: rgba(74, 122, 107, 0.08);
  border: var(--border-w) solid rgba(74, 122, 107, 0.2);
  color: var(--doc-h3);
}

.callout-warn {
  background: rgba(180, 130, 60, 0.08);
  border: var(--border-w) solid rgba(180, 130, 60, 0.25);
  color: #b08040;
}

.callout-danger {
  background: rgba(180, 60, 60, 0.08);
  border: var(--border-w) solid rgba(180, 60, 60, 0.2);
  color: #a05050;
}

@media (prefers-color-scheme: dark) {
  .callout-warn   { color: #d4a055; }
  .callout-danger { color: #c96060; }
}

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

.doc-index-card {
  border: var(--border-w) solid var(--border);
  border-radius: 0.5rem;
  padding: 1.25rem;
  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: 0.65625rem;
  color: var(--text-faint);
  letter-spacing: 0.06em;
  margin-bottom: 0.5rem;
}

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

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

/* ── TOC ───────────────────────────────────────────────────────────────────── */
.toc {
  position: sticky;
  top: 5rem;
  font-size: 0.78125rem;
  color: var(--text-faint);
  border-left: var(--border-w) solid var(--border);
  padding-left: 1.125rem;
}

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

.toc a {
  display: block;
  color: var(--text-faint);
  text-decoration: none;
  padding: 0.1875rem 0;
  transition: color var(--transition);
}

.toc a:hover {
  color: var(--text-muted);
}

.toc a.h3 {
  padding-left: 0.75rem;
  font-size: 0.71875rem;
}

/* ── 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: 3.375rem;
  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: 48rem) {
  .page-wrap {
    grid-template-columns: 1fr;
  }

  .doc-main {
    padding: 0 1.125rem 3.75rem;
  }

  .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;
    position: sticky;
    top: 3.375rem;
    /* below main nav */
    z-index: 40;
    background: var(--bg);
    padding: 0.75rem 1.125rem;
    margin: 0 -1.125rem 1.5rem;
    border-bottom: var(--border-w) solid var(--border);
  }

  /* Toggle button — styled to stand out more */
  .sidebar-toggle {
    display: inline-flex;
    align-items: center;
    gap: 0.5625rem;
    padding: 0.5rem 0.875rem;
    background: var(--bg-raised);
    border: var(--border-w) solid var(--border-strong);
    color: var(--text);
    font-family: var(--font-mono);
    font-size: 0.6875rem;
    font-weight: 500;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    border-radius: var(--radius);
    cursor: pointer;
    -webkit-appearance: none;
    -moz-appearance: none;
    appearance: none;
    transition: all var(--transition);
    box-shadow: 0 0.125rem 0.5rem rgba(0, 0, 0, 0.05);
  }

  .sidebar-toggle:hover {
    background: var(--border);
    border-color: var(--text-faint);
    transform: translateY(-0.0625rem);
  }

  .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: 0.21875rem;
    width: 0.875rem;
    flex-shrink: 0;
  }

  .toggle-icon span {
    display: block;
    height: 0.09375rem;
    background: currentColor;
    border-radius: 0.0625rem;
    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(0.3125rem) 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(-0.3125rem) rotate(-45deg);
  }

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

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