:root {
  --doc-bg: #23272f;
  --doc-sidebar: #1c1f26;
  --doc-surface: #282c34;
  --doc-border: rgba(255, 255, 255, 0.08);
  --doc-text: #e8eaed;
  --doc-muted: #9aa0a6;
  --doc-link: #61dafb;
  --doc-link-hover: #8ee4ff;
  --doc-accent: #00d8ff;
  --doc-code-bg: #1b1f24;
  --doc-callout-info: rgba(97, 218, 251, 0.12);
  --doc-callout-warn: rgba(255, 170, 0, 0.12);
  --doc-callout-success: rgba(0, 255, 136, 0.1);
  --sidebar-width: 280px;
  --toc-width: 220px;
  --header-height: 56px;
  --font-sans: "Inter", system-ui, -apple-system, "Segoe UI", sans-serif;
  --font-mono: "JetBrains Mono", "SF Mono", "Fira Code", ui-monospace, monospace;
}

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

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

body {
  background: var(--doc-bg);
  color: var(--doc-text);
  font-family: var(--font-sans);
  font-size: 16px;
  line-height: 1.7;
  min-height: 100vh;
}

a {
  color: var(--doc-link);
  text-decoration: none;
}

a:hover {
  color: var(--doc-link-hover);
  text-decoration: underline;
}

code, kbd {
  font-family: var(--font-mono);
  font-size: 0.875em;
  background: var(--doc-code-bg);
  border: 1px solid var(--doc-border);
  border-radius: 4px;
  padding: 0.12em 0.4em;
}

pre {
  background: var(--doc-code-bg);
  border: 1px solid var(--doc-border);
  border-radius: 8px;
  padding: 1rem 1.15rem;
  overflow-x: auto;
  margin: 1rem 0;
  font-family: var(--font-mono);
  font-size: 0.82rem;
  line-height: 1.6;
}

pre code {
  background: none;
  border: none;
  padding: 0;
  font-size: inherit;
}

.hidden {
  display: none !important;
}

/* ─── Header ─── */
.doc-header {
  position: fixed;
  top: 0;
  left: 0;
  right: 0;
  height: var(--header-height);
  background: rgba(28, 31, 38, 0.92);
  backdrop-filter: blur(12px);
  border-bottom: 1px solid var(--doc-border);
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0 1.25rem;
  z-index: 100;
}

.doc-header-left {
  display: flex;
  align-items: center;
  gap: 1rem;
}

.menu-toggle {
  display: none;
  background: none;
  border: 1px solid var(--doc-border);
  color: var(--doc-text);
  border-radius: 6px;
  padding: 0.35rem 0.6rem;
  cursor: pointer;
  font-size: 1.1rem;
}

.doc-logo {
  display: flex;
  align-items: baseline;
  gap: 0.35rem;
  font-weight: 700;
  font-size: 1.05rem;
  color: var(--doc-text);
  text-decoration: none;
}

.doc-logo:hover {
  text-decoration: none;
  color: var(--doc-accent);
}

.doc-logo span {
  color: var(--doc-muted);
  font-weight: 500;
}

.doc-badge {
  font-size: 0.72rem;
  font-weight: 600;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  color: var(--doc-muted);
  border: 1px solid var(--doc-border);
  border-radius: 999px;
  padding: 0.15rem 0.55rem;
}

.doc-header-right {
  display: flex;
  align-items: center;
  gap: 0.75rem;
}

.nav-status {
  display: flex;
  align-items: center;
  gap: 0.45rem;
  font-size: 0.78rem;
  color: var(--doc-muted);
}

.status-dot {
  width: 7px;
  height: 7px;
  border-radius: 50%;
  background: #555;
  flex-shrink: 0;
}

.status-dot.online { background: #3dd68c; box-shadow: 0 0 8px rgba(61, 214, 140, 0.5); }
.status-dot.partial { background: #ffaa00; }

.header-link {
  font-size: 0.875rem;
  font-weight: 500;
  padding: 0.4rem 0.85rem;
  border-radius: 6px;
  border: 1px solid var(--doc-border);
  color: var(--doc-text);
  text-decoration: none;
}

.header-link:hover {
  border-color: var(--doc-link);
  color: var(--doc-link);
  text-decoration: none;
}

.header-link-primary {
  background: rgba(97, 218, 251, 0.12);
  border-color: rgba(97, 218, 251, 0.35);
}

/* ─── Layout ─── */
.doc-shell {
  display: flex;
  padding-top: var(--header-height);
  min-height: 100vh;
}

.doc-sidebar {
  position: fixed;
  top: var(--header-height);
  left: 0;
  width: var(--sidebar-width);
  height: calc(100vh - var(--header-height));
  overflow-y: auto;
  background: var(--doc-sidebar);
  border-right: 1px solid var(--doc-border);
  padding: 1.25rem 0 2rem;
  z-index: 50;
}

.sidebar-group {
  margin-bottom: 1.25rem;
}

.sidebar-label {
  font-size: 0.68rem;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--doc-muted);
  padding: 0 1.25rem;
  margin-bottom: 0.35rem;
}

.sidebar-nav a {
  display: block;
  padding: 0.35rem 1.25rem;
  font-size: 0.875rem;
  color: var(--doc-muted);
  text-decoration: none;
  border-left: 2px solid transparent;
}

.sidebar-nav a:hover {
  color: var(--doc-text);
  background: rgba(255, 255, 255, 0.03);
  text-decoration: none;
}

.sidebar-nav a.active {
  color: var(--doc-link);
  border-left-color: var(--doc-link);
  background: rgba(97, 218, 251, 0.06);
}

.doc-main {
  flex: 1;
  margin-left: var(--sidebar-width);
  margin-right: var(--toc-width);
  padding: 2rem 2.5rem 4rem;
  max-width: calc(100% - var(--sidebar-width) - var(--toc-width));
}

.doc-toc {
  position: fixed;
  top: var(--header-height);
  right: 0;
  width: var(--toc-width);
  height: calc(100vh - var(--header-height));
  overflow-y: auto;
  padding: 1.5rem 1rem 2rem;
  border-left: 1px solid var(--doc-border);
}

.toc-title {
  font-size: 0.72rem;
  font-weight: 700;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--doc-muted);
  margin-bottom: 0.75rem;
}

.toc-nav a {
  display: block;
  font-size: 0.78rem;
  color: var(--doc-muted);
  padding: 0.2rem 0;
  text-decoration: none;
}

.toc-nav a:hover,
.toc-nav a.active {
  color: var(--doc-link);
}

.toc-nav a.toc-h3 {
  padding-left: 0.75rem;
  font-size: 0.74rem;
}

/* ─── Hero ─── */
.doc-hero {
  margin-bottom: 2.5rem;
  padding-bottom: 2rem;
  border-bottom: 1px solid var(--doc-border);
}

.doc-hero-tag {
  font-size: 0.8rem;
  color: var(--doc-muted);
  margin-bottom: 0.75rem;
}

.doc-hero h1 {
  font-size: clamp(2rem, 4vw, 2.75rem);
  font-weight: 800;
  line-height: 1.15;
  letter-spacing: -0.02em;
  margin-bottom: 1rem;
}

.doc-hero-lead {
  font-size: 1.125rem;
  color: var(--doc-muted);
  max-width: 42rem;
  margin-bottom: 1.5rem;
}

.doc-hero-actions {
  display: flex;
  flex-wrap: wrap;
  gap: 0.75rem;
}

.btn {
  display: inline-flex;
  align-items: center;
  padding: 0.6rem 1.15rem;
  border-radius: 8px;
  font-size: 0.9rem;
  font-weight: 600;
  text-decoration: none;
  border: 1px solid transparent;
  transition: background 0.15s, border-color 0.15s;
}

.btn-primary {
  background: rgba(97, 218, 251, 0.15);
  border-color: rgba(97, 218, 251, 0.4);
  color: var(--doc-link);
}

.btn-primary:hover {
  background: rgba(97, 218, 251, 0.25);
  text-decoration: none;
  color: var(--doc-link-hover);
}

.btn-secondary {
  background: transparent;
  border-color: var(--doc-border);
  color: var(--doc-text);
}

.btn-secondary:hover {
  border-color: var(--doc-muted);
  text-decoration: none;
  color: var(--doc-text);
}

/* ─── Articles ─── */
.doc-article {
  margin-bottom: 3.5rem;
  scroll-margin-top: calc(var(--header-height) + 1rem);
}

.doc-article h2 {
  font-size: 1.65rem;
  font-weight: 700;
  letter-spacing: -0.01em;
  margin-bottom: 1rem;
  padding-top: 0.5rem;
}

.doc-article h3 {
  font-size: 1.15rem;
  font-weight: 600;
  margin: 1.75rem 0 0.65rem;
}

.doc-article h4 {
  font-size: 0.95rem;
  font-weight: 600;
  margin: 1.25rem 0 0.5rem;
  color: var(--doc-muted);
}

.doc-article p {
  margin-bottom: 1rem;
  color: rgba(232, 234, 237, 0.92);
}

.doc-article ul,
.doc-article ol {
  margin: 0 0 1rem 1.25rem;
  color: rgba(232, 234, 237, 0.9);
}

.doc-article li {
  margin-bottom: 0.35rem;
}

.doc-article > p.lead {
  font-size: 1.05rem;
  color: var(--doc-muted);
}

/* ─── Tables ─── */
.doc-table-wrap {
  overflow-x: auto;
  margin: 1rem 0 1.25rem;
  border: 1px solid var(--doc-border);
  border-radius: 8px;
}

.doc-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.875rem;
}

.doc-table th,
.doc-table td {
  padding: 0.65rem 0.85rem;
  text-align: left;
  border-bottom: 1px solid var(--doc-border);
  vertical-align: top;
}

.doc-table th {
  background: rgba(0, 0, 0, 0.2);
  font-weight: 600;
  color: var(--doc-muted);
  font-size: 0.78rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
}

.doc-table tr:last-child td {
  border-bottom: none;
}

.doc-table td code {
  font-size: 0.8em;
}

/* ─── Callouts ─── */
.callout {
  border-radius: 8px;
  padding: 1rem 1.15rem;
  margin: 1.25rem 0;
  border: 1px solid var(--doc-border);
}

.callout-info {
  background: var(--doc-callout-info);
  border-color: rgba(97, 218, 251, 0.25);
}

.callout-warn {
  background: var(--doc-callout-warn);
  border-color: rgba(255, 170, 0, 0.3);
}

.callout-success {
  background: var(--doc-callout-success);
  border-color: rgba(61, 214, 140, 0.25);
}

.callout strong {
  display: block;
  margin-bottom: 0.35rem;
  font-size: 0.875rem;
}

.callout p:last-child {
  margin-bottom: 0;
  font-size: 0.9rem;
  color: var(--doc-muted);
}

/* ─── Live status panel ─── */
.live-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
  gap: 0.75rem;
  margin: 1rem 0;
}

.live-card {
  background: var(--doc-surface);
  border: 1px solid var(--doc-border);
  border-radius: 8px;
  padding: 0.85rem;
}

.live-card-label {
  font-size: 0.72rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--doc-muted);
  margin-bottom: 0.25rem;
}

.live-card-value {
  font-size: 0.9rem;
  font-weight: 600;
}

.live-card-value.ok { color: #3dd68c; }
.live-card-value.warn { color: #ffaa00; }
.live-card-value.off { color: #888; }

/* ─── Architecture diagram ─── */
.diagram {
  background: var(--doc-code-bg);
  border: 1px solid var(--doc-border);
  border-radius: 8px;
  padding: 1.25rem;
  font-family: var(--font-mono);
  font-size: 0.78rem;
  line-height: 1.7;
  overflow-x: auto;
  white-space: pre;
  color: var(--doc-muted);
  margin: 1rem 0;
}

/* ─── Role cards ─── */
.role-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
  gap: 1rem;
  margin: 1rem 0;
}

.role-card {
  background: var(--doc-surface);
  border: 1px solid var(--doc-border);
  border-radius: 8px;
  padding: 1.15rem;
}

.role-card h4 {
  margin: 0 0 0.5rem;
  color: var(--doc-link);
  font-size: 1rem;
}

.role-card p {
  font-size: 0.875rem;
  color: var(--doc-muted);
  margin: 0;
}

/* ─── Footer ─── */
.doc-footer {
  margin-top: 3rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--doc-border);
  font-size: 0.82rem;
  color: var(--doc-muted);
}

.doc-footer-contact {
  margin: 0.5rem 0 0;
}

.doc-footer-contact a {
  color: var(--doc-accent);
  text-decoration: none;
}

.doc-footer-contact a:hover {
  text-decoration: underline;
}

/* ─── Responsive ─── */
@media (max-width: 1100px) {
  .doc-toc { display: none; }
  .doc-main {
    margin-right: 0;
    max-width: calc(100% - var(--sidebar-width));
  }
}

@media (max-width: 768px) {
  .menu-toggle { display: block; }

  .doc-sidebar {
    transform: translateX(-100%);
    transition: transform 0.2s ease;
  }

  .doc-sidebar.open {
    transform: translateX(0);
  }

  .doc-main {
    margin-left: 0;
    max-width: 100%;
    padding: 1.25rem 1rem 3rem;
  }

  .nav-status { display: none; }
  .doc-badge { display: none; }
}