/* ============================================================
   Docs — API documentation styles
   Scoped to .docs-page on <main>.
   ============================================================ */

/* ---- Docs hero: compact, left-aligned ---- */
.docs-page .hero {
  padding: var(--space-12) var(--space-6) var(--space-6);
  text-align: left;
}

.docs-page .hero h1 {
  font-size: var(--text-2xl);
  margin-bottom: var(--space-3);
}

.docs-page .hero p {
  margin-inline: 0;
  font-size: var(--text-base);
  max-width: none;
}

/* ---- Docs content section: tighter top spacing ---- */
.docs-page .section {
  padding-top: var(--space-6);
  padding-bottom: var(--space-16);
}

/* ---- Heading rhythm ---- */
.docs-page h2 {
  font-size: var(--text-xl);
  font-weight: 700;
  margin-top: var(--space-16);
  margin-bottom: var(--space-6);
  padding-bottom: var(--space-3);
  border-bottom: 2px solid var(--color-border);
}

.docs-page .section h2:first-child {
  margin-top: 0;
}

.docs-page h3 {
  margin-top: var(--space-10);
  margin-bottom: var(--space-4);
}

.docs-page .section p {
  line-height: 1.7;
  color: var(--color-text-secondary);
}

.docs-page .section a {
  font-weight: 500;
}

.docs-page ul,
.docs-page ol {
  margin-bottom: var(--space-6);
  padding-left: var(--space-6);
  display: flex;
  flex-direction: column;
  gap: var(--space-2);
}

.docs-page ul {
  list-style: disc;
}

.docs-page ol {
  list-style: decimal;
}

.docs-page li {
  line-height: 1.7;
  color: var(--color-text-secondary);
}

.docs-page li strong {
  color: var(--color-text);
}

/* ---- Tables ---- */
.docs-table {
  width: 100%;
  border-collapse: separate;
  border-spacing: 0;
  margin: var(--space-4) 0 var(--space-8);
  font-size: var(--text-sm);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  overflow: hidden;
}

.docs-table th,
.docs-table td {
  padding: var(--space-3) var(--space-4);
  text-align: left;
  border-bottom: 1px solid var(--color-border);
}

.docs-table th {
  font-weight: 600;
  font-size: var(--text-xs);
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--color-text-secondary);
  background: var(--color-surface-alt);
}

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

.docs-table td code {
  font-size: var(--text-xs);
  background: var(--color-surface-alt);
  padding: 2px 6px;
  border-radius: var(--radius-sm);
  white-space: nowrap;
}

/* ---- Code blocks ---- */
pre {
  background: var(--color-footer-bg);
  color: var(--color-footer-text);
  padding: var(--space-6);
  border-radius: var(--radius-md);
  overflow-x: auto;
  margin: var(--space-4) 0 var(--space-8);
  font-family: var(--font-mono);
  font-size: 0.8125rem;
  line-height: 1.7;
  border: 1px solid rgba(255, 255, 255, 0.06);
}

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

/* ---- Inline code ---- */
code {
  font-family: var(--font-mono);
  font-size: 0.85em;
  background: var(--color-surface-alt);
  padding: 2px 7px;
  border-radius: var(--radius-sm);
  color: var(--color-text);
  border: 1px solid var(--color-border);
}

/* ---- Definition lists for domain models ---- */
.docs-dl {
  margin: var(--space-6) 0 var(--space-10);
  display: flex;
  flex-direction: column;
  gap: var(--space-6);
}

.docs-dl dt {
  font-weight: 700;
  font-size: var(--text-base);
  color: var(--color-text);
  display: flex;
  align-items: center;
  gap: var(--space-2);
}

.docs-dl dt::before {
  content: '';
  width: 8px;
  height: 8px;
  border-radius: var(--radius-full);
  background-color: var(--color-primary);
  flex-shrink: 0;
}

.docs-dl dd {
  margin-left: 0;
  padding-left: var(--space-6);
  border-left: 2px solid var(--color-border);
  margin-top: var(--space-1);
  color: var(--color-text-secondary);
  line-height: 1.7;
  font-size: var(--text-sm);
}

/* ---- Horizontal rules between endpoint sections ---- */
.docs-page hr {
  border: none;
  border-top: 1px solid var(--color-border);
  margin: var(--space-12) 0;
}

/* ---- Endpoint headings ---- */
h3 code {
  font-size: var(--text-base);
  font-weight: 600;
  background: var(--color-surface-alt);
  padding: var(--space-2) var(--space-4);
  border-radius: var(--radius-md);
  border: 1px solid var(--color-border);
  display: inline-block;
}

/* ---- Section labels (Response, Parameters, etc.) ---- */
.docs-page h4 {
  font-size: var(--text-xs);
  text-transform: uppercase;
  letter-spacing: 0.06em;
  font-weight: 600;
  color: var(--color-text-secondary);
  margin-top: var(--space-6);
  margin-bottom: var(--space-3);
}

/* ---- Back link ---- */
.docs-page .blog-read-more {
  font-size: var(--text-sm);
  font-weight: 500;
  color: var(--color-primary);
  text-decoration: none;
}

.docs-page .blog-read-more:hover {
  text-decoration: underline;
}

/* ---- Docs index: API reference cards ---- */
.docs-page .grid-2 .card-product {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  padding: var(--space-6);
  transition: box-shadow var(--duration-normal) var(--ease-default),
              border-color var(--duration-normal) var(--ease-default);
}

.docs-page .grid-2 .card-product:hover {
  box-shadow: var(--shadow-md);
  border-color: var(--color-primary);
}

.docs-page .grid-2 .card-product h3 {
  font-size: var(--text-lg);
  font-weight: 600;
  color: var(--color-text);
  margin-top: 0;
  margin-bottom: var(--space-2);
}

.docs-page .grid-2 .card-product p {
  font-size: var(--text-sm);
  color: var(--color-text-secondary);
  margin-bottom: 0;
}