:root {
  color-scheme: light dark;

  --doc-bg: #ffffff;
  --doc-bg-raised: #f6f7f9;
  --doc-bg-inset: #f0f1f4;
  --doc-border: rgba(20, 22, 26, 0.12);
  --doc-text: rgba(20, 22, 26, 0.92);
  --doc-text-muted: rgba(20, 22, 26, 0.62);
  --doc-accent: rgb(214, 92, 58);
  --doc-accent-contrast: #fff;
  --doc-code-text: #b34a1f;
  --doc-link: rgb(191, 76, 45);
  --doc-shadow: rgba(20, 22, 26, 0.08);

  --doc-radius-sm: 6px;
  --doc-radius-md: 10px;
  --doc-radius-lg: 16px;

  --doc-space-1: 4px;
  --doc-space-2: 8px;
  --doc-space-3: 12px;
  --doc-space-4: 16px;
  --doc-space-5: 24px;
  --doc-space-6: 32px;

  --doc-sidebar-w: 272px;
  --doc-toc-w: 220px;
  --doc-header-h: 56px;
}

@media (prefers-color-scheme: dark) {
  :root {
    --doc-bg: #16171b;
    --doc-bg-raised: #1d1f24;
    --doc-bg-inset: #202329;
    --doc-border: rgba(255, 255, 255, 0.1);
    --doc-text: rgba(255, 255, 255, 0.92);
    --doc-text-muted: rgba(255, 255, 255, 0.6);
    --doc-accent: rgb(235, 110, 75);
    --doc-code-text: rgb(255, 165, 130);
    --doc-link: rgb(255, 143, 108);
    --doc-shadow: rgba(0, 0, 0, 0.4);
  }
}

* {
  box-sizing: border-box;
}

html,
body {
  margin: 0;
  padding: 0;
}

body {
  background: var(--doc-bg);
  color: var(--doc-text);
  font-family:
    -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
  font-size: 16px;
  line-height: 1.6;
  -webkit-font-smoothing: antialiased;
}

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

a:hover {
  text-decoration: underline;
}

code,
pre,
kbd {
  font-family:
    ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace;
}

/* ---------- Top header ---------- */

.doc-header {
  position: sticky;
  top: 0;
  z-index: 30;
  display: flex;
  align-items: center;
  gap: var(--doc-space-3);
  height: var(--doc-header-h);
  padding: 0 var(--doc-space-4);
  background: var(--doc-bg);
  border-bottom: 1px solid var(--doc-border);
}

.doc-header__brand {
  display: flex;
  align-items: baseline;
  gap: var(--doc-space-2);
  font-weight: 700;
  font-size: 1.05rem;
  color: var(--doc-text);
  white-space: nowrap;
}

.doc-header__brand small {
  font-weight: 500;
  font-size: 0.75rem;
  color: var(--doc-text-muted);
}

.doc-header__spacer {
  flex: 1;
}

.doc-header__links {
  display: flex;
  gap: var(--doc-space-4);
  font-size: 0.9rem;
}

.doc-header__menu-btn {
  display: none;
  border: 1px solid var(--doc-border);
  background: var(--doc-bg-raised);
  color: var(--doc-text);
  border-radius: var(--doc-radius-sm);
  width: 34px;
  height: 34px;
  align-items: center;
  justify-content: center;
  font-size: 1rem;
  cursor: pointer;
}

/* ---------- Layout shell ---------- */

.doc-shell {
  display: grid;
  grid-template-columns: var(--doc-sidebar-w) minmax(0, 1fr) var(--doc-toc-w);
  max-width: 1400px;
  margin: 0 auto;
}

.doc-sidebar {
  border-right: 1px solid var(--doc-border);
  padding: var(--doc-space-5) var(--doc-space-4);
  height: calc(100vh - var(--doc-header-h));
  position: sticky;
  top: var(--doc-header-h);
  overflow-y: auto;
}

.doc-nav-group {
  margin-bottom: var(--doc-space-5);
}

.doc-nav-group__title {
  font-size: 0.72rem;
  font-weight: 700;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--doc-text-muted);
  margin: 0 0 var(--doc-space-2) var(--doc-space-2);
}

.doc-nav-list {
  list-style: none;
  margin: 0;
  padding: 0;
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.doc-nav-list a {
  display: block;
  padding: 6px var(--doc-space-2);
  border-radius: var(--doc-radius-sm);
  color: var(--doc-text-muted);
  font-size: 0.92rem;
}

.doc-nav-list a:hover {
  background: var(--doc-bg-raised);
  color: var(--doc-text);
  text-decoration: none;
}

.doc-nav-list a[aria-current='page'] {
  background: color-mix(in srgb, var(--doc-accent) 16%, transparent);
  color: var(--doc-accent);
  font-weight: 600;
}

.doc-main {
  padding: var(--doc-space-6) var(--doc-space-5);
  min-width: 0;
}

.doc-content {
  max-width: 820px;
}

.doc-breadcrumb {
  font-size: 0.85rem;
  color: var(--doc-text-muted);
  margin-bottom: var(--doc-space-3);
}

.doc-content h1 {
  font-size: 2rem;
  margin: 0 0 var(--doc-space-4);
}

.doc-content h2 {
  font-size: 1.4rem;
  margin: var(--doc-space-6) 0 var(--doc-space-3);
  padding-top: var(--doc-space-2);
  border-top: 1px solid var(--doc-border);
}

.doc-content h2:first-of-type {
  border-top: none;
  padding-top: 0;
}

.doc-content h3 {
  font-size: 1.12rem;
  margin: var(--doc-space-5) 0 var(--doc-space-2);
}

.doc-content h4 {
  font-size: 1rem;
  margin: var(--doc-space-4) 0 var(--doc-space-1);
}

.doc-content p,
.doc-content ul,
.doc-content ol {
  margin: 0 0 var(--doc-space-4);
  color: var(--doc-text);
}

.doc-content li {
  margin-bottom: var(--doc-space-1);
}

.doc-content blockquote {
  margin: 0 0 var(--doc-space-4);
  padding: var(--doc-space-2) var(--doc-space-4);
  border-left: 3px solid var(--doc-accent);
  background: var(--doc-bg-raised);
  border-radius: 0 var(--doc-radius-sm) var(--doc-radius-sm) 0;
  color: var(--doc-text-muted);
}

.doc-content :not(pre) > code {
  background: var(--doc-bg-inset);
  color: var(--doc-code-text);
  padding: 0.15em 0.4em;
  border-radius: 4px;
  font-size: 0.86em;
}

.doc-content pre {
  background: var(--doc-bg-inset);
  border: 1px solid var(--doc-border);
  border-radius: var(--doc-radius-md);
  padding: var(--doc-space-4);
  overflow-x: auto;
  margin: 0 0 var(--doc-space-4);
  font-size: 0.86rem;
  line-height: 1.55;
}

.doc-content pre code {
  background: none;
  color: inherit;
  padding: 0;
  font-size: inherit;
}

.doc-content table {
  width: 100%;
  border-collapse: collapse;
  margin: 0 0 var(--doc-space-4);
  font-size: 0.9rem;
  display: block;
  overflow-x: auto;
}

.doc-content th,
.doc-content td {
  text-align: left;
  padding: var(--doc-space-2) var(--doc-space-3);
  border-bottom: 1px solid var(--doc-border);
  vertical-align: top;
}

.doc-content thead th {
  color: var(--doc-text-muted);
  font-size: 0.78rem;
  text-transform: uppercase;
  letter-spacing: 0.03em;
  border-bottom: 2px solid var(--doc-border);
}

.doc-content hr {
  border: none;
  border-top: 1px solid var(--doc-border);
  margin: var(--doc-space-6) 0;
}

.doc-content img {
  max-width: 100%;
}

.doc-badge {
  display: inline-block;
  font-size: 0.7rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  padding: 2px 8px;
  border-radius: 999px;
  background: color-mix(in srgb, var(--doc-accent) 18%, transparent);
  color: var(--doc-accent);
  margin-left: var(--doc-space-2);
  vertical-align: middle;
}

.doc-pagenav {
  display: flex;
  justify-content: space-between;
  gap: var(--doc-space-4);
  margin-top: var(--doc-space-6);
  padding-top: var(--doc-space-4);
  border-top: 1px solid var(--doc-border);
}

.doc-pagenav a {
  flex: 1;
  border: 1px solid var(--doc-border);
  border-radius: var(--doc-radius-md);
  padding: var(--doc-space-3) var(--doc-space-4);
  color: var(--doc-text);
}

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

.doc-pagenav__next {
  text-align: right;
}

.doc-pagenav__label {
  display: block;
  font-size: 0.72rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--doc-text-muted);
  margin-bottom: 2px;
}

/* ---------- Right-hand "on this page" TOC ---------- */

.doc-toc {
  padding: var(--doc-space-5) var(--doc-space-4);
  height: calc(100vh - var(--doc-header-h));
  position: sticky;
  top: var(--doc-header-h);
  overflow-y: auto;
  font-size: 0.85rem;
}

.doc-toc__title {
  font-size: 0.72rem;
  font-weight: 700;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--doc-text-muted);
  margin: 0 0 var(--doc-space-2);
}

.doc-toc ul {
  list-style: none;
  margin: 0;
  padding: 0;
}

.doc-toc li {
  margin-bottom: var(--doc-space-2);
}

.doc-toc a {
  color: var(--doc-text-muted);
}

.doc-toc a:hover {
  color: var(--doc-text);
}

.doc-toc .doc-toc__h3 {
  padding-left: var(--doc-space-3);
  font-size: 0.82rem;
}

/* ---------- Home page hero (index only) ---------- */

.doc-hero {
  background: linear-gradient(
    135deg,
    color-mix(in srgb, var(--doc-accent) 14%, transparent),
    transparent
  );
  border: 1px solid var(--doc-border);
  border-radius: var(--doc-radius-lg);
  padding: var(--doc-space-5);
  margin-bottom: var(--doc-space-5);
}

.doc-card-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
  gap: var(--doc-space-4);
  margin: 0 0 var(--doc-space-5);
}

.doc-card {
  border: 1px solid var(--doc-border);
  border-radius: var(--doc-radius-md);
  padding: var(--doc-space-4);
  background: var(--doc-bg-raised);
  display: block;
}

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

.doc-card__title {
  font-weight: 700;
  color: var(--doc-text);
  margin-bottom: var(--doc-space-1);
}

.doc-card__desc {
  color: var(--doc-text-muted);
  font-size: 0.88rem;
}

/* ---------- Responsive ---------- */

@media (max-width: 1180px) {
  .doc-shell {
    grid-template-columns: var(--doc-sidebar-w) minmax(0, 1fr);
  }

  .doc-toc {
    display: none;
  }
}

@media (max-width: 860px) {
  .doc-header__menu-btn {
    display: inline-flex;
  }

  .doc-header__links {
    display: none;
  }

  .doc-shell {
    grid-template-columns: 1fr;
  }

  .doc-sidebar {
    position: fixed;
    left: 0;
    top: var(--doc-header-h);
    bottom: 0;
    width: min(84vw, 320px);
    background: var(--doc-bg);
    transform: translateX(-100%);
    transition: transform 0.18s ease;
    z-index: 20;
    box-shadow: 4px 0 24px var(--doc-shadow);
  }

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

  body.doc-sidebar-open::after {
    content: '';
    position: fixed;
    inset: var(--doc-header-h) 0 0 0;
    background: rgba(0, 0, 0, 0.35);
    z-index: 15;
  }

  .doc-main {
    padding: var(--doc-space-4);
  }

  .doc-pagenav {
    flex-direction: column;
  }
}
