:root {
  color-scheme: light;
  --bg: #f6f8fb;
  --surface: #ffffff;
  --surface-2: #f8fafc;
  --text: #0f172a;
  --muted: #64748b;
  --border: #e2e8f0;
  --accent: #2563eb;
  --accent-dark: #1d4ed8;
  --accent-soft: #eff6ff;
  --code-bg: #f1f5f9;
  --warn: #b45309;
  --warn-bg: #fffbeb;
  --warn-border: #fcd34d;
  --ok: #047857;
  --ok-bg: #ecfdf5;
  --ok-border: #6ee7b7;
  --danger: #b91c1c;
  --danger-bg: #fef2f2;
  --danger-border: #fca5a5;
  --sidebar-w: 280px;
  --header-h: 56px;
}

* { box-sizing: border-box; }

html { scroll-behavior: smooth; scroll-padding-top: calc(var(--header-h) + 1rem); }

body {
  margin: 0;
  font-family: system-ui, -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
  background: var(--bg);
  color: var(--text);
  line-height: 1.65;
  -webkit-font-smoothing: antialiased;
}

a { color: var(--accent); text-decoration: none; }
a:hover { text-decoration: underline; }

/* ── Top bar (mobile) ───────────────────────────── */
.topbar {
  position: sticky;
  top: 0;
  z-index: 40;
  height: var(--header-h);
  display: none;
  align-items: center;
  gap: 0.75rem;
  padding: 0 1rem;
  background: var(--surface);
  border-bottom: 1px solid var(--border);
}
.topbar .brand { font-weight: 700; font-size: 0.95rem; }
.topbar .brand span { color: var(--accent); }
.menu-btn {
  appearance: none;
  border: 1px solid var(--border);
  background: var(--surface);
  border-radius: 8px;
  width: 38px; height: 38px;
  font-size: 1.2rem; line-height: 1;
  cursor: pointer;
}

/* ── Layout ─────────────────────────────────────── */
.layout { display: flex; min-height: 100vh; }

.sidebar {
  width: var(--sidebar-w);
  flex-shrink: 0;
  background: var(--surface);
  border-right: 1px solid var(--border);
  padding: 1.5rem 0;
  position: sticky;
  top: 0;
  height: 100vh;
  overflow-y: auto;
}
.sidebar .logo {
  display: block;
  padding: 0 1.5rem 1.25rem;
  font-size: 1.15rem;
  font-weight: 800;
  letter-spacing: -0.01em;
  color: var(--text);
}
.sidebar .logo span { color: var(--accent); }
.sidebar .logo small {
  display: block;
  font-size: 0.72rem;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--muted);
  margin-top: 0.15rem;
}
.sidebar nav { padding: 0 0.75rem; }
.sidebar .group-title {
  font-size: 0.7rem;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--muted);
  padding: 1rem 0.75rem 0.35rem;
}
.sidebar a.nav-link {
  display: block;
  padding: 0.45rem 0.75rem;
  border-radius: 8px;
  color: #334155;
  font-size: 0.9rem;
  font-weight: 500;
}
.sidebar a.nav-link:hover { background: var(--surface-2); text-decoration: none; }
.sidebar a.nav-link.active { background: var(--accent-soft); color: var(--accent-dark); font-weight: 600; }

.content {
  flex: 1;
  min-width: 0;
  display: flex;
  justify-content: center;
  padding: 2.5rem 2rem 5rem;
}
.article { width: 100%; max-width: 820px; }

/* ── Typography ─────────────────────────────────── */
.kicker {
  font-size: 0.72rem; font-weight: 700; letter-spacing: 0.09em;
  text-transform: uppercase; color: var(--accent);
}
h1 { font-size: 2rem; line-height: 1.2; margin: 0.35rem 0 0.6rem; letter-spacing: -0.02em; }
.lead { font-size: 1.08rem; color: var(--muted); margin: 0 0 2rem; }
h2 {
  font-size: 1.35rem; margin: 2.5rem 0 0.85rem; padding-top: 0.5rem;
  letter-spacing: -0.01em; scroll-margin-top: 5rem;
}
h3 { font-size: 1.05rem; margin: 1.75rem 0 0.5rem; }
p, li { font-size: 0.96rem; }
ul, ol { padding-left: 1.4rem; }
li { margin: 0.3rem 0; }
hr { border: none; border-top: 1px solid var(--border); margin: 2.5rem 0; }

code {
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
  font-size: 0.85em; background: var(--code-bg);
  padding: 0.12em 0.4em; border-radius: 5px;
}
pre {
  background: #0f172a; color: #e2e8f0;
  padding: 1rem 1.15rem; border-radius: 10px;
  overflow-x: auto; font-size: 0.82rem; line-height: 1.55;
  margin: 1rem 0;
}
pre code { background: none; padding: 0; font-size: inherit; color: inherit; }

/* ── Tables ─────────────────────────────────────── */
.table-wrap { overflow-x: auto; margin: 1rem 0; }
table { width: 100%; border-collapse: collapse; font-size: 0.9rem; }
th, td { border: 1px solid var(--border); padding: 0.55rem 0.7rem; text-align: left; vertical-align: top; }
th { background: var(--code-bg); font-weight: 600; }
td code { white-space: nowrap; }

/* ── Callouts ───────────────────────────────────── */
.callout {
  border: 1px solid var(--border); border-left-width: 4px;
  border-radius: 8px; padding: 0.85rem 1.1rem; margin: 1.25rem 0;
  font-size: 0.92rem; background: var(--surface-2);
}
.callout p:first-child { margin-top: 0; }
.callout p:last-child { margin-bottom: 0; }
.callout.note { border-left-color: var(--accent); background: var(--accent-soft); }
.callout.warn { border-left-color: var(--warn-border); background: var(--warn-bg); }
.callout.warn strong { color: var(--warn); }
.callout.ok { border-left-color: var(--ok-border); background: var(--ok-bg); }
.callout.ok strong { color: var(--ok); }
.callout.danger { border-left-color: var(--danger-border); background: var(--danger-bg); }
.callout.danger strong { color: var(--danger); }

/* ── Step list ──────────────────────────────────── */
ol.steps { counter-reset: step; list-style: none; padding-left: 0; }
ol.steps > li {
  position: relative; padding-left: 3rem; margin: 1.1rem 0;
  min-height: 2rem;
}
ol.steps > li::before {
  counter-increment: step; content: counter(step);
  position: absolute; left: 0; top: 0;
  width: 2rem; height: 2rem; border-radius: 50%;
  background: var(--accent); color: #fff;
  display: flex; align-items: center; justify-content: center;
  font-weight: 700; font-size: 0.9rem;
}

/* ── Cards grid (index) ─────────────────────────── */
.card-grid { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fill, minmax(230px, 1fr)); margin: 1.5rem 0; }
.card {
  display: block; border: 1px solid var(--border); border-radius: 12px;
  padding: 1.1rem 1.2rem; background: var(--surface); color: var(--text);
  transition: border-color .15s, box-shadow .15s;
}
.card:hover { border-color: var(--accent); box-shadow: 0 4px 14px rgba(37,99,235,.08); text-decoration: none; }
.card h3 { margin: 0 0 0.3rem; font-size: 1rem; }
.card p { margin: 0; font-size: 0.86rem; color: var(--muted); }

/* ── Badges ─────────────────────────────────────── */
.badge {
  display: inline-block; font-size: 0.72rem; font-weight: 600;
  padding: 0.12em 0.55em; border-radius: 999px; vertical-align: middle;
}
.badge.blue { background: var(--accent-soft); color: var(--accent-dark); }
.badge.gray { background: var(--code-bg); color: var(--muted); }
.badge.green { background: var(--ok-bg); color: var(--ok); }

/* ── Breadcrumb + pager ─────────────────────────── */
.crumbs { font-size: 0.82rem; color: var(--muted); margin-bottom: 0.5rem; }
.crumbs a { color: var(--muted); }
.pager { display: flex; justify-content: space-between; gap: 1rem; margin-top: 3rem; padding-top: 1.5rem; border-top: 1px solid var(--border); }
.pager a { flex: 1; border: 1px solid var(--border); border-radius: 10px; padding: 0.8rem 1rem; font-size: 0.9rem; }
.pager a:hover { border-color: var(--accent); text-decoration: none; }
.pager .lbl { display: block; font-size: 0.72rem; color: var(--muted); text-transform: uppercase; letter-spacing: 0.06em; }
.pager .nxt { text-align: right; }

footer.doc-footer { margin-top: 3rem; font-size: 0.82rem; color: var(--muted); }

.dl {
  display: inline-flex; align-items: center; gap: 0.4rem;
  margin: 0.4rem 0.75rem 0.4rem 0; padding: 0.5rem 0.9rem;
  border: 1px solid var(--border); border-radius: 8px;
  font-weight: 600; font-size: 0.88rem; background: var(--surface);
}
.dl:hover { border-color: var(--accent); text-decoration: none; }

/* ── Mobile ─────────────────────────────────────── */
#nav-toggle { display: none; }
.backdrop { display: none; }

@media (max-width: 900px) {
  .topbar { display: flex; }
  .sidebar {
    position: fixed; top: 0; left: 0; z-index: 50;
    height: 100vh; transform: translateX(-100%);
    transition: transform .2s ease; box-shadow: 2px 0 20px rgba(0,0,0,.12);
  }
  #nav-toggle:checked ~ .layout .sidebar { transform: translateX(0); }
  #nav-toggle:checked ~ .layout .backdrop {
    display: block; position: fixed; inset: 0; z-index: 45;
    background: rgba(15,23,42,.4);
  }
  .content { padding: 1.5rem 1.1rem 4rem; }
  h1 { font-size: 1.6rem; }
}