/* ============================================================
   API Reference — styles for pages under /docs/api/
   Layered on top of docs.css. Scoped to .docs-page so it
   never leaks onto the marketing site.
   ============================================================ */

.docs-page .api-page-header {
  margin: 0 0 1.5rem;
  padding-bottom: 1rem;
  border-bottom: 1px solid var(--docs-border, #e5e7eb);
}
.docs-page .api-overview {
  margin: 2rem 0 2.5rem;
  padding: 1.25rem 1.5rem 1rem;
  background: var(--docs-bg-subtle, #f9fafb);
  border: 1px solid var(--docs-border, #e5e7eb);
  border-radius: 8px;
}
.docs-page .api-overview > h2 { margin-top: 0; }
.docs-page .api-overview-lede {
  color: var(--docs-muted, #6b7280);
  margin: 0 0 0.75rem;
}
.docs-page .api-overview-index-list {
  list-style: none;
  margin: 0;
  padding: 0;
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
  gap: 0.5rem;
}
.docs-page .api-overview-index-list li {
  margin: 0;
}
.docs-page .api-overview-index-list a {
  display: block;
  padding: 0.6rem 0.8rem;
  background: #fff;
  border: 1px solid var(--docs-border, #e5e7eb);
  border-radius: 6px;
  text-decoration: none;
  color: inherit;
  transition: border-color .15s ease, background .15s ease;
}
.docs-page .api-overview-index-list a:hover {
  border-color: var(--docs-link, #2563eb);
  background: #f9fafb;
}
.docs-page .api-overview-standalone {
  border-top: none;
  padding-top: 0;
}
.docs-page .api-overview-section {
  margin: 1.5rem 0;
  padding-top: 1rem;
  border-top: 1px dashed var(--docs-border, #e5e7eb);
}
.docs-page .api-overview-section:first-of-type { border-top: none; padding-top: 0; }
.docs-page .api-overview-section > h3 {
  margin: 0 0 0.5rem;
  scroll-margin-top: 80px;
}
.docs-page .api-overview-section table {
  border-collapse: collapse;
  width: 100%;
  margin: 0.75rem 0;
  font-size: 0.9rem;
}
.docs-page .api-overview-section th,
.docs-page .api-overview-section td {
  border: 1px solid var(--docs-border, #e5e7eb);
  padding: 0.4rem 0.65rem;
  text-align: left;
  vertical-align: top;
}
.docs-page .api-overview-section th {
  background: #fff;
  font-weight: 600;
}
.docs-page .api-eyebrow {
  font-size: 0.8rem;
  font-weight: 600;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  color: var(--docs-muted, #6b7280);
  margin-bottom: 0.4rem;
}
.docs-page .api-page-lede {
  color: var(--docs-muted, #6b7280);
  margin: 0.25rem 0 0;
}
.docs-page .api-page-meta {
  font-size: 0.9rem;
  color: var(--docs-muted, #6b7280);
}

/* HTTP method badge — soft tinted pills (same hue, lighter bg + dark text) */
.docs-page .api-method {
  display: inline-block;
  font-family: "JetBrains Mono", ui-monospace, monospace;
  font-weight: 500;
  font-size: 0.75rem;
  padding: 0.15rem 0.55rem;
  border-radius: 4px;
  letter-spacing: 0.04em;
  border: 1px solid transparent;
  vertical-align: middle;
}
.docs-page .api-method--get    { background: #eff6ff; color: #1d4ed8; border-color: #bfdbfe; }
.docs-page .api-method--post   { background: #ecfdf5; color: #047857; border-color: #a7f3d0; }
.docs-page .api-method--put    { background: #fffbeb; color: #b45309; border-color: #fde68a; }
.docs-page .api-method--delete { background: #fef2f2; color: #b91c1c; border-color: #fecaca; }
.docs-page .api-method--patch  { background: #f5f3ff; color: #6d28d9; border-color: #ddd6fe; }

.docs-page .api-endpoint {
  margin-top: 0.5rem;
  display: flex;
  align-items: center;
  gap: 0.6rem;
  flex-wrap: wrap;
}
.docs-page .api-endpoint-path {
  font-size: 0.95rem;
  padding: 0.2rem 0.5rem;
  background: var(--docs-code-bg, #f3f4f6);
  border-radius: 4px;
}

/* Tables
   Each table is wrapped in .api-table-wrap, which owns the rounded border so
   the corners stay crisp; the table itself is a true full-width fixed-layout
   grid so header underlines and row separators span the whole box and columns
   line up. Fixed layout + per-column widths keep long identifiers and long
   descriptions from char-wrapping into an unreadable mess. */
.docs-page .api-table-wrap {
  margin: 1rem 0 1.5rem;
  border: 1px solid var(--docs-border, #e5e7eb);
  border-radius: 8px;
  overflow: hidden;
  background: var(--docs-bg, #fff);
}
.docs-page .api-table {
  display: table;
  width: 100%;
  table-layout: fixed;
  border-collapse: collapse;
  margin: 0;
  border: 0;
  border-radius: 0;
  font-size: 0.9rem;
}
.docs-page .api-table th,
.docs-page .api-table td {
  text-align: left;
  padding: 0.6rem 0.85rem;
  border: 0;
  border-bottom: 1px solid var(--docs-border, #e5e7eb);
  vertical-align: top;
  overflow-wrap: break-word;
  word-break: normal;
}
.docs-page .api-table tbody tr:last-child td { border-bottom: 0; }
.docs-page .api-table tbody tr:hover td { background: var(--docs-bg-subtle, #f9fafb); }
.docs-page .api-table thead th {
  font-weight: 600;
  font-size: 0.74rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--docs-muted, #6b7280);
  background: var(--docs-bg-subtle, #f9fafb);
  white-space: nowrap;
}
.docs-page .api-table td p { margin: 0; }
.docs-page .api-table td p + p { margin-top: 0.4rem; }
.docs-page .api-table td code {
  white-space: normal;
  overflow-wrap: break-word;
}

/* Column widths — name/type/required/description for param & schema tables */
.docs-page .api-table--params  col,
.docs-page .api-table--schema  col { /* placeholder if colgroups added later */ }
.docs-page .api-table--params  th:nth-child(1),
.docs-page .api-table--params  td:nth-child(1),
.docs-page .api-table--schema  th:nth-child(1),
.docs-page .api-table--schema  td:nth-child(1) { width: 26%; }
.docs-page .api-table--params  th:nth-child(2),
.docs-page .api-table--params  td:nth-child(2),
.docs-page .api-table--schema  th:nth-child(2),
.docs-page .api-table--schema  td:nth-child(2) { width: 18%; }
.docs-page .api-table--params  th:nth-child(3),
.docs-page .api-table--params  td:nth-child(3),
.docs-page .api-table--schema  th:nth-child(3),
.docs-page .api-table--schema  td:nth-child(3) { width: 11%; }

/* Status / Description / Body for response tables */
.docs-page .api-table--responses th:nth-child(1),
.docs-page .api-table--responses td:nth-child(1) { width: 14%; }
.docs-page .api-table--responses th:nth-child(2),
.docs-page .api-table--responses td:nth-child(2) { width: 34%; }

/* On narrow screens let the wrapper scroll instead of crushing columns */
@media (max-width: 640px) {
  .docs-page .api-table-wrap { overflow-x: auto; }
  .docs-page .api-table { min-width: 480px; }
}

.docs-page .api-nullable {
  display: inline-block;
  font-size: 0.7rem;
  padding: 0 0.35rem;
  margin-left: 0.25rem;
  border-radius: 3px;
  background: var(--docs-code-bg, #f3f4f6);
  color: var(--docs-muted, #6b7280);
}
.docs-page .api-default {
  display: inline-block;
  font-size: 0.75rem;
  color: var(--docs-muted, #6b7280);
}
.docs-page .api-op-id {
  font-size: 0.8rem;
  color: var(--docs-muted, #6b7280);
}
.docs-page .api-muted { color: var(--docs-muted, #6b7280); }

/* Card grid (index page) */
.docs-page .api-card-grid {
  display: grid;
  gap: 0.85rem;
  grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
  margin: 1rem 0 2rem;
}
.docs-page .api-card {
  display: block;
  padding: 1rem 1.1rem;
  border: 1px solid var(--docs-border, #e5e7eb);
  border-radius: 8px;
  text-decoration: none;
  color: inherit;
  background: var(--docs-bg, #fff);
  transition: border-color 0.15s, transform 0.15s;
}
.docs-page .api-card:hover {
  border-color: var(--docs-accent, #2563eb);
  transform: translateY(-1px);
}
.docs-page .api-card-title {
  font-weight: 600;
  font-size: 1rem;
  margin-bottom: 0.25rem;
}
.docs-page .api-card-meta {
  font-size: 0.78rem;
  color: var(--docs-muted, #6b7280);
  margin-bottom: 0.5rem;
}
.docs-page .api-card-desc p { margin: 0; font-size: 0.9rem; color: var(--docs-muted, #6b7280); }

.docs-page .api-ontology-list { line-height: 1.8; }
.docs-page .api-related { line-height: 1.7; }

.docs-page .api-example-lang {
  font-size: 0.72rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--docs-muted, #6b7280);
  margin: 0.5rem 0 0.25rem;
}

.docs-page .api-source-link {
  margin-top: 2rem;
  padding-top: 1rem;
  border-top: 1px dashed var(--docs-border, #e5e7eb);
  font-size: 0.85rem;
  color: var(--docs-muted, #6b7280);
}

.docs-page .api-type-ref { text-decoration: none; }
.docs-page .api-type-ref:hover { text-decoration: underline; }

/* Merged operation page (two+ ops on one page) */
.docs-page .api-merged-intro {
  font-size: 0.95rem;
  color: var(--docs-muted, #6b7280);
  margin-top: 1.5rem;
  margin-bottom: 0.5rem;
}
.docs-page .api-merged-toc {
  list-style: none;
  padding: 0.75rem 1rem;
  margin: 0 0 2rem;
  background: var(--docs-surface, #f9fafb);
  border: 1px solid var(--docs-border, #e5e7eb);
  border-radius: 8px;
}
.docs-page .api-merged-toc li {
  padding: 0.35rem 0;
  display: flex;
  align-items: center;
  gap: 0.5rem;
  flex-wrap: wrap;
}
.docs-page .api-merged-toc li + li {
  border-top: 1px solid var(--docs-border, #e5e7eb);
}
.docs-page .api-merged-toc a {
  text-decoration: none;
  margin-right: 0.25rem;
}
.docs-page .api-merged-toc a:hover { text-decoration: underline; }

.docs-page .api-merged-section {
  margin-top: 2.5rem;
  padding-top: 1.5rem;
  border-top: 2px solid var(--docs-border, #e5e7eb);
  scroll-margin-top: 80px;
}
.docs-page .api-merged-section-header {
  display: flex;
  align-items: baseline;
  justify-content: space-between;
  gap: 1rem;
  flex-wrap: wrap;
  margin-bottom: 0.5rem;
}
.docs-page .api-merged-section-title {
  margin: 0;
}
.docs-page .api-merged-section-opid {
  font-size: 0.75rem;
  color: var(--docs-muted, #6b7280);
  background: var(--docs-surface, #f3f4f6);
  padding: 0.15rem 0.5rem;
  border-radius: 4px;
}

.docs-page .api-page-intro {
  font-size: 0.95rem;
  line-height: 1.6;
  margin: 1.5rem 0;
  padding: 1rem 1.25rem;
  background: var(--docs-surface, #f9fafb);
  border-left: 3px solid var(--docs-accent, #1e5c97);
  border-radius: 0 6px 6px 0;
}
.docs-page .api-page-intro p:last-child { margin-bottom: 0; }
