/* ==========================================================================
   MiniAgentic Docs — Architecture guide
   Extends landing brand tokens (accent #ff6b1a · near-black · mono)
   ========================================================================== */

:root {
  --docs-sidebar: 260px;
  --docs-rail: 1px solid var(--line);
}

body.docs-page {
  cursor: none;
}

body.docs-page.is-touch { cursor: auto; }

.docs-shell {
  position: relative;
  z-index: 1;
  min-height: 100vh;
  padding-top: var(--nav-h);
  padding-left: var(--docs-sidebar);
}

/* ---------- Sidebar (fixed) ---------- */
.docs-side {
  position: fixed;
  left: 0;
  top: var(--nav-h);
  width: var(--docs-sidebar);
  height: calc(100vh - var(--nav-h));
  z-index: 40;
  overflow-y: auto;
  overscroll-behavior: contain;
  border-right: var(--docs-rail);
  background: rgba(10, 10, 10, 0.88);
  backdrop-filter: blur(14px);
  -webkit-backdrop-filter: blur(14px);
  padding: 28px 18px 48px;
}

.docs-side__label {
  font-family: var(--font-mono);
  font-size: 0.62rem;
  letter-spacing: 0.16em;
  text-transform: uppercase;
  color: var(--accent);
  margin: 0 10px 14px;
}

.docs-toc {
  list-style: none;
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.docs-toc a {
  display: block;
  padding: 9px 10px;
  border-radius: var(--radius-sm);
  font-family: var(--font-mono);
  font-size: 0.78rem;
  color: var(--ink-dim);
  border: 1px solid transparent;
  transition: color 0.25s, background 0.25s, border-color 0.25s;
}

.docs-toc a:hover {
  color: var(--ink);
  background: var(--surface);
}

.docs-toc a.is-active {
  color: var(--accent);
  border-color: rgba(255, 107, 26, 0.35);
  background: var(--accent-soft);
}

.docs-toc__group {
  margin-top: 18px;
  padding-top: 14px;
  border-top: 1px solid var(--line);
}

.docs-toc__group-title {
  font-family: var(--font-mono);
  font-size: 0.6rem;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--ink-mute);
  margin: 0 10px 8px;
}

/* ---------- Main column ---------- */
.docs-main {
  min-width: 0;
  padding: 40px clamp(20px, 4vw, 56px) 100px;
  max-width: 1100px;
}

.docs-hero {
  margin-bottom: 56px;
  padding-bottom: 40px;
  border-bottom: 1px solid var(--line);
}

.docs-hero h1 {
  font-family: var(--font-display);
  font-size: clamp(2rem, 4.2vw, 3.2rem);
  letter-spacing: -0.035em;
  line-height: 1.08;
  margin: 0.6rem 0 1rem;
}

.docs-hero p {
  color: var(--ink-dim);
  max-width: 560px;
  font-size: 1.05rem;
}

.docs-hero__meta {
  display: flex;
  flex-wrap: wrap;
  gap: 10px;
  margin-top: 1.4rem;
}

.docs-pill {
  font-family: var(--font-mono);
  font-size: 0.68rem;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  padding: 6px 10px;
  border: 1px solid var(--line-strong);
  border-radius: 999px;
  color: var(--ink-mute);
}

.docs-pill--accent {
  border-color: var(--accent-dim);
  color: var(--accent);
  background: var(--accent-soft);
}

/* ---------- Chapters / rooms ---------- */
.docs-room {
  scroll-margin-top: calc(var(--nav-h) + 24px);
  margin-bottom: 72px;
  padding: 28px 0 8px;
}

.docs-room__head {
  margin-bottom: 24px;
}

.docs-room__idx {
  font-family: var(--font-mono);
  font-size: 0.68rem;
  letter-spacing: 0.16em;
  color: var(--accent);
  text-transform: uppercase;
}

.docs-room h2 {
  font-family: var(--font-display);
  font-size: clamp(1.5rem, 2.8vw, 2.1rem);
  letter-spacing: -0.03em;
  margin: 0.45rem 0 0.7rem;
}

.docs-room__lede {
  color: var(--ink-dim);
  max-width: 620px;
}

.docs-grid {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 20px;
  align-items: start;
}

.docs-grid--stack {
  grid-template-columns: 1fr;
}

.docs-card {
  border: 1px solid var(--line);
  border-radius: var(--radius);
  background: var(--bg-elevated);
  padding: 20px 18px;
  transition: border-color 0.35s, box-shadow 0.35s;
}

.docs-card:hover {
  border-color: rgba(255, 107, 26, 0.28);
  box-shadow: 0 0 32px rgba(255, 107, 26, 0.06);
}

.docs-card h3 {
  font-family: var(--font-mono);
  font-size: 0.85rem;
  letter-spacing: 0.04em;
  margin-bottom: 10px;
  color: var(--ink);
}

.docs-card p,
.docs-card li {
  color: var(--ink-dim);
  font-size: 0.92rem;
}

.docs-card ul {
  margin: 8px 0 0 1.1rem;
  display: flex;
  flex-direction: column;
  gap: 6px;
}

.docs-card code,
.docs-prose code {
  font-family: var(--font-mono);
  font-size: 0.85em;
  color: var(--accent);
}

.docs-prose {
  color: var(--ink-dim);
  font-size: 0.95rem;
  line-height: 1.65;
}

.docs-prose + .docs-prose { margin-top: 12px; }

.docs-prose strong { color: var(--ink); font-weight: 600; }

/* ---------- Flow stepper ---------- */
.flow {
  border: 1px solid var(--line);
  border-radius: var(--radius);
  background: var(--bg);
  overflow: hidden;
}

.flow__track {
  display: flex;
  flex-direction: column;
  gap: 0;
}

.flow__step {
  display: grid;
  grid-template-columns: 56px 1fr;
  gap: 12px;
  padding: 14px 16px;
  border-bottom: 1px solid var(--line);
  opacity: 0.35;
  transform: translateX(-6px);
  transition: opacity 0.45s var(--ease-out), transform 0.45s var(--ease-out), background 0.35s;
}

.flow__step:last-child { border-bottom: none; }

.flow__step.is-on {
  opacity: 1;
  transform: none;
  background: rgba(255, 107, 26, 0.05);
}

.flow__step.is-done {
  opacity: 0.72;
  transform: none;
}

.flow__n {
  font-family: var(--font-mono);
  font-size: 0.72rem;
  color: var(--accent);
  letter-spacing: 0.08em;
  padding-top: 2px;
}

.flow__body strong {
  display: block;
  font-family: var(--font-mono);
  font-size: 0.82rem;
  color: var(--ink);
  margin-bottom: 4px;
}

.flow__body span {
  font-size: 0.85rem;
  color: var(--ink-dim);
}

.flow__controls {
  display: flex;
  gap: 8px;
  padding: 12px 14px;
  border-top: 1px solid var(--line);
  background: var(--bg-elevated);
}

/* ---------- Layers stack ---------- */
.layers {
  display: flex;
  flex-direction: column;
  gap: 8px;
}

.layer {
  border: 1px solid var(--line);
  border-radius: var(--radius);
  padding: 14px 16px;
  background: var(--bg-elevated);
  transition: border-color 0.35s, background 0.35s, transform 0.35s var(--ease-out);
}

.layer.is-hot {
  border-color: var(--accent-dim);
  background: linear-gradient(90deg, var(--accent-soft), var(--bg-elevated));
  transform: translateX(4px);
}

.layer__n {
  font-family: var(--font-mono);
  font-size: 0.65rem;
  letter-spacing: 0.14em;
  color: var(--accent);
}

.layer strong {
  display: block;
  margin: 4px 0 2px;
  font-size: 0.95rem;
}

.layer em {
  font-style: normal;
  font-size: 0.82rem;
  color: var(--ink-mute);
  font-family: var(--font-mono);
}

/* ---------- Code block ---------- */
.docs-code {
  border: 1px solid var(--line-strong);
  border-radius: var(--radius);
  background: #0d0d0d;
  overflow: hidden;
}

.docs-code__bar {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 8px 12px;
  border-bottom: 1px solid var(--line);
  font-family: var(--font-mono);
  font-size: 0.68rem;
  color: var(--ink-mute);
}

.docs-code pre {
  margin: 0;
  padding: 16px;
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 0.78rem;
  line-height: 1.55;
  color: var(--ink);
}

.docs-code .cm-key { color: var(--accent); }
.docs-code .cm-str { color: rgba(236, 234, 228, 0.75); }
.docs-code .cm-cmt { color: var(--ink-mute); }
.docs-code .cm-fn { color: #ffb07a; }

/* ---------- Module map ---------- */
.mod-map {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: 10px;
}

.mod-node {
  border: 1px solid var(--line);
  border-radius: var(--radius);
  padding: 14px;
  background: var(--bg-elevated);
  font-family: var(--font-mono);
  font-size: 0.78rem;
  transition: border-color 0.3s, box-shadow 0.3s;
}

.mod-node.is-lit {
  border-color: var(--accent);
  box-shadow: 0 0 24px rgba(255, 107, 26, 0.12);
}

.mod-node strong {
  display: block;
  color: var(--accent);
  margin-bottom: 4px;
  font-size: 0.72rem;
  letter-spacing: 0.06em;
}

.mod-node span { color: var(--ink-dim); }

/* ---------- Table ---------- */
.docs-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.88rem;
}

.docs-table th,
.docs-table td {
  text-align: left;
  padding: 10px 12px;
  border-bottom: 1px solid var(--line);
  vertical-align: top;
}

.docs-table th {
  font-family: var(--font-mono);
  font-size: 0.68rem;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--accent);
  font-weight: 600;
}

.docs-table td { color: var(--ink-dim); }
.docs-table td code { color: var(--accent); }

.docs-table-wrap {
  border: 1px solid var(--line);
  border-radius: var(--radius);
  overflow: auto;
  background: var(--bg-elevated);
}

/* ---------- Term in docs ---------- */
.docs-term {
  margin: 0;
}

.docs-term .term--lg {
  animation: none;
  max-width: none;
  margin: 0;
}

.docs-term .term__body {
  min-height: 280px;
  max-height: 420px;
}

.docs-term__actions {
  display: flex;
  gap: 8px;
  margin-top: 10px;
}

/* ---------- Callout ---------- */
.callout {
  border-left: 2px solid var(--accent);
  background: var(--accent-soft);
  padding: 14px 16px;
  border-radius: 0 var(--radius) var(--radius) 0;
  color: var(--ink-dim);
  font-size: 0.9rem;
}

.callout strong { color: var(--ink); }

/* ---------- Glossary ---------- */
.gloss {
  display: grid;
  grid-template-columns: 140px 1fr;
  gap: 8px 16px;
  font-size: 0.9rem;
}

.gloss dt {
  font-family: var(--font-mono);
  font-size: 0.78rem;
  color: var(--accent);
}

.gloss dd { color: var(--ink-dim); margin: 0; }

/* ---------- Docs nav (top) overrides ---------- */
.docs-page .nav__links a[href*="docs"] {
  color: var(--accent);
}

.docs-burger-panel a {
  color: var(--ink);
}

/* ---------- Responsive ---------- */
@media (max-width: 960px) {
  .docs-shell {
    padding-left: 0;
  }

  .docs-side {
    position: fixed;
    z-index: 900;
    left: 0;
    top: var(--nav-h);
    width: min(300px, 86vw);
    height: calc(100vh - var(--nav-h));
    transform: translateX(-105%);
    transition: transform 0.35s var(--ease-out);
    box-shadow: 20px 0 60px rgba(0,0,0,0.5);
  }

  .docs-side.is-open {
    transform: translateX(0);
  }

  .docs-grid {
    grid-template-columns: 1fr;
  }

  .mod-map {
    grid-template-columns: 1fr;
  }

  .docs-toc-toggle {
    display: inline-flex !important;
  }
}

.docs-toc-toggle {
  display: none;
  margin-bottom: 16px;
}

@media (prefers-reduced-motion: reduce) {
  .flow__step,
  .layer,
  .mod-node {
    transition: none !important;
  }
}