/* ==========================================================================
   MIRASTACK LABS — Docs Layout Stylesheet
   Follows main.css token conventions exactly.
   Variables: --bg, --bg-alt, --bg-card, --text, --text-muted, --text-dim,
              --accent, --accent-glow, --border, --border-accent, --nav-bg
   ========================================================================== */

/* --------------------------------------------------------------------------
   0. Docs-specific theme tokens
   -------------------------------------------------------------------------- */
:root,
[data-theme="dark"] {
  /* #CED4DA = --mira-accent-neutral (logo 3rd stroke neutral gray) */
  --sidebar-nav-text: #CED4DA;
}

[data-theme="light"] {
  /* Deep navy-gray — readable on #F0F2F5 / #FFFFFF, brand-aligned */
  --sidebar-nav-text: #2D3340;
}

/* --------------------------------------------------------------------------
   1. Docs wrapper — two-column layout below the fixed 60px nav
   -------------------------------------------------------------------------- */
.docs-wrapper {
  display: flex;
  min-height: 100vh;
  padding-top: 60px;
}

/* --------------------------------------------------------------------------
   2. Sidebar
   -------------------------------------------------------------------------- */
.docs-sidebar {
  width: 280px;
  flex-shrink: 0;
  background: var(--bg-alt);
  border-right: 1px solid var(--border);
  padding: 2rem 1.5rem;
  position: sticky;
  top: 60px;
  height: calc(100vh - 60px);
  overflow-y: auto;
  scrollbar-width: thin;
  scrollbar-color: var(--border) transparent;
}

.docs-sidebar::-webkit-scrollbar { width: 4px; }
.docs-sidebar::-webkit-scrollbar-track { background: transparent; }
.docs-sidebar::-webkit-scrollbar-thumb { background: var(--border); }

/* --------------------------------------------------------------------------
   3. Search
   -------------------------------------------------------------------------- */
.docs-search {
  margin-bottom: 1.5rem;
  position: relative;
}

.search-input {
  width: 100%;
  padding: 0.5rem 0.75rem;
  background: var(--bg-card);
  color: var(--text);
  border: 1px solid var(--border);
  font-family: inherit;
  font-size: 0.78rem;
  letter-spacing: 0.04em;
  outline: none;
  transition: border-color 0.2s ease;
}

.search-input::placeholder { color: var(--text-dim); }
.search-input:focus { border-color: var(--accent); }

.search-results {
  position: absolute;
  top: 100%;
  left: 0;
  right: 0;
  background: var(--bg-card);
  border: 1px solid var(--accent);
  border-top: none;
  z-index: 100;
  max-height: 280px;
  overflow-y: auto;
  list-style: none;
  padding: 0;
  margin: 0;
  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.25);
}

.search-results li a {
  display: block;
  padding: 0.55rem 0.75rem;
  font-size: 0.78rem;
  color: var(--text-muted);
  text-decoration: none;
  border-bottom: 1px solid var(--border);
  transition: color 0.15s, background 0.15s;
}

.search-results li a:hover {
  color: var(--accent);
  background: var(--accent-glow);
}

.search-results li:last-child a { border-bottom: none; }

.search-results li.no-results {
  padding: 0.55rem 0.75rem;
  font-size: 0.78rem;
  color: var(--text-dim);
}

/* --------------------------------------------------------------------------
   4. Sidebar navigation list
   -------------------------------------------------------------------------- */
.docs-nav { font-size: 0.75rem; }

.nav-list {
  list-style: none;
  padding: 0;
  margin: 0;
}

.nav-list-item {
  position: relative;
  margin: 0;
}

/* Top-level links */
.nav-list > .nav-list-item > .nav-list-link {
  font-size: 0.7rem;
  font-weight: 600;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--sidebar-nav-text);
  padding: 0.55rem 0;
  display: block;
  text-decoration: none;
  border-bottom: 1px solid var(--border);
  transition: color 0.15s;
}

.nav-list > .nav-list-item > .nav-list-link:hover { color: var(--accent); opacity: 1; }

.nav-list > .nav-list-item.active > .nav-list-link,
.nav-list > .nav-list-item > .nav-list-link.active {
  color: var(--accent);
  border-bottom-color: var(--border-accent);
}

/* Child links (L2) */
.nav-list-l2 {
  list-style: none;
  padding: 0.25rem 0 0.5rem 0.75rem;
  margin: 0;
  border-left: 1px solid var(--border);
}

.nav-list-l2 .nav-list-link {
  display: block;
  padding: 0.35rem 0.5rem;
  font-size: 0.8rem;
  font-weight: 400;
  letter-spacing: 0.02em;
  color: var(--sidebar-nav-text);
  text-decoration: none;
  transition: color 0.15s;
  border-left: 2px solid transparent;
  margin-left: -1px;
}

.nav-list-l2 .nav-list-link:hover { color: var(--accent); opacity: 1; }

.nav-list-l2 .nav-list-item.active > .nav-list-link,
.nav-list-l2 .nav-list-link.active {
  color: var(--accent);
  border-left-color: var(--accent);
  background: var(--accent-glow);
}

/* Sub-section links (L3) */
.nav-list-l3 {
  list-style: none;
  padding: 0 0 0.25rem 0.75rem;
  margin: 0;
  border-left: 1px solid var(--border);
}

.nav-list-l3 .nav-list-link {
  display: block;
  padding: 0.3rem 0.5rem;
  font-size: 0.76rem;
  color: var(--sidebar-nav-text);
  text-decoration: none;
  transition: color 0.15s;
  border-left: 2px solid transparent;
  margin-left: -1px;
}

.nav-list-l3 .nav-list-link:hover { color: var(--accent); opacity: 1; }

.nav-list-l3 .nav-list-item.active > .nav-list-link,
.nav-list-l3 .nav-list-link.active {
  color: var(--accent);
  border-left-color: var(--accent);
}

/* Leaf links (L4) */
.nav-list-l4 {
  list-style: none;
  padding: 0 0 0.25rem 0.75rem;
  margin: 0;
  border-left: 1px solid var(--border);
}

.nav-list-l4 .nav-list-link {
  display: block;
  padding: 0.28rem 0.5rem;
  font-size: 0.72rem;
  color: var(--text-muted);
  text-decoration: none;
  transition: color 0.15s;
  border-left: 2px solid transparent;
  margin-left: -1px;
}

.nav-list-l4 .nav-list-link:hover { color: var(--accent); opacity: 1; }

.nav-list-l4 .nav-list-item.active > .nav-list-link,
.nav-list-l4 .nav-list-link.active {
  color: var(--accent);
  border-left-color: var(--accent);
}

/* Expander toggle */
.nav-list-expander {
  position: absolute;
  top: 0.4rem;
  right: 0;
  background: transparent;
  border: none;
  color: var(--text-dim);
  cursor: pointer;
  padding: 2px 4px;
  display: flex;
  align-items: center;
  justify-content: center;
  transition: color 0.15s;
}

.nav-list-expander:hover { color: var(--text-muted); }

.nav-list-expander svg {
  fill: currentColor;
  transform: rotate(-90deg);
  transition: transform 0.2s ease;
  width: 14px;
  height: 14px;
}

.nav-list-expander[aria-expanded="true"] svg { transform: rotate(0deg); }

/* --------------------------------------------------------------------------
   5. Main content container
   -------------------------------------------------------------------------- */
.docs-main-container {
  flex-grow: 1;
  min-width: 0;
  background: var(--bg);
}

.docs-main {
  max-width: 860px;
  margin: 0 auto;
  padding: 3rem 2.5rem 5rem;
}

/* --------------------------------------------------------------------------
   6. Breadcrumbs
   -------------------------------------------------------------------------- */
.docs-breadcrumbs { margin-bottom: 2rem; }

.docs-breadcrumbs ol {
  list-style: none;
  padding: 0;
  margin: 0;
  display: flex;
  flex-wrap: wrap;
}

.docs-breadcrumbs li {
  display: inline-flex;
  align-items: center;
  font-size: 0.7rem;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--text-dim);
}

.docs-breadcrumbs li:not(:last-child)::after {
  content: "/";
  margin: 0 0.5rem;
  color: var(--text-dim);
}

.docs-breadcrumbs li[aria-current="page"] { color: var(--text-muted); }

.docs-breadcrumbs a {
  color: var(--accent);
  text-decoration: none;
  opacity: 0.8;
  transition: opacity 0.15s;
  border-bottom: none;
}

.docs-breadcrumbs a:hover { opacity: 1; }

/* --------------------------------------------------------------------------
   7. Documentation content typography
   -------------------------------------------------------------------------- */
.docs-content {
  color: var(--text-muted);
  font-size: 1rem;
  line-height: 1.8;
}

.docs-content h1 {
  font-size: clamp(1.6rem, 3vw, 2.2rem);
  font-weight: 700;
  letter-spacing: -0.015em;
  line-height: 1.2;
  color: var(--text);
  margin: 0 0 0.75rem;
}

.docs-content h2 {
  font-size: 1.25rem;
  font-weight: 700;
  letter-spacing: -0.01em;
  color: var(--text);
  margin: 2.5rem 0 0.75rem;
  padding-bottom: 0.5rem;
  border-bottom: 1px solid var(--border);
}

.docs-content h3 {
  font-size: 1rem;
  font-weight: 600;
  letter-spacing: 0.02em;
  color: var(--text);
  margin: 2rem 0 0.5rem;
}

.docs-content h4 {
  font-size: 0.78rem;
  font-weight: 600;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--accent);
  margin: 1.5rem 0 0.4rem;
}

.docs-content p { margin-bottom: 1.2em; }

.docs-content ul,
.docs-content ol {
  padding-left: 1.5rem;
  margin-bottom: 1.2em;
}

.docs-content li { margin-bottom: 0.35em; }

.docs-content img {
  max-width: 100%;
  display: block;
  margin: 1.5rem 0;
  border: 1px solid var(--border);
}

.docs-content a {
  color: var(--accent);
  text-decoration: none;
  border-bottom: 1px solid var(--border-accent);
  transition: border-color 0.15s, opacity 0.15s;
}

.docs-content a:hover {
  opacity: 0.8;
  border-bottom-color: var(--accent);
}

.docs-content hr {
  border: none;
  border-top: 1px solid var(--border);
  margin: 2.5rem 0;
}

/* --------------------------------------------------------------------------
   8. Tables — match feature-matrix style from main.css
   -------------------------------------------------------------------------- */
.docs-content table {
  width: 100%;
  border-collapse: collapse;
  margin-bottom: 1.5rem;
  font-size: 0.88rem;
  border: 1px solid var(--border);
}

.docs-content th {
  background: var(--bg-card);
  font-size: 0.68rem;
  letter-spacing: 0.11em;
  text-transform: uppercase;
  color: var(--text-muted);
  font-weight: 600;
  padding: 0.75rem 1rem;
  text-align: left;
  border-bottom: 1px solid var(--border);
}

.docs-content td {
  padding: 0.75rem 1rem;
  border-bottom: 1px solid var(--border);
  color: var(--text-muted);
  vertical-align: top;
}

.docs-content tbody tr:nth-child(even) td { background: var(--bg-alt); }

/* --------------------------------------------------------------------------
   9. Inline code & code blocks
   -------------------------------------------------------------------------- */
.docs-content code {
  font-family: 'JetBrains Mono', 'Courier New', monospace;
  background: var(--bg-card);
  color: var(--accent);
  padding: 0.15em 0.4em;
  font-size: 0.82em;
  border: 1px solid var(--border);
}

.docs-content pre {
  position: relative;
  overflow-x: auto;
  border: 1px solid var(--border);
  border-radius: 4px;
  background: var(--bg-card);
  padding: 2.1rem 1rem 0.9rem;
  margin: 0 0 1.5rem;
  font-size: 0.85rem;
  line-height: 1.6;
  --code-lang-accent: var(--border-accent);
}

.docs-content pre[data-lang]::before {
  content: attr(data-lang);
  position: absolute;
  top: 0.38rem;
  right: 2.6rem;
  font-size: 0.68rem;
  line-height: 1;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--code-lang-accent);
  border: 1px solid var(--code-lang-accent);
  border-radius: 6px;
  padding: 0.08rem 0.4rem;
  background: var(--bg-alt);
  z-index: 2;
}

.docs-content pre::after {
  content: "";
  position: absolute;
  top: 0;
  left: 0;
  right: 0;
  height: 1.6rem;
  border-bottom: 1px solid var(--border);
  background:
    radial-gradient(circle at 0.9rem 0.8rem, #ff5f56 0.18rem, transparent 0.2rem),
    radial-gradient(circle at 1.55rem 0.8rem, #ffbd2e 0.18rem, transparent 0.2rem),
    radial-gradient(circle at 2.2rem 0.8rem, #27c93f 0.18rem, transparent 0.2rem),
    linear-gradient(180deg, rgba(255, 255, 255, 0.03), rgba(0, 0, 0, 0.05));
  border-radius: 4px 4px 0 0;
  pointer-events: none;
}

.docs-content pre[data-lang="javascript"],
.docs-content pre[data-lang="js"],
.docs-content pre[data-lang="typescript"],
.docs-content pre[data-lang="ts"] {
  --code-lang-accent: #eab308;
}

.docs-content pre[data-lang="python"],
.docs-content pre[data-lang="py"] {
  --code-lang-accent: #22d3ee;
}

.docs-content pre[data-lang="go"],
.docs-content pre[data-lang="golang"] {
  --code-lang-accent: #38bdf8;
}

.docs-content pre[data-lang="bash"],
.docs-content pre[data-lang="shell"],
.docs-content pre[data-lang="sh"] {
  --code-lang-accent: #f43f5e;
}

.docs-content pre code {
  background: transparent;
  border: none;
  padding: 0;
  color: var(--text);
  font-size: inherit;
  font-family: 'JetBrains Mono', 'Courier New', monospace;
  white-space: pre;
}

.docs-content pre code.has-line-numbers {
  display: block;
  counter-reset: code-line;
}

.docs-content pre code.has-line-numbers .code-line {
  display: block;
  position: relative;
  padding-left: 3rem;
  min-height: 1.28em;
}

.docs-content pre code.has-line-numbers .code-line::before {
  counter-increment: code-line;
  content: counter(code-line);
  position: absolute;
  left: 0;
  width: 2.2rem;
  text-align: right;
  color: var(--text-dim);
  opacity: 0.85;
  user-select: none;
}

.docs-content .highlighter-rouge,
.docs-content figure.highlight {
  position: relative;
  margin: 0 0 1.5rem;
  border-radius: 4px;
}

.docs-content .highlight {
  background: transparent;
}

.docs-content .highlighter-rouge pre,
.docs-content figure.highlight pre {
  margin: 0;
}

/* Copy button */
.copy-code-btn {
  position: absolute;
  top: 3px;
  right: 6px;
  background: var(--bg-alt);
  border: 1px solid var(--border);
  color: var(--text-dim);
  width: 24px;
  height: 24px;
  border-radius: 4px;
  padding: 3px;
  z-index: 10;
  display: flex;
  align-items: center;
  justify-content: center;
  cursor: pointer;
  opacity: 0;
  transition: opacity 0.15s, border-color 0.15s, color 0.15s;
}

.docs-content .highlighter-rouge:hover .copy-code-btn,
.docs-content figure.highlight:hover .copy-code-btn {
  opacity: 1;
}

.copy-code-btn:focus, .copy-code-btn:active { outline: none; }
.copy-code-btn:hover { border-color: var(--accent); color: var(--accent); }
.copy-code-btn.copied { border-color: var(--accent); color: var(--accent); opacity: 1; }

/* --------------------------------------------------------------------------
   10. Callout / Blockquote — match telegen-note from main.css
   -------------------------------------------------------------------------- */
.docs-content blockquote {
  margin: 1.5rem 0;
  padding: 1rem 1rem 1rem 1.25rem;
  border-left: 2px solid var(--accent);
  background: var(--bg-card);
  color: var(--text);
}

.docs-content blockquote p {
  margin-bottom: 0;
  color: var(--text);
  font-size: 0.95rem;
}

.docs-content blockquote > *:not(:last-child) { margin-bottom: 0.6rem; }

/* --------------------------------------------------------------------------
   11. Pagination footer
   -------------------------------------------------------------------------- */
.docs-separator {
  border: none;
  border-top: 1px solid var(--border);
  margin: 4rem 0 2rem;
}

.docs-footer {
  display: flex;
  flex-direction: column;
  gap: 1.5rem;
}

.docs-pagination {
  display: flex;
  justify-content: space-between;
  gap: 1rem;
}

.docs-pagination a {
  display: inline-flex;
  flex-direction: column;
  text-decoration: none;
  padding: 0.75rem 1.2rem;
  border: 1px solid var(--border);
  background: transparent;
  flex: 1;
  max-width: 48%;
  transition: border-color 0.2s ease, background 0.2s ease;
}

.docs-pagination a:hover {
  border-color: var(--accent);
  background: var(--accent-glow);
  opacity: 1;
}

.docs-pagination a.is-hidden { display: none; }

.docs-next { text-align: right; margin-left: auto; }

.pagination-label {
  font-size: 0.65rem;
  text-transform: uppercase;
  letter-spacing: 0.12em;
  color: var(--text-dim);
  margin-bottom: 0.3rem;
}

.pagination-title {
  font-size: 0.82rem;
  font-weight: 600;
  color: var(--accent);
  letter-spacing: 0.02em;
}

.docs-back-to-top { text-align: right; }

.docs-back-to-top a {
  font-size: 0.72rem;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--text-dim);
  text-decoration: none;
  border-bottom: none;
  transition: color 0.15s;
}

.docs-back-to-top a:hover { color: var(--accent); opacity: 1; }

/* --------------------------------------------------------------------------
   12. Responsive
   -------------------------------------------------------------------------- */
@media screen and (max-width: 860px) {
  .docs-wrapper { flex-direction: column; }

  .docs-sidebar {
    width: 100%;
    height: auto;
    position: static;
    border-right: none;
    border-bottom: 1px solid var(--border);
    padding: 1.5rem;
    top: auto;
  }

  .docs-main { padding: 2rem 1.25rem 3rem; }

  .docs-pagination { flex-direction: column; }
  .docs-pagination a { max-width: 100%; }
}

/* --------------------------------------------------------------------------
   Callout blocks (converted from Sphinx admonitions)
   -------------------------------------------------------------------------- */
.callout {
  border-left: 3px solid var(--border-accent);
  background: var(--bg-card);
  border-radius: 0 4px 4px 0;
  padding: 0.9rem 1.1rem;
  margin: 1.5rem 0;
  font-size: 0.88rem;
  line-height: 1.65;
  position: relative;
}

.callout::before {
  display: block;
  font-size: 0.7rem;
  font-weight: 700;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  margin-bottom: 0.5rem;
  opacity: 0.9;
}

.callout-tip  { border-left-color: var(--accent); }
.callout-tip::before  { content: "Tip"; color: var(--accent); }

.callout-note { border-left-color: #5A9FD4; }
.callout-note::before { content: "Note"; color: #5A9FD4; }

.callout-warning { border-left-color: var(--accent-red); }
.callout-warning::before { content: "Warning"; color: var(--accent-red); }

.callout-important { border-left-color: #FF671F; }
.callout-important::before { content: "Important"; color: #FF671F; }

.callout-caution { border-left-color: #FF671F; }
.callout-caution::before { content: "Caution"; color: #FF671F; }

/* code inside callouts */
.callout pre { margin: 0.75rem 0 0; }

/* --------------------------------------------------------------------------
   Feature grid (converted from Sphinx {grid} directives)
   -------------------------------------------------------------------------- */
.docs-feature-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
  gap: 1rem;
  margin: 1.5rem 0;
}

.docs-feature-card {
  background: var(--bg-card);
  border: 1px solid var(--border);
  border-radius: 4px;
  padding: 1rem 1.1rem;
  transition: border-color 0.2s;
}

.docs-feature-card:hover { border-color: var(--border-accent); }

.docs-feature-card__title {
  font-size: 0.78rem;
  font-weight: 700;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--accent);
  margin-bottom: 0.45rem;
}

.docs-feature-card__body {
  font-size: 0.83rem;
  color: var(--text-muted);
  line-height: 1.5;
}

/* --------------------------------------------------------------------------
   Mermaid diagrams
   -------------------------------------------------------------------------- */
.docs-content .mermaid {
  position: relative;
  margin: 1.5rem 0;
  padding: 2rem 1rem 1rem;
  border: 1px solid var(--border);
  border-radius: 4px;
  background:
    radial-gradient(circle at 20% 15%, var(--accent-glow), transparent 48%),
    var(--bg-card);
  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.18);
  overflow-x: auto;
  overflow-y: visible;
  -webkit-overflow-scrolling: touch;
  overscroll-behavior-x: contain;
  cursor: zoom-in;
  text-align: center;
}

.docs-content .mermaid[data-lang]::before {
  content: "DIAGRAM";
  position: absolute;
  top: 0.5rem;
  right: 0.6rem;
  font-size: 0.68rem;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--accent);
  border: 1px solid var(--accent);
  border-radius: 6px;
  padding: 0.08rem 0.4rem;
  background: var(--bg-alt);
}

.docs-content .mermaid svg {
  display: block;
  width: 100%;
  max-width: 100%;
  height: auto;
}

/* Node shapes */
.docs-content .mermaid .node rect,
.docs-content .mermaid .node polygon,
.docs-content .mermaid .node circle,
.docs-content .mermaid .node ellipse {
  fill: var(--table-head-bg) !important;
  stroke: var(--border-accent) !important;
  stroke-width: 1.4px !important;
}

/* Node text */
.docs-content .mermaid .node .label,
.docs-content .mermaid .nodeLabel,
.docs-content .mermaid .label text,
.docs-content .mermaid text {
  fill: var(--text) !important;
  color: var(--text) !important;
}

/* Subgraph clusters */
.docs-content .mermaid .cluster rect {
  fill: var(--bg) !important;
  stroke: var(--border-accent) !important;
  stroke-width: 1.2px !important;
}

.docs-content .mermaid .cluster-label text,
.docs-content .mermaid .cluster-label span {
  fill: var(--text-muted) !important;
  color: var(--text-muted) !important;
}

/* Edges */
.docs-content .mermaid .edgePath path,
.docs-content .mermaid .flowchart-link {
  stroke: var(--accent) !important;
  stroke-width: 1.7px !important;
}

.docs-content .mermaid marker path {
  fill: var(--accent) !important;
  stroke: var(--accent) !important;
}

.docs-content .mermaid .edgeLabel,
.docs-content .mermaid .edgeLabel rect {
  background: var(--bg-card) !important;
  fill: var(--bg-card) !important;
}

/* Mobile: ensure diagram fits in viewport */
@media (max-width: 860px) {
  .docs-content .mermaid {
    padding: 1.8rem 0.6rem 0.8rem;
  }
}

/* Zoom modal (shared with blog) */
.mermaid-zoom-modal {
  display: none;
  position: fixed;
  inset: 0;
  background: rgba(0, 0, 0, 0.78);
  z-index: 9999;
  align-items: center;
  justify-content: center;
}
.mermaid-zoom-modal.active { display: flex; }

.mermaid-zoom-close {
  position: absolute;
  top: 1rem;
  right: 1.25rem;
  background: none;
  border: none;
  color: #fff;
  font-size: 2rem;
  cursor: pointer;
  z-index: 10000;
  line-height: 1;
}

.mermaid-zoom-content {
  overflow: auto;
  max-width: 90vw;
  max-height: 85vh;
  cursor: grab;
  background: var(--bg-card);
  border-radius: 4px;
  padding: 1.5rem;
}