.hero-doc {
  display: grid;
  grid-template-columns: minmax(0, 1.5fr) minmax(280px, 0.9fr);
  gap: 24px;
  padding: 26px 0 24px;
  align-items: stretch;
}

.hero-copy {
  padding: 36px 0 10px;
}

.hero-copy h2 {
  margin: 14px 0 14px;
  font-family: "Fraunces", serif;
  font-size: clamp(2.4rem, 5vw, 4.5rem);
  line-height: 0.98;
  max-width: 10ch;
}

.hero-copy p {
  max-width: 62ch;
  font-size: 17px;
  line-height: 1.7;
  color: var(--muted);
}

.hero-actions,
.topbar-actions {
  display: flex;
  flex-wrap: wrap;
  gap: 12px;
}

.hero-side {
  padding: 26px;
  background:
    radial-gradient(circle at top right, rgba(255, 107, 53, 0.18), transparent 42%),
    linear-gradient(180deg, rgba(255, 255, 255, 0.96), rgba(250, 245, 236, 0.98));
}

.hero-side h3 {
  margin: 0 0 14px;
  font-family: "Fraunces", serif;
  font-size: 28px;
}

.hero-side ul,
.section-card ul,
.section-card ol {
  margin: 0;
  padding-left: 20px;
  color: var(--muted);
  line-height: 1.65;
}

.metrics-strip {
  display: grid;
  grid-template-columns: repeat(4, minmax(0, 1fr));
  gap: 16px;
  margin: 8px 0 28px;
}

.metric-card {
  background: rgba(255, 255, 255, 0.86);
  border: 1px solid var(--stroke);
  border-radius: 18px;
  padding: 20px;
  backdrop-filter: blur(10px);
  box-shadow: 0 12px 24px rgba(31, 28, 22, 0.08);
}

.metric-card strong {
  display: block;
  font-size: 28px;
  font-family: "Fraunces", serif;
}

.metric-card span {
  display: block;
  margin-top: 6px;
  color: var(--muted);
  line-height: 1.4;
}

.doc-layout {
  display: grid;
  grid-template-columns: 240px minmax(0, 1fr);
  gap: 24px;
  padding-bottom: 70px;
}

.doc-nav {
  position: sticky;
  top: 24px;
  align-self: start;
  display: grid;
  gap: 8px;
  padding: 18px;
}

.doc-nav a {
  padding: 12px 14px;
  border-radius: 12px;
  color: var(--muted);
  background: rgba(250, 245, 236, 0.75);
  border: 1px solid transparent;
  transition: background-color 0.2s ease, border-color 0.2s ease, color 0.2s ease;
}

.doc-nav a:hover {
  color: var(--ink);
  background: #fff;
  border-color: var(--stroke);
}

.doc-content {
  display: grid;
  gap: 24px;
}

.section-card {
  padding: 28px;
}

.section-card h3 {
  margin: 0 0 12px;
  font-family: "Fraunces", serif;
  font-size: 32px;
}

.section-card h4 {
  margin: 0 0 8px;
  font-size: 17px;
}

.section-card p {
  margin: 0;
  color: var(--muted);
  line-height: 1.7;
}

.step-list {
  display: grid;
  gap: 14px;
}

.step-list article {
  display: grid;
  grid-template-columns: 52px minmax(0, 1fr);
  gap: 16px;
  padding: 18px;
  border-radius: 18px;
  background: var(--surface-2);
  border: 1px solid var(--stroke);
}

.step-list span {
  width: 52px;
  height: 52px;
  display: grid;
  place-items: center;
  border-radius: 16px;
  background: linear-gradient(135deg, #ff8a3d, #ff5f6b);
  color: #fff;
  font-weight: 700;
}

.module-grid,
.stats-grid,
.example-grid,
.architecture-grid {
  display: grid;
  gap: 16px;
}

.module-grid {
  grid-template-columns: repeat(2, minmax(0, 1fr));
}

.module-grid article,
.stats-grid article,
.example-grid article {
  padding: 18px;
  border-radius: 18px;
  background: var(--surface-2);
  border: 1px solid var(--stroke);
}

.stats-grid {
  grid-template-columns: repeat(2, minmax(0, 1fr));
}

.architecture-grid {
  grid-template-columns: repeat(2, minmax(0, 1fr));
  margin-top: 18px;
}

.example-grid {
  grid-template-columns: repeat(2, minmax(0, 1fr));
}

pre {
  margin: 0;
  padding: 16px;
  border-radius: 16px;
  background: #1d1b18;
  color: #f8f2e8;
  font-family: "JetBrains Mono", monospace;
  font-size: 13px;
  line-height: 1.6;
  white-space: pre-wrap;
}

.small-note {
  margin-top: 16px !important;
  font-size: 13px;
  color: var(--muted);
}

@media (max-width: 1100px) {
  .metrics-strip,
  .module-grid,
  .stats-grid,
  .example-grid,
  .architecture-grid {
    grid-template-columns: 1fr 1fr;
  }

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

  .doc-nav {
    position: static;
    grid-template-columns: repeat(3, minmax(0, 1fr));
  }
}

@media (max-width: 900px) {
  .hero-doc,
  .metrics-strip,
  .module-grid,
  .stats-grid,
  .example-grid,
  .architecture-grid,
  .doc-nav {
    grid-template-columns: 1fr;
  }

  .hero-copy h2 {
    max-width: none;
  }

  .section-card,
  .hero-side {
    padding: 22px;
  }

  .step-list article {
    grid-template-columns: 1fr;
  }
}