/* docs-styles.css - layout + typography for docs.html
   Uses tokens + base reset from styles.css */

.docs-page {
  background: transparent;
  padding-block: 2rem 5rem;
  min-height: 100svh;
  min-height: 100dvh;
}

.docs-grid {
  display: grid;
  grid-template-columns: 1fr;
  gap: 3rem;
  align-items: start;
}
@media (min-width: 900px) {
  .docs-grid {
    grid-template-columns: 220px 1fr;
    gap: 4rem;
  }
}

/* ── Sidebar ───────────────────────────────────────────── */
.docs-side {
  position: relative;
  order: 2;
  padding: 1rem;
  border: 0.5px solid var(--rule);
  background: color-mix(in oklab, var(--bg) 96%, var(--ink) 4%);
}
@media (min-width: 900px) {
  .docs-side {
    order: 0;
    padding: 0;
    border: 0;
    background: transparent;
    position: sticky;
    top: 80px;
    align-self: start;
    max-height: calc(100vh - 100px);
    overflow-y: auto;
  }
}
.docs-side .t-caption {
  margin-top: 1.5rem;
  margin-bottom: 0.5rem;
}
.docs-side .t-caption:first-child { margin-top: 0; }
.docs-side ul {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  border-left: 0;
  padding-left: 0;
  margin-bottom: 0.5rem;
}
.docs-side a {
  font-family: var(--font-mono);
  font-size: 0.875rem;
  color: var(--ink-muted);
  transition: color 150ms var(--ease-out), font-weight 0ms, transform 150ms var(--ease-out);
  display: inline-flex;
  align-items: center;
  min-height: 2rem;
  padding: 0.45rem 0.7rem;
  border: 0.5px solid var(--rule);
  border-radius: 999px;
  position: relative;
  white-space: nowrap;
}
.docs-side a:hover { color: var(--accent); }
.docs-side a.is-active {
  color: var(--ink);
  font-weight: 700;
  transform: translateY(-1px);
  border-color: var(--accent);
}
.docs-side a.is-active::before {
  display: none;
}
@media (min-width: 900px) {
  .docs-side ul {
    flex-direction: column;
    flex-wrap: nowrap;
    border-left: 0.5px solid var(--rule);
    padding-left: 1rem;
  }
  .docs-side a {
    display: inline-block;
    min-height: 0;
    padding: 1px 0;
    border: 0;
    border-radius: 0;
    white-space: normal;
  }
  .docs-side a.is-active {
    transform: translateX(2px);
    border-color: transparent;
  }
  .docs-side a.is-active::before {
    content: "";
    position: absolute;
    left: -1rem;
    top: 0;
    bottom: 0;
    width: 2px;
    background: var(--accent);
    display: block;
  }
}

/* ── Reading column ────────────────────────────────────── */
.docs-body {
  order: 1;
  max-width: 72ch;
  min-width: 0;
  color: var(--ink);
}

.docs-grid > * {
  min-width: 0;
}
.docs-body .t-caption {
  margin-bottom: 0.75rem;
}
.docs-body p,
.docs-body ul,
.docs-body ol {
  margin: 0 0 1rem 0;
  color: var(--ink-muted);
  line-height: 1.65;
}
.docs-body p {
  font-family: var(--font-mono);
  font-size: 0.9375rem;
}
.docs-body strong {
  color: var(--ink);
  font-weight: 500;
}
.docs-body em { font-style: italic; }
.docs-body a {
  color: var(--ink);
  border-bottom: 0.5px solid var(--rule);
  transition: color 150ms var(--ease-out), border-color 150ms var(--ease-out);
}
.docs-body a:hover {
  color: var(--accent);
  border-bottom-color: var(--accent);
}

/* ── Headings ─────────────────────────────────────────── */
.docs-h1 {
  font-family: var(--font-display);
  font-size: clamp(2rem, 4vw, 3rem);
  line-height: 1.05;
  font-weight: 400;
  letter-spacing: 0;
  text-transform: lowercase;
  color: var(--ink);
  margin: 0 0 1rem 0;
  text-wrap: balance;
}
.docs-body h2 {
  font-family: var(--font-mono);
  font-size: 1.25rem;
  font-weight: 700;
  color: var(--ink);
  margin: 3rem 0 1rem 0;
  scroll-margin-top: 80px;
  padding-top: 1rem;
  border-top: 0.5px solid var(--rule);
}
.docs-body h3 {
  font-family: var(--font-mono);
  font-size: 1rem;
  font-weight: 700;
  color: var(--ink);
  margin: 2rem 0 0.75rem 0;
  scroll-margin-top: 80px;
}
.docs-lede {
  font-family: var(--font-mono);
  font-size: 1.0625rem !important;
  color: var(--ink-muted) !important;
  max-width: 56ch;
  margin-bottom: 1.5rem !important;
}
.docs-foot {
  font-family: var(--font-mono);
  font-size: 0.875rem;
  color: var(--ink-dim);
  margin-top: 3rem;
  padding-top: 1.5rem;
  border-top: 0.5px solid var(--rule);
}

/* ── Code blocks ──────────────────────────────────────── */
.docs-body code {
  font-family: var(--font-mono);
  font-size: 0.875em;
  color: var(--ink);
  background: color-mix(in oklab, var(--bg) 91%, var(--ink) 9%);
  backdrop-filter: blur(12px);
  -webkit-backdrop-filter: blur(12px);
  border-bottom: 0.5px solid var(--rule);
  padding: 0 0.25em;
  border-radius: 2px;
  transition: background-color 250ms var(--ease-out);
}
.docs-body pre.code {
  font-family: var(--font-mono);
  font-size: 0.8125rem;
  line-height: 1.6;
  color: var(--ink);
  background: color-mix(in oklab, var(--bg) 93%, var(--ink) 7%);
  backdrop-filter: blur(12px);
  -webkit-backdrop-filter: blur(12px);
  border: 0.5px solid var(--rule);
  padding: 1rem 1.25rem;
  margin: 0 0 1.5rem 0;
  overflow-x: auto;
  white-space: pre;
  -webkit-overflow-scrolling: touch;
  transition: background-color 250ms var(--ease-out), border-color 250ms var(--ease-out);
}
.docs-body pre.code code {
  background: transparent;
  border: none;
  padding: 0;
  color: inherit;
  font-size: inherit;
  backdrop-filter: none;
  -webkit-backdrop-filter: none;
}

/* ── Copy button on code blocks ───────────────────────── */
.code-wrap {
  position: relative;
}
.code-copy {
  position: absolute;
  top: 0.5rem;
  right: 0.5rem;
  display: inline-flex;
  align-items: center;
  gap: 0.4rem;
  padding: 0.35rem 0.6rem;
  font-family: var(--font-mono);
  font-size: 0.6875rem;
  font-weight: 500;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--ink-dim);
  background: var(--bg);
  border: 0.5px solid var(--rule);
  cursor: pointer;
  opacity: 0;
  transition: opacity 150ms var(--ease-out), color 150ms var(--ease-out), border-color 150ms var(--ease-out);
}
.code-wrap:hover .code-copy,
.code-copy:focus-visible {
  opacity: 1;
}
.code-copy:hover {
  color: var(--ink);
  border-color: var(--ink);
}
.code-copy.is-copied {
  opacity: 1;
  color: var(--accent);
  border-color: var(--accent);
}
.code-copy.is-failed {
  opacity: 1;
  color: var(--signal-neg);
  border-color: var(--signal-neg);
}
.code-copy svg {
  display: block;
}

/* ── Lists ────────────────────────────────────────────── */
.docs-list {
  padding-left: 1.5rem;
}
.docs-list li {
  list-style: disc;
  margin-bottom: 0.5rem;
  font-family: var(--font-mono);
  font-size: 0.9375rem;
  color: var(--ink-muted);
}
ol.docs-list li { list-style: decimal; }
.docs-list li strong { color: var(--ink); }

/* ── Inline mini-table (used for provider, cost, etc.) ── */
.provider-table {
  margin: 1.5rem 0;
  border: 0.5px solid var(--rule);
  background: color-mix(in oklab, var(--bg) 95%, var(--ink) 5%);
  backdrop-filter: blur(10px);
  -webkit-backdrop-filter: blur(10px);
  padding: 0.5rem 1.25rem;
  border-radius: 3px;
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;
  transition: background-color 250ms var(--ease-out), border-color 250ms var(--ease-out);
}
.provider-table .row {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 1rem;
  padding: 0.5rem 0;
  min-width: 34rem;
  font-family: var(--font-mono);
  font-size: 0.875rem;
  color: var(--ink-muted);
}
.provider-table .row:not(:last-child) {
  border-bottom: 0.5px solid var(--rule);
}
.provider-table .row:not(.hd) > span:first-child {
  color: var(--ink);
}
.provider-table .row.hd {
  font-size: 0.7rem;
  letter-spacing: 0.18em;
  text-transform: uppercase;
  font-weight: 700;
  color: var(--ink-dim);
  border-bottom: 0.5px solid var(--rule);
}
.provider-table .row:has(> span:nth-child(3)) {
  grid-template-columns: 1.2fr 1fr 1fr;
}
.privacy-table .row {
  grid-template-columns: 1.1fr 2fr 0.5fr;
  min-width: 40rem;
}
.privacy-table .row span:nth-child(2) {
  font-family: var(--font-mono);
  font-size: 0.8125rem;
}
.privacy-table .row span:nth-child(3) {
  font-family: var(--font-mono);
  text-align: right;
  letter-spacing: 0.05em;
}

/* ── Spec badges ──────────────────────────────────────── */
.spec-badges {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem 0.75rem;
  align-items: center;
  font-family: var(--font-mono);
  font-size: 0.75rem;
  font-weight: 500;
  letter-spacing: 0.18em;
  text-transform: uppercase;
  color: var(--ink-dim);
  margin: 0 0 1.5rem 0;
  padding-bottom: 1rem;
  border-bottom: 0.5px solid var(--rule);
}
.spec-badges a {
  color: var(--ink-dim);
  border-bottom: none;
}
.spec-badges a:hover { color: var(--accent); }

/* ── Section divider ──────────────────────────────────── */
.divider-major {
  margin: 5rem 0;
  border-block-start: 2px dashed var(--rule);
  height: 0;
}

/* Footer sits naturally below */
.footer { background: var(--bg-dark); border-top: 0.5px solid var(--rule-on-dark); }

@media (max-width: 640px) {
  .docs-page {
    padding-block: 1.5rem 4rem;
  }
  .docs-grid {
    gap: 2rem;
  }
  .docs-h1 {
    font-size: clamp(1.75rem, 10vw, 2.4rem);
  }
  .docs-body h2 {
    margin-top: 2.5rem;
  }
  .docs-body pre.code,
  .provider-table {
    margin-inline: calc(var(--page-gutter) * -0.25);
  }
}

@media (hover: none), (pointer: coarse) {
  .code-copy {
    opacity: 1;
  }
}