.doc-hero {
  position: relative;
  overflow-x: clip;
  padding-top: 76px;
  padding-bottom: 88px;
  border-bottom: 1px solid var(--border-soft);
  background:
    radial-gradient(720px 480px at 84% 32%, color-mix(in srgb, var(--color-panel-raised) 74%, transparent), transparent 72%),
    linear-gradient(var(--grid-soft) 1px, transparent 1px),
    linear-gradient(90deg, var(--grid-soft) 1px, transparent 1px),
    var(--color-bg);
  background-size: auto, 46px 46px, 46px 46px, auto;
}

.doc-hero::before {
  content: '';
  position: absolute;
  top: 0;
  right: 0;
  width: 44%;
  height: 100%;
  pointer-events: none;
  background: linear-gradient(90deg, transparent, color-mix(in srgb, var(--color-panel) 54%, transparent));
}

.doc-hero-layout {
  position: relative;
  z-index: 1;
  display: grid;
  grid-template-columns: minmax(0, 1.08fr) minmax(380px, 0.92fr);
  align-items: center;
  gap: 68px;
}

.doc-hero-copy {
  position: relative;
  z-index: 2;
}

.doc-title {
  max-width: 10em;
  margin-top: 20px;
  margin-bottom: 24px;
  font-size: clamp(52px, 5vw, 68px);
}

.doc-title .highlight {
  margin-left: 0.12em;
}

.doc-lead {
  max-width: 39em;
  margin-bottom: 28px;
  color: var(--color-text-muted);
  font-size: 18px;
}

.doc-hero-actions {
  display: flex;
  flex-wrap: wrap;
  gap: 14px;
  margin-bottom: 30px;
}

.doc-fact-line {
  display: flex;
  flex-wrap: wrap;
  gap: 10px 22px;
  padding-top: 18px;
  border-top: 1px dashed var(--color-border);
  color: var(--color-text-muted);
  font-family: var(--font-mono);
  font-size: 12px;
}

.doc-fact-line span {
  position: relative;
  padding-left: 14px;
}

.doc-fact-line span::before {
  content: '';
  position: absolute;
  top: 0.72em;
  left: 0;
  width: 6px;
  height: 6px;
  border-radius: 50%;
  background: var(--color-accent);
}

.reference-board {
  position: relative;
  overflow: clip;
  border: 1px solid var(--color-border);
  border-radius: var(--radius-large);
  background: var(--panel-glass);
  box-shadow: var(--shadow-card);
}

.reference-board::after {
  content: '';
  position: absolute;
  inset: 0;
  pointer-events: none;
  border-radius: var(--radius-large);
  box-shadow: inset 0 1px 0 color-mix(in srgb, var(--color-wave) 8%, transparent);
}

.reference-board-head,
.reference-board-foot {
  display: flex;
  align-items: center;
  justify-content: space-between;
  color: var(--color-text-muted);
  font-family: var(--font-mono);
  font-size: 10px;
  letter-spacing: 0.12em;
}

.reference-board-head {
  padding: 18px 22px;
  border-bottom: 1px solid var(--border-soft);
}

.reference-board-state {
  color: var(--color-success);
}

.reference-board > svg {
  width: 100%;
  height: auto;
  display: block;
  background: var(--color-panel-raised);
}

.reference-grid-major,
.reference-grid-minor,
.reference-route-shadow,
.reference-route,
.reference-switch,
.reference-node-ring {
  fill: none;
  stroke-linecap: round;
  stroke-linejoin: round;
}

.reference-grid-major {
  stroke: var(--grid-strong);
  stroke-width: 1;
}

.reference-grid-minor {
  stroke: var(--grid-soft);
  stroke-width: 1;
}

.reference-route-shadow {
  stroke: color-mix(in srgb, var(--color-wave) 16%, transparent);
  stroke-width: 11;
}

.reference-route {
  stroke: var(--color-wave);
  stroke-width: 2;
}

.reference-node-ring {
  stroke: color-mix(in srgb, var(--color-wave) 42%, transparent);
  stroke-width: 1.5;
}

.reference-node {
  fill: var(--color-wave);
}

.reference-switch {
  stroke: color-mix(in srgb, var(--color-text-muted) 65%, var(--color-border));
  stroke-width: 1.5;
}

.reference-board-foot {
  gap: 18px;
  padding: 15px 22px 17px;
  border-top: 1px solid var(--border-soft);
}

.doc-article {
  width: 100%;
  max-width: calc(var(--reading-width) + var(--gutter) * 2);
  margin-inline: auto;
  padding: 48px var(--gutter) 110px;
}

.doc-article .toc-tabs {
  top: 12px;
}

.doc-reading {
  min-width: 0;
}

.doc-intro {
  padding-bottom: 22px;
  border-bottom: 1px dashed var(--color-border);
}

.doc-intro > p:first-child {
  color: var(--color-text);
  font-size: 19px;
}

.doc-section {
  padding-top: 72px;
  padding-bottom: 18px;
  border-bottom: 1px solid var(--border-soft);
}

.doc-section:last-child {
  border-bottom: 0;
}

.doc-section h2 {
  margin-top: 0;
}

.doc-section h3 {
  position: relative;
  padding-left: 20px;
}

.doc-section h3::before {
  content: '';
  position: absolute;
  top: 0.48em;
  left: 0;
  width: 8px;
  height: 8px;
  border-radius: 50%;
  background: var(--color-accent);
}

.chapter-code {
  margin-bottom: 12px;
  color: var(--color-success);
  font-family: var(--font-mono);
  font-size: 11px;
  letter-spacing: 0.15em;
}

.doc-section .table-scroll {
  margin-block: 32px;
}

.doc-section .callout {
  margin-block: 34px;
}

.terminal-card {
  overflow: clip;
  margin-block: 30px;
  border: 1px solid var(--color-border);
  border-radius: var(--radius-medium);
  background: var(--color-panel);
  box-shadow: var(--shadow-card);
}

.terminal-head {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 20px;
  padding: 12px 18px;
  border-bottom: 1px solid var(--color-border);
  color: var(--color-text-muted);
  font-family: var(--font-mono);
  font-size: 11px;
  letter-spacing: 0.08em;
}

.terminal-card pre {
  margin: 0;
  border: 0;
  border-radius: 0;
  background: var(--color-panel-raised);
}

.doc-section > pre {
  margin-block: 26px;
}

@media (max-width: 960px) {
  .doc-hero-layout {
    grid-template-columns: 1fr;
    gap: 48px;
  }

  .reference-board {
    max-width: 680px;
  }

  .doc-hero::before {
    width: 100%;
    height: 48%;
    top: auto;
    bottom: 0;
    background: linear-gradient(transparent, color-mix(in srgb, var(--color-panel) 46%, transparent));
  }
}

@media (max-width: 640px) {
  .doc-hero {
    padding-top: 52px;
    padding-bottom: 62px;
    background-size: auto, 32px 32px, 32px 32px, auto;
  }

  .doc-hero-layout {
    grid-template-columns: minmax(0, 1fr);
    gap: 38px;
  }

  .doc-title {
    max-width: 100%;
    font-size: clamp(30px, 9.5vw, 40px);
  }

  .doc-title .highlight {
    margin-left: 0;
  }

  .doc-lead {
    font-size: 16px;
  }

  .doc-hero-actions {
    align-items: stretch;
    flex-direction: column;
  }

  .doc-hero-actions .btn-primary,
  .doc-hero-actions .btn-secondary {
    width: 100%;
  }

  .reference-board-head,
  .reference-board-foot {
    padding-inline: 14px;
  }

  .reference-board-foot {
    gap: 8px;
    font-size: 9px;
  }

  .doc-article {
    padding-top: 34px;
    padding-bottom: 78px;
  }

  .doc-section {
    padding-top: 58px;
  }

  .doc-intro > p:first-child {
    font-size: 17px;
  }

  .doc-section h3 {
    padding-left: 17px;
  }

  .terminal-head {
    padding-inline: 14px;
  }
}

@media (prefers-reduced-motion: reduce) {
  .reference-board {
    transition: none;
  }
}