:root {
  --bg:       #fafafa;
  --fg:       #1a1a1a;
  --muted:    #666;
  --accent:   #b7410e;
  --code-bg:  #f0f0f0;
  --border:   #ddd;
  --link:     #0057b7;
  --card-bg:  #fff;
  --sidebar-w: 200px;
}

@media (prefers-color-scheme: dark) {
  :root {
    --bg:      #0d1117;
    --fg:      #e6edf3;
    --muted:   #8b949e;
    --accent:  #f0883e;
    --code-bg: #161b22;
    --border:  #30363d;
    --link:    #58a6ff;
    --card-bg: #161b22;
  }
}

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

body {
  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
  font-size: 16px;
  line-height: 1.65;
  color: var(--fg);
  background: var(--bg);
  margin: 0;
}

.container {
  max-width: 960px;
  margin: 0 auto;
  padding: 0 1.5rem;
}

/* ── Header ─────────────────────────────────────────────── */

header {
  border-bottom: 1px solid var(--border);
  padding: 1.5rem 0 1.25rem;
  margin-bottom: 0;
}

.logo {
  font-family: ui-monospace, "Cascadia Code", "Source Code Pro", Menlo, Consolas, monospace;
  font-size: 1.8rem;
  font-weight: 700;
  color: var(--accent);
  letter-spacing: -0.02em;
  text-decoration: none;
  display: inline-block;
  margin-bottom: 0.1rem;
}

.tagline {
  color: var(--muted);
  margin: 0 0 0.9rem;
  font-size: 0.9rem;
  letter-spacing: 0.02em;
}

.site-nav {
  display: flex;
  gap: 1.1rem;
  flex-wrap: wrap;
  align-items: center;
}

.site-nav a {
  color: var(--link);
  text-decoration: none;
  font-size: 0.875rem;
}

.site-nav a:hover { text-decoration: underline; }
.site-nav a.active { font-weight: 600; color: var(--accent); }
.site-nav a.external { color: var(--muted); }

/* ── NATS recommendation banner ─────────────────────────── */

.nats-banner {
  background: #7c5c00;
  color: #fff3cd;
  padding: 0.65rem 0;
  font-size: 0.875rem;
  line-height: 1.4;
}

@media (prefers-color-scheme: dark) {
  .nats-banner {
    background: #4a3800;
    color: #ffe69c;
  }
}

.nats-banner .container {
  display: flex;
  align-items: baseline;
  gap: 0.4rem;
  flex-wrap: wrap;
}

.nats-banner a {
  color: inherit;
  font-weight: 600;
}

.nats-banner a:hover { text-decoration: underline; }

/* ── Doc layout (sidebar + content) ────────────────────── */

.doc-main { padding-top: 2rem; padding-bottom: 4rem; }
.home-main { padding-top: 2.5rem; padding-bottom: 4rem; max-width: 780px; }

.doc-layout {
  display: grid;
  grid-template-columns: var(--sidebar-w) 1fr;
  gap: 3rem;
  align-items: start;
}

@media (max-width: 680px) {
  .doc-layout {
    grid-template-columns: 1fr;
    gap: 1.5rem;
  }
}

/* ── Sidebar ─────────────────────────────────────────────── */

.sidebar {
  position: sticky;
  top: 1.5rem;
  font-size: 0.875rem;
}

@media (max-width: 680px) {
  .sidebar {
    position: static;
  }
}

.sidebar-heading {
  font-weight: 600;
  color: var(--accent);
  text-decoration: none;
  font-size: 0.8rem;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  display: block;
  margin-bottom: 0.6rem;
}

a.sidebar-heading:hover { text-decoration: underline; }

.sidebar nav {
  display: flex;
  flex-direction: column;
  gap: 0.2rem;
}

.sidebar nav a {
  color: var(--muted);
  text-decoration: none;
  padding: 0.2rem 0.5rem;
  border-radius: 4px;
  display: block;
}

.sidebar nav a:hover { color: var(--fg); background: var(--code-bg); }
.sidebar nav a.active { color: var(--fg); font-weight: 600; background: var(--code-bg); }

/* ── Breadcrumb ─────────────────────────────────────────── */

.breadcrumb {
  font-size: 0.8rem;
  color: var(--muted);
  margin-bottom: 1.25rem;
  display: flex;
  align-items: center;
  gap: 0.4rem;
  flex-wrap: wrap;
}

.breadcrumb a { color: var(--muted); text-decoration: none; }
.breadcrumb a:hover { text-decoration: underline; }

/* ── Cards (section list) ───────────────────────────────── */

.cards {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
  gap: 1rem;
  margin-top: 1.5rem;
}

.card {
  display: block;
  background: var(--card-bg);
  border: 1px solid var(--border);
  border-radius: 8px;
  padding: 1rem 1.1rem;
  text-decoration: none;
  color: var(--fg);
  transition: border-color 0.15s, box-shadow 0.15s;
}

.card:hover {
  border-color: var(--accent);
  box-shadow: 0 2px 8px rgba(0,0,0,0.08);
}

.card strong { display: block; margin-bottom: 0.3rem; color: var(--accent); }
.card p { margin: 0; font-size: 0.85rem; color: var(--muted); }

/* ── Content typography ─────────────────────────────────── */

/*
 * Grid items default to min-width: auto, which lets <pre> blocks stretch the
 * cell wider than the column — causing page-level horizontal overflow while
 * the header stays at container width.  min-width: 0 lets the cell stay
 * within its allocated space; overflow-x: auto on <pre> handles scrolling
 * within the block itself.
 */
.doc-content {
  min-width: 0;
}

.doc-content h1 {
  font-size: 1.6rem;
  font-weight: 700;
  margin: 0 0 0.3rem;
  line-height: 1.3;
}

h2 {
  font-size: 1.2rem;
  font-weight: 600;
  margin-top: 2.5rem;
  padding-bottom: 0.35rem;
  border-bottom: 1px solid var(--border);
}

h3 { font-size: 1rem; font-weight: 600; margin-top: 1.5rem; }

a { color: var(--link); }

code {
  font-family: ui-monospace, "Cascadia Code", "Source Code Pro", Menlo, Consolas, monospace;
  font-size: 0.85em;
}

pre {
  background: #272822;
  color: #f8f8f2;
  border-radius: 6px;
  padding: 1rem 1.25rem;
  overflow-x: auto;
  margin: 1.25rem 0;
}

.highlight pre {
  border: none;
}

pre code {
  background: none;
  padding: 0;
  font-size: 0.83rem;
  line-height: 1.55;
}

table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.9rem;
  margin: 1rem 0 1.5rem;
}

@media (max-width: 680px) {
  table {
    display: block;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
  }
}

th {
  text-align: left;
  font-weight: 600;
  padding: 0.45rem 0.75rem;
  border-bottom: 2px solid var(--border);
}

td {
  padding: 0.4rem 0.75rem;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
}

blockquote {
  border-left: 3px solid var(--border);
  margin: 1rem 0;
  padding: 0.1rem 1rem;
  color: var(--muted);
}

ul, ol { padding-left: 1.5rem; }
li { margin-bottom: 0.3rem; }

/* ── Callout boxes ─────────────────────────────────────── */

.callout {
  border: 1px solid var(--border);
  border-left: 4px solid var(--accent);
  border-radius: 4px;
  padding: 0.75rem 1rem;
  margin: 1.25rem 0;
  font-size: 0.9rem;
}

.callout-note  { border-left-color: var(--link); }
.callout-warn  { border-left-color: #d29922; }

/* ── Home page extras ───────────────────────────────────── */

.home-main > p:first-child {
  font-size: 1.05rem;
  color: var(--muted);
  margin-top: 0;
}

.home-main h2 {
  font-size: 1.2rem;
  font-weight: 600;
  margin-top: 2.5rem;
  padding-bottom: 0.35rem;
  border-bottom: 1px solid var(--border);
}

/* ── Footer ─────────────────────────────────────────────── */

footer {
  border-top: 1px solid var(--border);
  padding: 1.25rem 0;
  color: var(--muted);
  font-size: 0.82rem;
}

footer p { margin: 0; }
footer a { color: var(--muted); }