/* Ventrin API guide — document-grade developer reference.
   Builds on landing/styles.css tokens; no overrides to shared classes. */

.vt-doc-body {
  background: var(--vt-bg-page);
  color: var(--vt-ink);
  font-family: var(--vt-font-sans);
  line-height: 1.55;
}

.vt-nav-docs {
  border-bottom: 1px solid var(--vt-line);
  background: var(--vt-bg-0);
  position: sticky;
  top: 0;
  z-index: 50;
}
.vt-doc-nav-crumb {
  margin-left: 10px;
  padding: 2px 8px;
  border: 1px solid var(--vt-line);
  border-radius: 4px;
  font-size: 11px;
  letter-spacing: 0.02em;
  color: var(--vt-ink-3);
  text-transform: uppercase;
  background: var(--vt-bg-1);
}

/* ── Layout ─────────────────────────────────────────────────────────── */
.vt-doc {
  max-width: var(--vt-max);
  margin: 0 auto;
  padding: 40px var(--vt-pad-x) 120px;
  display: grid;
  grid-template-columns: 220px 1fr;
  gap: 48px;
  align-items: start;
}

/* Tablet: single column, TOC above content. */
@media (max-width: 960px) {
  .vt-doc {
    grid-template-columns: 1fr;
    gap: 16px;
    padding: 24px var(--vt-pad-x) 80px;
  }
  .vt-doc-toc {
    position: static;
    top: auto;
    max-height: none;
    padding-right: 0;
    border-right: 0;
    border-bottom: 1px solid var(--vt-line);
    padding-bottom: 12px;
  }
}

/* Phone: TOC becomes a native <details> drawer. */
@media (max-width: 720px) {
  .vt-doc-toc { display: none; }
  .vt-doc-toc-mobile {
    display: block;
    margin: 0 0 18px;
    border: 1px solid var(--vt-line);
    border-radius: 8px;
    background: var(--vt-bg-0);
    overflow: hidden;
  }
  .vt-doc-toc-mobile summary {
    list-style: none;
    padding: 10px 14px;
    font-size: 13px;
    font-weight: 600;
    color: var(--vt-ink);
    cursor: pointer;
    display: flex;
    align-items: center;
    justify-content: space-between;
  }
  .vt-doc-toc-mobile summary::-webkit-details-marker { display: none; }
  .vt-doc-toc-mobile summary::after {
    content: "\25BC";
    font-size: 10px;
    color: var(--vt-ink-4);
    transition: transform 160ms;
  }
  .vt-doc-toc-mobile[open] summary::after { transform: rotate(180deg); }
  .vt-doc-toc-mobile ol {
    list-style: none;
    padding: 4px 0 8px;
    margin: 0;
    counter-reset: toc;
    border-top: 1px solid var(--vt-line-soft);
  }
  .vt-doc-toc-mobile li { counter-increment: toc; }
  .vt-doc-toc-mobile a {
    display: block;
    padding: 8px 14px 8px 36px;
    color: var(--vt-ink-3);
    text-decoration: none;
    position: relative;
    font-size: 13.5px;
  }
  .vt-doc-toc-mobile a::before {
    content: counter(toc);
    position: absolute;
    left: 14px;
    top: 8px;
    font-family: var(--vt-font-mono);
    font-size: 10.5px;
    color: var(--vt-ink-5);
  }
  .vt-doc-toc-mobile a:active,
  .vt-doc-toc-mobile a:hover { background: var(--vt-bg-1); color: var(--vt-ink); }

  .vt-doc-h1 { font-size: 32px; }
  .vt-doc-lede { font-size: 15px; }
  .vt-doc-body-inner h2 { font-size: 22px; }
  .vt-code pre { font-size: 11.5px; padding: 12px; }
  .vt-doc-table { font-size: 12.5px; }
  .vt-doc-table th, .vt-doc-table td { padding: 8px 10px; }
  .vt-doc-known { grid-template-columns: 1fr; }
  .vt-doc-end { flex-direction: column; align-items: stretch; }
}
.vt-doc-toc-mobile { display: none; }

.vt-doc-toc {
  position: sticky;
  top: 92px;
  max-height: calc(100vh - 120px);
  overflow-y: auto;
  padding-right: 18px;
  border-right: 1px solid var(--vt-line-soft);
  font-size: 13px;
}
.vt-doc-toc-title {
  font-size: 11px;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--vt-ink-4);
  margin-bottom: 10px;
  font-weight: 600;
}
.vt-doc-toc ol {
  list-style: none;
  padding: 0;
  margin: 0;
  counter-reset: toc;
}
.vt-doc-toc li {
  counter-increment: toc;
  margin: 0;
}
.vt-doc-toc a {
  display: block;
  padding: 5px 0 5px 20px;
  color: var(--vt-ink-3);
  text-decoration: none;
  border-left: 2px solid transparent;
  margin-left: -2px;
  position: relative;
  transition: color 120ms, border-color 120ms;
}
.vt-doc-toc a::before {
  content: counter(toc);
  position: absolute;
  left: 0;
  top: 5px;
  font-family: var(--vt-font-mono);
  font-size: 10.5px;
  color: var(--vt-ink-5);
}
.vt-doc-toc a:hover {
  color: var(--vt-ink);
}
.vt-doc-toc a.active {
  color: var(--vt-ink);
  border-left-color: var(--vt-ink);
  font-weight: 500;
}

/* ── Body ───────────────────────────────────────────────────────────── */
.vt-doc-body-inner {
  max-width: 780px;
  min-width: 0;
}
.vt-doc-body-inner section {
  padding-top: 28px;
  margin-top: 28px;
  border-top: 1px solid var(--vt-line-soft);
  scroll-margin-top: 96px;
}
.vt-doc-body-inner section:first-of-type {
  border-top: 0;
  padding-top: 0;
  margin-top: 0;
}

.vt-doc-hero {
  padding: 24px 0 32px;
  border-bottom: 1px solid var(--vt-line);
  margin-bottom: 20px;
}
.vt-doc-eyebrow {
  font-size: 11px;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--vt-ink-4);
  font-weight: 600;
  margin-bottom: 12px;
}
.vt-doc-h1 {
  font-family: var(--vt-font-serif);
  font-size: 44px;
  line-height: 1.08;
  font-weight: 600;
  margin: 0 0 16px;
  letter-spacing: -0.015em;
}
.vt-doc-lede {
  font-size: 17px;
  color: var(--vt-ink-2);
  margin: 0 0 20px;
  max-width: 640px;
}
.vt-doc-lede em {
  font-style: italic;
  color: var(--vt-ink);
}
.vt-doc-meta {
  display: flex;
  gap: 10px;
  flex-wrap: wrap;
}

.vt-pill {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  padding: 4px 10px;
  border-radius: 999px;
  font-size: 11.5px;
  font-weight: 500;
  color: var(--vt-ink-3);
  background: var(--vt-bg-0);
  border: 1px solid var(--vt-line);
}
.vt-pill-live {
  color: var(--vt-green);
  background: var(--vt-green-tint);
  border-color: var(--vt-green);
}
.vt-pill-live::before {
  content: "";
  display: inline-block;
  width: 6px; height: 6px;
  border-radius: 50%;
  background: var(--vt-green);
}

/* ── Typography ─────────────────────────────────────────────────────── */
.vt-doc-body-inner h2 {
  font-family: var(--vt-font-serif);
  font-size: 26px;
  font-weight: 600;
  letter-spacing: -0.01em;
  margin: 0 0 14px;
  color: var(--vt-ink);
}
.vt-doc-body-inner h3 {
  font-size: 16px;
  font-weight: 600;
  color: var(--vt-ink);
  margin: 22px 0 10px;
}
.vt-doc-body-inner h4 {
  font-size: 14.5px;
  font-weight: 600;
  color: var(--vt-ink);
  margin: 0 0 6px;
}
.vt-doc-body-inner p {
  margin: 0 0 14px;
  color: var(--vt-ink-2);
  font-size: 14.5px;
}
.vt-doc-body-inner p strong,
.vt-doc-body-inner li strong { color: var(--vt-ink); font-weight: 600; }
.vt-doc-body-inner em { font-style: italic; }

/* Body links — but NOT links styled as buttons. The .vt-btn class wins
 *  on its own (white-on-ink for primary), and the link styling here was
 *  bleeding into the bottom CTA card. */
.vt-doc-body-inner a:not(.vt-btn) {
  color: var(--vt-blue);
  text-decoration: underline;
  text-underline-offset: 2px;
  text-decoration-thickness: 1px;
}
.vt-doc-body-inner a:not(.vt-btn):hover { color: var(--vt-blue-2); }

.vt-doc-body-inner ul,
.vt-doc-body-inner ol {
  padding-left: 22px;
  margin: 0 0 14px;
  color: var(--vt-ink-2);
  font-size: 14.5px;
}
.vt-doc-body-inner li { margin-bottom: 6px; }

code {
  font-family: var(--vt-font-mono);
  font-size: 12.5px;
  background: var(--vt-bg-1);
  border: 1px solid var(--vt-line-soft);
  padding: 1px 5px;
  border-radius: 3px;
  color: var(--vt-ink);
}
.vt-req {
  font-size: 10px;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  background: var(--vt-red-tint);
  color: var(--vt-red);
  padding: 2px 6px;
  border-radius: 4px;
  margin-left: 8px;
  vertical-align: 2px;
}

/* ── DL ─────────────────────────────────────────────────────────────── */
.vt-doc-dl {
  margin: 0 0 10px;
  padding: 0;
}
.vt-doc-dl dt {
  font-size: 14px;
  font-weight: 600;
  color: var(--vt-ink);
  margin-top: 14px;
}
.vt-doc-dl dt:first-child { margin-top: 0; }
.vt-doc-dl dd {
  margin: 4px 0 0;
  padding: 0;
  color: var(--vt-ink-2);
  font-size: 14px;
}

/* ── Tables ────────────────────────────────────────────────────────── */
.vt-doc-table {
  width: 100%;
  border-collapse: collapse;
  margin: 0 0 16px;
  font-size: 13.5px;
  background: var(--vt-bg-0);
  border: 1px solid var(--vt-line);
  border-radius: 6px;
  overflow: hidden;
}
.vt-doc-table th,
.vt-doc-table td {
  text-align: left;
  padding: 10px 14px;
  border-bottom: 1px solid var(--vt-line-soft);
  vertical-align: top;
  color: var(--vt-ink-2);
}
.vt-doc-table th {
  background: var(--vt-bg-1);
  font-weight: 600;
  font-size: 11.5px;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--vt-ink-3);
}
.vt-doc-table tr:last-child td { border-bottom: 0; }
.vt-doc-table code { font-size: 12px; }
.vt-doc-table-wide th:first-child,
.vt-doc-table-wide td:first-child { white-space: nowrap; }

/* ── Callouts ──────────────────────────────────────────────────────── */
.vt-callout {
  border-left: 3px solid var(--vt-blue);
  background: var(--vt-blue-tint);
  padding: 12px 16px;
  margin: 16px 0;
  border-radius: 4px;
  font-size: 14px;
  color: var(--vt-ink-2);
}
.vt-callout strong { color: var(--vt-ink); }
.vt-callout-warn {
  border-left-color: var(--vt-amber);
  background: var(--vt-amber-tint);
}

/* ── Code blocks ───────────────────────────────────────────────────── */
.vt-code {
  background: var(--vt-dark);
  border: 1px solid var(--vt-dark-line);
  border-radius: 6px;
  margin: 0 0 18px;
  overflow: hidden;
}
.vt-code-head {
  display: flex;
  justify-content: space-between;
  align-items: center;
  padding: 8px 12px;
  background: var(--vt-dark-soft);
  border-bottom: 1px solid var(--vt-dark-line);
}
.vt-code-lang {
  font-family: var(--vt-font-mono);
  font-size: 10.5px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--vt-dark-ink-2);
}
.vt-code-copy {
  font-family: var(--vt-font-sans);
  font-size: 11.5px;
  font-weight: 500;
  color: var(--vt-dark-ink-2);
  background: transparent;
  border: 1px solid var(--vt-dark-line);
  padding: 3px 10px;
  border-radius: 4px;
  cursor: pointer;
  transition: color 120ms, border-color 120ms, background 120ms;
}
.vt-code-copy:hover {
  color: var(--vt-dark-ink);
  border-color: var(--vt-dark-ink-2);
}
.vt-code-copy.is-copied {
  color: #9fd8a7;
  border-color: #3a6b44;
  background: #1d2e23;
}
.vt-code pre {
  margin: 0;
  padding: 14px 16px;
  overflow-x: auto;
  font-family: var(--vt-font-mono);
  font-size: 12.5px;
  line-height: 1.6;
  color: var(--vt-dark-ink);
}
.vt-code pre code {
  background: transparent;
  border: 0;
  padding: 0;
  color: inherit;
  font-size: inherit;
}

/* ── Known-limitations grid ────────────────────────────────────────── */
.vt-doc-known {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 12px;
  margin: 8px 0 0;
}
@media (max-width: 680px) {
  .vt-doc-known { grid-template-columns: 1fr; }
}
.vt-doc-known article {
  background: var(--vt-bg-0);
  border: 1px solid var(--vt-line);
  border-radius: 6px;
  padding: 14px 16px;
}
.vt-doc-known article h4 {
  margin: 0 0 4px;
  font-size: 13.5px;
}
.vt-doc-known article p {
  margin: 0;
  font-size: 13px;
  color: var(--vt-ink-3);
}

/* ── Layered list ──────────────────────────────────────────────────── */
.vt-doc-layers {
  list-style: none;
  padding: 0;
  counter-reset: layer;
  margin: 12px 0 14px;
}
.vt-doc-layers > li {
  counter-increment: layer;
  padding: 14px 16px 14px 52px;
  border: 1px solid var(--vt-line-soft);
  background: var(--vt-bg-0);
  border-radius: 6px;
  margin-bottom: 10px;
  position: relative;
}
.vt-doc-layers > li::before {
  content: counter(layer);
  position: absolute;
  left: 14px;
  top: 14px;
  width: 28px;
  height: 28px;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  background: var(--vt-ink);
  color: #fff;
  border-radius: 50%;
  font-family: var(--vt-font-mono);
  font-size: 12px;
  font-weight: 600;
}
.vt-doc-layers h4 { margin: 0 0 4px; }
.vt-doc-layers p { margin: 0; font-size: 13.5px; color: var(--vt-ink-3); }

/* ── Steps list ────────────────────────────────────────────────────── */
.vt-doc-steps {
  counter-reset: stepx;
  list-style: none;
  padding: 0;
  margin: 10px 0 18px;
}
.vt-doc-steps > li {
  counter-increment: stepx;
  position: relative;
  padding: 8px 0 8px 36px;
  border-bottom: 1px dashed var(--vt-line-soft);
  font-size: 14.5px;
  color: var(--vt-ink-2);
}
.vt-doc-steps > li:last-child { border-bottom: 0; }
.vt-doc-steps > li::before {
  content: counter(stepx);
  position: absolute;
  left: 0; top: 10px;
  width: 24px; height: 24px;
  border-radius: 50%;
  background: var(--vt-bg-2);
  color: var(--vt-ink);
  font-family: var(--vt-font-mono);
  font-size: 11px;
  font-weight: 600;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  border: 1px solid var(--vt-line);
}

/* ── End card ──────────────────────────────────────────────────────── */
.vt-doc-end {
  margin-top: 56px;
  padding: 20px;
  background: var(--vt-bg-0);
  border: 1px solid var(--vt-line);
  border-radius: 6px;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 18px;
  flex-wrap: wrap;
}
.vt-doc-end div { font-size: 14px; color: var(--vt-ink-2); }
.vt-doc-end strong { color: var(--vt-ink); }
.vt-doc-end code { font-size: 12px; }

.vt-muted {
  color: var(--vt-ink-4);
  font-size: 12.5px;
}