/* guides.css — shared styling for CMS-0057-F guide + implementation pages.
   Reuses the same design tokens, nav, and content rhythm as the hand-written
   pages so guides are visually indistinguishable from the rest of the site.
   Also defines the reusable, responsive diagram framework (.flow / .landscape). */

:root {
  --bg-primary: #0a0e17;
  --bg-secondary: #0f1420;
  --bg-card: #141925;
  --bg-card-hover: #1a2030;
  --border: #1e2738;
  --border-accent: #2a3a5c;
  --text-primary: #e8ecf4;
  --text-secondary: #8b95a8;
  --text-muted: #5c6578;
  --accent-blue: #4a9eff;
  --accent-blue-dim: #2a6ec0;
  --accent-cyan: #22d3ee;
  --accent-green: #34d399;
  --accent-amber: #f59e0b;
  --accent-rose: #f472b6;
  --accent-purple: #a78bfa;
  --font-body: 'DM Sans', -apple-system, BlinkMacSystemFont, sans-serif;
  --font-display: 'Instrument Serif', Georgia, serif;
  --font-mono: 'JetBrains Mono', ui-monospace, monospace;
}

*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }

body {
  font-family: var(--font-body);
  background: var(--bg-primary);
  color: var(--text-primary);
  line-height: 1.7;
  -webkit-font-smoothing: antialiased;
}

/* NAV (matches index/API pages) */
nav {
  position: fixed; top: 0; left: 0; right: 0; z-index: 100;
  background: rgba(10, 14, 23, .85);
  backdrop-filter: blur(20px);
  border-bottom: 1px solid var(--border);
  padding: 0 2rem;
}
.nav-inner {
  max-width: 1280px; margin: 0 auto;
  display: flex; align-items: center; justify-content: space-between;
  height: 64px;
}
.nav-logo {
  font-family: var(--font-mono); font-size: .85rem; font-weight: 500;
  color: var(--accent-blue); text-decoration: none; letter-spacing: .05em;
}
.nav-logo span { color: var(--text-muted); }
.nav-links { display: flex; gap: 1.75rem; list-style: none; flex-wrap: wrap; }
.nav-links a {
  color: var(--text-secondary); text-decoration: none; font-size: .82rem;
  font-weight: 500; letter-spacing: .02em; transition: color .2s;
}
.nav-links a:hover { color: var(--text-primary); }
.nav-links a.active { color: var(--accent-blue); }

/* HEADER */
.page-header { padding: 8rem 2rem 3rem; max-width: 920px; margin: 0 auto; }
.breadcrumb {
  font-size: .75rem; color: var(--text-muted); margin-bottom: 2rem;
  font-family: var(--font-mono);
}
.breadcrumb a { color: var(--text-muted); text-decoration: none; }
.breadcrumb a:hover { color: var(--accent-blue); }
.breadcrumb span[aria-current] { color: var(--text-secondary); }
.eyebrow {
  font-family: var(--font-mono); font-size: .7rem; color: var(--accent-blue);
  text-transform: uppercase; letter-spacing: .15em; font-weight: 500;
  margin-bottom: 1rem; display: block;
}
.page-header h1 {
  font-family: var(--font-display); font-size: clamp(2.2rem, 5vw, 3.3rem);
  font-weight: 400; line-height: 1.15; margin-bottom: 1.25rem;
}
.page-header h1 em { font-style: italic; color: var(--accent-blue); }
.page-header .lead {
  font-size: 1.1rem; color: var(--text-secondary); line-height: 1.8;
  max-width: 740px;
}

/* CONTENT */
.content { max-width: 920px; margin: 0 auto; padding: 1rem 2rem 4rem; }
.content h2 {
  font-family: var(--font-display); font-size: 1.85rem; font-weight: 400;
  margin: 3.25rem 0 1rem; padding-top: 2.25rem; border-top: 1px solid var(--border);
}
.content h2:first-of-type { border-top: none; padding-top: .5rem; margin-top: .5rem; }
.content h3 { font-size: 1.12rem; font-weight: 600; margin: 2rem 0 .75rem; color: var(--accent-blue); }
.content h4 { font-size: .98rem; font-weight: 600; margin: 1.5rem 0 .6rem; color: var(--text-primary); }
.content p { color: var(--text-secondary); margin-bottom: 1.25rem; font-size: .95rem; line-height: 1.85; }
.content ul, .content ol { color: var(--text-secondary); margin: 0 0 1.5rem 1.4rem; font-size: .95rem; }
.content li { margin-bottom: .6rem; line-height: 1.75; }
.content strong { color: var(--text-primary); font-weight: 600; }
.content a { color: var(--accent-blue); text-decoration: none; }
.content a:hover { text-decoration: underline; }
.content code {
  font-family: var(--font-mono); font-size: .8rem;
  background: rgba(74, 158, 255, .08); color: var(--accent-blue);
  padding: .12rem .42rem; border-radius: 3px;
}

/* TABLE OF CONTENTS */
.toc {
  background: var(--bg-card); border: 1px solid var(--border);
  border-radius: 10px; padding: 1.5rem 1.75rem; margin: 0 0 2.5rem;
}
.toc h2 { font-family: var(--font-body); font-size: .72rem; text-transform: uppercase; letter-spacing: .12em; color: var(--text-muted); border: none; padding: 0; margin: 0 0 1rem; }
.toc ul { columns: 2; column-gap: 2rem; list-style: none; margin: 0; }
.toc li { margin-bottom: .55rem; font-size: .88rem; }
.toc a { color: var(--text-secondary); }
.toc a:hover { color: var(--accent-blue); text-decoration: none; }

/* INFO / CALLOUT BOXES */
.info-box {
  background: var(--bg-card); border: 1px solid var(--border);
  border-left: 3px solid var(--accent-blue); border-radius: 0 8px 8px 0;
  padding: 1.4rem 1.7rem; margin: 2rem 0; font-size: .9rem;
  color: var(--text-secondary); line-height: 1.8;
}
.info-box strong { color: var(--accent-blue); }
.info-box.amber { border-left-color: var(--accent-amber); }
.info-box.amber strong { color: var(--accent-amber); }
.info-box.green { border-left-color: var(--accent-green); }
.info-box.green strong { color: var(--accent-green); }

/* CARD GRID */
.card-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(260px, 1fr)); gap: 1.1rem; margin: 2rem 0; }
.card {
  background: var(--bg-card); border: 1px solid var(--border);
  border-radius: 10px; padding: 1.5rem; transition: border-color .2s, transform .2s;
}
a.card { display: block; text-decoration: none; color: inherit; }
a.card:hover { border-color: var(--border-accent); transform: translateY(-2px); }
.card h4 { margin-top: 0; }
.card p { font-size: .86rem; color: var(--text-secondary); margin: 0; line-height: 1.7; }
.card .tag {
  font-family: var(--font-mono); font-size: .68rem; display: inline-block;
  padding: .18rem .5rem; border-radius: 3px; margin-bottom: .7rem;
  background: rgba(74, 158, 255, .1); color: var(--accent-blue);
}

/* COMPARISON TABLE */
.data-table { width: 100%; border-collapse: collapse; margin: 1.5rem 0; font-size: .88rem; }
.data-table th {
  text-align: left; padding: .8rem 1.1rem; background: var(--bg-card);
  color: var(--text-muted); font-size: .7rem; text-transform: uppercase;
  letter-spacing: .07em; font-weight: 600; border-bottom: 1px solid var(--border);
}
.data-table td { padding: .9rem 1.1rem; border-bottom: 1px solid var(--border); color: var(--text-secondary); vertical-align: top; }
.data-table tr:hover td { background: rgba(74, 158, 255, .02); }
.data-table .row-head { color: var(--text-primary); font-weight: 600; }
.table-scroll { overflow-x: auto; margin: 1.5rem 0; }
.table-scroll .data-table { margin: 0; }

/* CHECKLIST */
.checklist { list-style: none; margin: 1.5rem 0; padding: 0; }
.checklist li {
  position: relative; padding: .55rem 0 .55rem 2rem;
  border-bottom: 1px solid var(--border); font-size: .92rem; color: var(--text-secondary);
}
.checklist li::before {
  content: '\2713'; position: absolute; left: 0; top: .55rem;
  width: 20px; height: 20px; border-radius: 5px; display: flex;
  align-items: center; justify-content: center; font-size: .7rem;
  background: rgba(52, 211, 153, .12); color: var(--accent-green);
}
.checklist li:last-child { border-bottom: none; }

/* ============ DIAGRAM FRAMEWORK (responsive, DOM text = readable on mobile) ============ */
figure.diagram {
  margin: 2.25rem 0; padding: 1.75rem 1.5rem 1.25rem;
  background: var(--bg-secondary); border: 1px solid var(--border); border-radius: 12px;
}
figure.diagram figcaption {
  font-size: .78rem; color: var(--text-muted); text-align: center;
  margin-top: 1.25rem; font-family: var(--font-mono); letter-spacing: .03em;
}

/* Vertical flow: stacked nodes joined by downward connectors. Scales to any width. */
.flow { display: flex; flex-direction: column; align-items: center; gap: 0; }
.flow-node {
  width: 100%; max-width: 460px; text-align: center;
  background: var(--bg-card); border: 1px solid var(--border-accent);
  border-radius: 10px; padding: .9rem 1.1rem;
}
.flow-node .n-title { font-weight: 600; font-size: .92rem; color: var(--text-primary); }
.flow-node .n-sub { font-size: .76rem; color: var(--text-secondary); margin-top: .2rem; line-height: 1.5; }
.flow-node.accent-blue { border-color: var(--accent-blue); }
.flow-node.accent-cyan { border-color: var(--accent-cyan); }
.flow-node.accent-green { border-color: var(--accent-green); }
.flow-node.accent-amber { border-color: var(--accent-amber); }
.flow-node.accent-purple { border-color: var(--accent-purple); }
.flow-node.accent-rose { border-color: var(--accent-rose); }
.flow-node.muted { border-style: dashed; border-color: var(--border-accent); background: var(--bg-primary); }
.flow-arrow { color: var(--accent-blue); font-size: 1.1rem; line-height: 1; padding: .5rem 0; }
.flow-arrow::before { content: '\2193'; }
.flow-label { font-size: .72rem; color: var(--text-muted); font-family: var(--font-mono); padding: .35rem 0; }

/* Split branch (e.g. legacy vs modern backend) */
.flow-split { display: flex; gap: 1rem; width: 100%; max-width: 620px; justify-content: center; }
.flow-split .flow-node { max-width: none; flex: 1; }

/* Landscape / hub diagram: central node with satellites in a responsive grid. */
.landscape { display: grid; gap: 1rem; }
.landscape-row { display: grid; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr)); gap: 1rem; }
.landscape-hub {
  text-align: center; background: linear-gradient(135deg, rgba(74,158,255,.12), rgba(34,211,238,.08));
  border: 1px solid var(--accent-blue); border-radius: 12px; padding: 1.25rem;
}
.landscape-hub .n-title { font-weight: 600; color: var(--text-primary); font-size: 1rem; }
.landscape-hub .n-sub { font-size: .78rem; color: var(--text-secondary); margin-top: .25rem; }
.landscape-node {
  text-align: center; background: var(--bg-card); border: 1px solid var(--border);
  border-radius: 10px; padding: 1rem .85rem;
}
.landscape-node .n-title { font-weight: 600; font-size: .85rem; }
.landscape-node .n-sub { font-size: .72rem; color: var(--text-muted); margin-top: .25rem; line-height: 1.5; }
.landscape-node.c-cyan { border-top: 2px solid var(--accent-cyan); }
.landscape-node.c-green { border-top: 2px solid var(--accent-green); }
.landscape-node.c-purple { border-top: 2px solid var(--accent-purple); }
.landscape-node.c-amber { border-top: 2px solid var(--accent-amber); }
.landscape-connector { text-align: center; color: var(--text-muted); font-size: 1rem; line-height: 1; }
.landscape-connector::before { content: '\2195'; }

/* CTA */
.cta-inline { display: flex; gap: 1rem; margin: 3rem 0 1rem; flex-wrap: wrap; }
.cta-inline a {
  display: inline-flex; align-items: center; gap: .5rem; padding: .75rem 1.5rem;
  border-radius: 8px; font-size: .88rem; font-weight: 600; text-decoration: none; transition: all .2s;
}
.cta-primary { background: var(--accent-blue); color: #fff; }
.cta-primary:hover { background: #5aabff; transform: translateY(-1px); text-decoration: none; }
.cta-secondary { background: var(--bg-card); color: var(--text-primary); border: 1px solid var(--border); }
.cta-secondary:hover { border-color: var(--border-accent); text-decoration: none; }

/* RELATED LINKS cluster */
.related { margin: 3rem 0 1rem; }
.related h2 { font-family: var(--font-body); font-size: .72rem; text-transform: uppercase; letter-spacing: .12em; color: var(--text-muted); border: none; padding: 0; margin-bottom: 1rem; }
.related-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(240px, 1fr)); gap: .85rem; }
.related-grid a {
  display: block; background: var(--bg-card); border: 1px solid var(--border);
  border-radius: 8px; padding: 1rem 1.15rem; text-decoration: none; transition: border-color .2s;
}
.related-grid a:hover { border-color: var(--border-accent); text-decoration: none; }
.related-grid .rl-title { color: var(--text-primary); font-weight: 600; font-size: .9rem; }
.related-grid .rl-desc { color: var(--text-muted); font-size: .78rem; margin-top: .25rem; line-height: 1.5; }

/* FOOTER */
footer { padding: 3rem 2rem; border-top: 1px solid var(--border); text-align: center; }
footer p { font-size: .78rem; color: var(--text-muted); line-height: 1.8; max-width: 700px; margin: 0 auto; }
footer a { color: var(--accent-blue); text-decoration: none; }
footer a:hover { text-decoration: underline; }
footer .pub { margin-top: .75rem; color: var(--text-secondary); }

@media (max-width: 768px) {
  .nav-links { display: none; }
  .page-header { padding: 6rem 1.25rem 2rem; }
  .content { padding: .5rem 1.25rem 3rem; }
  .toc ul { columns: 1; }
  .flow-split { flex-direction: column; align-items: center; }
  figure.diagram { padding: 1.25rem 1rem 1rem; }
}