/* ─────────────────────────────────────────────────────────────────
   docs.css — stylesheet for /docs
   Layered on top of Bootstrap 5. Uses tenant CSS variables defined
   in base.html so dark / light palettes auto-apply.
   ───────────────────────────────────────────────────────────────── */

/* ── Page wrapper ──────────────────────────────────────────────── */
.docs-page {
  color: var(--text);
}
.docs-page .container {
  max-width: 1180px;
}

/* ── Header band ───────────────────────────────────────────────── */
.docs-header {
  padding: 2.4rem 0 2rem;
  background: linear-gradient(
    180deg,
    var(--accent-dim-light, var(--accent-dim)) 0%,
    transparent 100%);
  border-bottom: 1px solid var(--border);
}
.docs-eyebrow {
  text-transform: uppercase;
  letter-spacing: 0.14em;
  font-size: 0.74rem;
  font-weight: 700;
  color: var(--accent);
  margin: 0 0 0.6rem 0;
}
.docs-h1 {
  font-size: clamp(1.6rem, 2.8vw, 2.2rem);
  font-weight: 800;
  color: var(--text);
  letter-spacing: -0.01em;
  margin: 0 0 0.7rem 0;
  line-height: 1.2;
}
.docs-lead {
  font-size: 1.02rem;
  line-height: 1.65;
  color: var(--text);
  margin: 0 0 1.2rem 0;
  max-width: 80ch;
}

/* ── Audience-routing cards in the header ──────────────────────── */
.docs-route { margin-top: 0.8rem; }
.docs-route-card {
  display: flex;
  flex-direction: column;
  gap: 0.25rem;
  padding: 0.9rem 1.1rem;
  background: var(--bg);
  border: 1px solid var(--border);
  border-left: 3px solid var(--accent);
  border-radius: 6px;
  color: var(--text);
  text-decoration: none;
  height: 100%;
  transition: background 0.12s ease, transform 0.12s ease;
}
.docs-route-card:hover {
  background: var(--surface-hover, var(--surface));
  transform: translateY(-1px);
  color: var(--text);
  text-decoration: none;
}
.docs-route-eyebrow {
  font-size: 0.7rem;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--muted);
}
.docs-route-h {
  font-size: 1rem;
  font-weight: 700;
  color: var(--accent);
}
.docs-route-sub {
  font-size: 0.86rem;
  color: var(--muted);
  line-height: 1.4;
}

/* ── Body wrap (Bootstrap row holds TOC + content) ─────────────── */
.docs-body-wrap {
  padding-top: 2rem;
  padding-bottom: 4rem;
}

/* ── TOC sidebar ───────────────────────────────────────────────── */
.docs-toc-col { position: relative; }
.docs-toc {
  position: sticky;
  top: 80px;
  max-height: calc(100vh - 110px);
  overflow-y: auto;
  padding: 0.9rem 0.8rem;
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: 8px;
  font-size: 0.86rem;
}
.docs-toc-title {
  font-weight: 700;
  color: var(--muted);
  text-transform: uppercase;
  letter-spacing: 0.06em;
  font-size: 0.7rem;
  margin: 0 0 0.6rem 0.4rem;
}
.docs-toc .nav-link {
  color: var(--text);
  padding: 0.3rem 0.6rem;
  border-radius: 4px;
  border-left: 2px solid transparent;
  font-weight: 500;
  transition: background 0.12s ease, color 0.12s ease, border-color 0.12s ease;
}
.docs-toc .nav-link:hover {
  background: var(--surface-hover, var(--surface));
  color: var(--accent);
}
.docs-toc .nav-link.active {
  background: var(--accent-dim);
  color: var(--accent);
  border-left-color: var(--accent);
  font-weight: 700;
}
.docs-toc-sub {
  margin-left: 0.7rem;
  padding-left: 0.6rem;
  border-left: 1px solid var(--divider);
}
.docs-toc-sub .nav-link {
  font-size: 0.8rem;
  padding: 0.18rem 0.55rem;
  color: var(--muted);
  font-weight: 400;
}
.docs-toc-sub .nav-link.active {
  font-weight: 600;
}

@media (max-width: 991px) {
  .docs-toc {
    position: static;
    max-height: none;
    margin-bottom: 1rem;
  }
}

/* ── Body article ──────────────────────────────────────────────── */
.docs-body {
  min-width: 0;
  line-height: 1.65;
  color: var(--text);
}
.docs-body h2 {
  margin: 2.6rem 0 0.8rem 0;
  font-size: 1.45rem;
  font-weight: 700;
  color: var(--text);
  padding-bottom: 0.4rem;
  border-bottom: 1px solid var(--divider);
  scroll-margin-top: 80px;
}
.docs-body h2:first-child { margin-top: 0; }
.docs-body h3 {
  margin: 1.5rem 0 0.6rem 0;
  font-size: 1.1rem;
  font-weight: 700;
  color: var(--accent);
  scroll-margin-top: 80px;
}
.docs-body section { scroll-margin-top: 80px; }
.docs-body p {
  margin: 0.6rem 0;
  color: var(--text);
}
.docs-body ul, .docs-body ol {
  padding-left: 1.4rem;
  margin: 0.6rem 0;
}
.docs-body li { margin: 0.25rem 0; }
.docs-body a {
  color: var(--accent);
  text-decoration: none;
}
.docs-body a:hover { text-decoration: underline; }
.docs-body code {
  background: var(--code-bg);
  color: var(--text);
  padding: 0.06rem 0.4rem;
  border-radius: 3px;
  font-family: var(--font-mono);
  font-size: 0.85em;
  border: 1px solid var(--divider);
}
.docs-body strong {
  color: var(--text);
  font-weight: 700;
}
.docs-body dl { margin: 1rem 0; }
.docs-body dt {
  font-weight: 700;
  color: var(--text);
  margin-top: 1rem;
}
.docs-body dd {
  margin: 0.3rem 0 0 0;
  color: var(--muted);
  padding-left: 0.9rem;
  border-left: 2px solid var(--divider);
}
.docs-body kbd {
  font-family: var(--font-mono);
  font-size: 0.78em;
  padding: 0.1rem 0.4rem;
  background: var(--code-bg);
  border: 1px solid var(--divider);
  border-bottom-width: 2px;
  border-radius: 3px;
  color: var(--text);
}

.docs-toc-hint {
  color: var(--muted);
  font-size: 0.88rem;
  margin: 0.4rem 0 0.6rem 0;
}

/* ── Callout box (info / tip / warning) ────────────────────────── */
.docs-callout {
  margin: 1rem 0;
  padding: 0.85rem 1rem;
  background: var(--accent-dim-light, var(--accent-dim));
  border-left: 3px solid var(--accent);
  border-radius: 0 6px 6px 0;
  font-size: 0.92rem;
  line-height: 1.55;
}
.docs-callout strong { color: var(--accent); }
.docs-callout ul, .docs-callout ol { margin-bottom: 0; }

/* ── Featured tip (the standout "top tip" block) ───────────────── */
.docs-featured-tip {
  margin: 1.2rem 0;
  padding: 1rem 1.1rem;
  background: var(--accent-dim);
  border-left: 4px solid var(--accent-alt, var(--accent));
  border-radius: 0 6px 6px 0;
  font-size: 0.96rem;
  line-height: 1.6;
}
.docs-tip-label {
  display: inline-block;
  background: var(--accent-alt, var(--accent));
  color: var(--bg);
  font-size: 0.66rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  padding: 0.15rem 0.5rem;
  border-radius: 3px;
  margin-right: 0.5rem;
  vertical-align: middle;
}

/* ── Phase headings inside Extending ───────────────────────────── */
.docs-phase {
  margin-top: 1.6rem;
  padding: 0.35rem 0.8rem;
  background: var(--surface-hover, var(--surface));
  border-left: 3px solid var(--accent);
  font-size: 0.76rem;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  font-weight: 700;
  color: var(--accent);
  border-radius: 0 4px 4px 0;
  scroll-margin-top: 80px;
}

/* ── Pipeline flow (How a session works) ───────────────────────── */
.docs-flow {
  list-style: none;
  counter-reset: flowstep;
  padding: 0;
  margin: 1rem 0;
}
.docs-flow > li {
  counter-increment: flowstep;
  position: relative;
  padding: 0.85rem 1rem 0.85rem 3.6rem;
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: 6px;
  margin: 0 0 0.45rem 0;
}
.docs-flow > li::before {
  content: counter(flowstep);
  position: absolute;
  left: 0.85rem;
  top: 0.85rem;
  width: 28px;
  height: 28px;
  line-height: 28px;
  text-align: center;
  background: var(--accent);
  color: var(--bg);
  border-radius: 50%;
  font-weight: 700;
  font-family: var(--font-mono);
  font-size: 0.88rem;
}
.docs-flow > li + li::after {
  content: "";
  position: absolute;
  left: 1.65rem;
  top: -0.5rem;
  width: 2px;
  height: 0.5rem;
  background: var(--divider);
}
.docs-flow strong { color: var(--accent); }

/* ── Use-case <details> blocks ─────────────────────────────────── */
.docs-case {
  margin: 1.5rem 0;
  padding: 1.1rem 1.2rem;
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: 8px;
  scroll-margin-top: 80px;
}
.docs-case details > summary {
  cursor: pointer;
  list-style: none;
  font-size: 1.05rem;
  font-weight: 700;
  color: var(--text);
  display: flex;
  align-items: center;
  gap: 0.5rem;
}
.docs-case details > summary::-webkit-details-marker { display: none; }
.docs-case details > summary::before {
  content: "\25B8";
  color: var(--accent);
  transition: transform 0.15s ease;
  display: inline-block;
  font-size: 0.85em;
}
.docs-case details[open] > summary::before {
  transform: rotate(90deg);
}

/* ── Prompt blocks ─────────────────────────────────────────────── */
.docs-prompt {
  margin: 0.9rem 0 0.4rem;
  padding: 0.75rem 0.9rem 0.75rem 2.8rem;
  background: var(--surface-hover, var(--surface));
  border-left: 3px solid var(--accent-alt, var(--accent));
  border-radius: 0 4px 4px 0;
  font-family: var(--font-mono);
  font-size: 0.88rem;
  position: relative;
}
.docs-prompt::before {
  content: ">";
  position: absolute;
  left: 1rem;
  top: 0.75rem;
  color: var(--accent-alt, var(--accent));
  font-weight: 700;
}
.docs-prompt p {
  margin: 0;
  font-family: var(--font-stack);
}
.docs-tag {
  display: inline-block;
  position: absolute;
  left: 1rem;
  top: -0.6rem;
  background: var(--accent-alt, var(--accent));
  color: var(--bg);
  font-family: var(--font-stack);
  font-size: 0.66rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  padding: 0.12rem 0.45rem;
  border-radius: 3px;
}
.docs-what {
  margin: 0.25rem 0 0 !important;
  color: var(--muted);
  font-size: 0.9rem;
  padding-left: 0.75rem;
  border-left: 2px solid var(--divider);
}

/* ── Code blocks (BAD / GOOD, YAML snippet) ────────────────────── */
.docs-yaml,
.docs-code {
  background: var(--code-bg);
  border: 1px solid var(--divider);
  border-radius: 6px;
  padding: 0.75rem 0.9rem;
  margin: 0.6rem 0;
  font-family: var(--font-mono);
  font-size: 0.84rem;
  line-height: 1.55;
  overflow-x: auto;
}
.docs-code-tight {
  padding: 0.5rem 0.65rem;
  margin: 0.25rem 0 0.6rem;
  font-size: 0.82rem;
}
.docs-code-label {
  margin: 0.6rem 0 0.25rem;
  color: var(--muted);
  font-size: 0.88rem;
}

/* ── Tool grid + alias grid (uses Bootstrap row/col, this just tightens) ── */
.docs-tool-grid,
.docs-alias-grid {
  list-style: none;
  padding: 0;
  margin: 0.6rem 0;
}
.docs-tool-grid > li {
  padding: 0.4rem 0.6rem;
  border-left: 2px solid var(--divider);
  font-size: 0.9rem;
}
.docs-alias-grid > li {
  padding: 0.2rem 0.5rem;
  border-left: 2px solid var(--divider);
  font-size: 0.86rem;
}

/* ── Badge variants for tool tags ──────────────────────────────── */
.badge.text-bg-success-soft {
  background: var(--accent-dim);
  color: var(--accent);
  font-size: 0.66rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  padding: 0.15rem 0.45rem;
  border-radius: 3px;
  vertical-align: middle;
}
.badge.text-bg-muted-soft {
  background: var(--surface-hover, var(--surface));
  color: var(--muted);
  border: 1px solid var(--divider);
  font-size: 0.66rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  padding: 0.15rem 0.45rem;
  border-radius: 3px;
  vertical-align: middle;
}