/* ── Scoped styles for the public API documentation page ─────────────────
   Uses spoolr CSS custom properties (from spoolr_tokens.css) so light/dark
   themes, palettes, and density preferences work automatically.
   Scope: .docs-article only — no global side-effects.                    */

.docs-article {
  color: var(--spoolr-color-foreground);
  font-family: var(--spoolr-font-sans);
  font-size: 1rem;
  line-height: 1.75;
}

/* ── Headings ─────────────────────────────────────────────────────────── */

.docs-article h1 {
  font-family: var(--spoolr-font-sans);
  font-size: 1.875rem;
  font-weight: 700;
  line-height: 1.2;
  color: var(--spoolr-color-foreground);
  margin-top: 0;
  margin-bottom: 1.25rem;
}

.docs-article h2 {
  font-family: var(--spoolr-font-sans);
  font-size: 1.375rem;
  font-weight: 600;
  line-height: 1.3;
  color: var(--spoolr-color-foreground);
  margin-top: 2.5rem;
  margin-bottom: 0.75rem;
  padding-bottom: 0.5rem;
  border-bottom: 1px solid var(--spoolr-color-border);
}

.docs-article h3 {
  font-family: var(--spoolr-font-sans);
  font-size: 1.125rem;
  font-weight: 600;
  line-height: 1.4;
  color: var(--spoolr-color-foreground);
  margin-top: 2rem;
  margin-bottom: 0.5rem;
}

.docs-article h4,
.docs-article h5,
.docs-article h6 {
  font-family: var(--spoolr-font-sans);
  font-weight: 600;
  color: var(--spoolr-color-foreground);
  margin-top: 1.5rem;
  margin-bottom: 0.5rem;
}

/* ── Paragraphs & inline text ─────────────────────────────────────────── */

.docs-article p {
  margin-top: 0;
  margin-bottom: 1rem;
  color: var(--spoolr-color-foreground);
}

.docs-article strong {
  font-weight: 600;
  color: var(--spoolr-color-foreground);
}

.docs-article em {
  font-style: italic;
}

/* ── Links ────────────────────────────────────────────────────────────── */

.docs-article a {
  color: var(--spoolr-color-primary);
  text-decoration: underline;
  text-underline-offset: 2px;
}

.docs-article a:hover {
  opacity: 0.8;
}

.docs-article a:focus-visible {
  outline: 2px solid var(--spoolr-color-ring);
  outline-offset: 2px;
  border-radius: 2px;
}

/* ── Lists ────────────────────────────────────────────────────────────── */

.docs-article ul,
.docs-article ol {
  margin-top: 0;
  margin-bottom: 1rem;
  padding-left: 1.5rem;
}

.docs-article li {
  margin-bottom: 0.25rem;
}

.docs-article li > ul,
.docs-article li > ol {
  margin-top: 0.25rem;
  margin-bottom: 0.25rem;
}

/* ── Blockquotes ──────────────────────────────────────────────────────── */

.docs-article blockquote {
  margin: 1.25rem 0;
  padding: 0.75rem 1rem;
  border-left: 3px solid var(--spoolr-color-primary);
  background-color: var(--spoolr-color-muted);
  border-radius: 0 var(--spoolr-radius-none, 0px) var(--spoolr-radius-none, 0px) 0;
  color: var(--spoolr-color-muted-foreground);
}

.docs-article blockquote p {
  margin-bottom: 0;
  color: var(--spoolr-color-muted-foreground);
}

/* ── Inline code ──────────────────────────────────────────────────────── */

.docs-article :not(pre) > code {
  font-family: var(--spoolr-font-mono);
  font-size: 0.875em;
  padding: 0.15em 0.35em;
  background-color: var(--spoolr-color-muted);
  border: 1px solid var(--spoolr-color-border);
  border-radius: 3px;
  color: var(--spoolr-color-primary);
  white-space: nowrap;
}

/* ── Code blocks ──────────────────────────────────────────────────────── */

.docs-article pre {
  margin: 1.25rem 0;
  padding: 1rem 1.25rem;
  background-color: var(--spoolr-color-card);
  border: 1px solid var(--spoolr-color-border);
  border-radius: 0;
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;
}

.docs-article pre code {
  font-family: var(--spoolr-font-mono);
  font-size: 0.8125rem;
  line-height: 1.6;
  background: none;
  border: none;
  padding: 0;
  color: var(--spoolr-color-foreground);
  white-space: pre;
}

/* ── Tables ───────────────────────────────────────────────────────────── */

.docs-article .table-wrapper {
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;
  margin: 1.25rem 0;
  border: 1px solid var(--spoolr-color-border);
}

.docs-article table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.875rem;
  min-width: 480px;
}

.docs-article thead {
  background-color: var(--spoolr-color-muted);
}

.docs-article th {
  font-family: var(--spoolr-font-sans);
  font-weight: 600;
  font-size: 0.75rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--spoolr-color-muted-foreground);
  padding: 0.625rem 0.875rem;
  text-align: left;
  border-bottom: 1px solid var(--spoolr-color-border);
  white-space: nowrap;
}

.docs-article td {
  padding: 0.5rem 0.875rem;
  border-bottom: 1px solid var(--spoolr-color-border);
  vertical-align: top;
}

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

.docs-article tbody tr:hover {
  background-color: var(--spoolr-color-muted);
}

/* ── Horizontal rules ─────────────────────────────────────────────────── */

.docs-article hr {
  margin: 2.5rem 0;
  border: none;
  border-top: 1px solid var(--spoolr-color-border);
}