/* ==========================================================================
   KilgoreAI — API docs
   Tokens, fonts and the base reset live in tokens.css — load it first.
   ========================================================================== */

body {
  margin: 0;
  background: var(--bg);
  color: var(--text);
  font: var(--fs-body) / var(--lh-body) var(--font);
  -webkit-font-smoothing: antialiased;
  transition: background var(--dur-slow) var(--ease), color var(--dur-slow) var(--ease);
}
h1, h2, h3 { text-wrap: balance; }
p { text-wrap: pretty; }

.wrap {
  max-width: var(--doc-w);
  margin: 0 auto;
  padding: var(--sp-6) var(--sp-6) var(--sp-16);
}

/* ============ masthead ============ */
.doc-head {
  display: flex; align-items: flex-start; justify-content: space-between;
  flex-wrap: wrap; gap: var(--sp-4);
  padding-bottom: var(--sp-6);
  border-bottom: 1px solid var(--border);
}
.back-link {
  display: inline-flex; align-items: center; gap: var(--sp-1-5);
  color: var(--text-faint); text-decoration: none;
  font-size: var(--fs-xs); margin-bottom: var(--sp-3);
  transition: color var(--dur) var(--ease), gap var(--dur) var(--ease);
}
.back-link:hover { color: var(--accent-strong); gap: var(--sp-3); }
.back-link:active { transform: translateX(-1px); }
h1 {
  font-size: var(--fs-h1); line-height: var(--lh-h1); letter-spacing: var(--tr-h1);
  font-weight: var(--wt-bold); margin: 0 0 var(--sp-1);
}
h1 span { color: var(--accent); }
.sub { color: var(--text-dim); font-size: var(--fs-sm); margin: 0; max-width: var(--measure-tight); }

/* ============ head controls: language + theme ============ */
.head-tools { display: flex; align-items: center; gap: var(--sp-2); flex: none; }

.lang-switch { display: flex; gap: var(--sp-05); padding: var(--sp-1); background: var(--bg-elev); border: 1px solid var(--border); border-radius: var(--r-pill); flex: none; }
.lang-switch button {
  background: none; border: none; color: var(--text-faint);
  border-radius: var(--r-pill); padding: var(--sp-1) var(--sp-3);
  font: var(--wt-semi) var(--fs-xs) var(--font); cursor: pointer;
  transition: color var(--dur) var(--ease), background var(--dur) var(--ease);
}
.lang-switch button:hover { color: var(--text); }
.lang-switch button.active { color: var(--accent-strong); background: var(--bg-elev-2); }
.lang-switch button:active { transform: translateY(1px); }

/* Same shape as landing.css's .theme-btn so the two headers match. */
.theme-btn {
  display: inline-flex; align-items: center; justify-content: center;
  width: 30px; height: 30px; flex: none;
  background: var(--bg-elev); color: var(--text-faint);
  border: 1px solid var(--border); border-radius: var(--r-pill);
  cursor: pointer;
  transition: color var(--dur) var(--ease), background var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
.theme-btn:hover { color: var(--accent-strong); border-color: var(--accent-border); background: var(--bg-elev-2); }
.theme-btn:active { transform: translateY(1px); }

/* ============ two-column body: sticky rail + content ============ */
.doc-body {
  display: grid;
  grid-template-columns: var(--rail-w) minmax(0, 1fr);
  gap: var(--sp-12);
  align-items: start;
  padding-top: var(--sp-8);
}

.rail {
  position: sticky; top: var(--sp-6);
  display: flex; flex-direction: column; gap: 1px;
  font-size: var(--fs-xs);
}
.rail-title {
  font-size: var(--fs-label); letter-spacing: var(--tr-label);
  text-transform: uppercase; color: var(--text-faint);
  font-weight: var(--wt-semi); margin-bottom: var(--sp-2);
}
.rail a {
  color: var(--text-faint); text-decoration: none;
  padding: var(--sp-1) 0 var(--sp-1) var(--sp-3);
  border-left: 2px solid var(--border);
  transition: color var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
.rail a:hover { color: var(--text); border-left-color: var(--border-strong); }
.rail a:active { color: var(--accent-strong); }
.rail a.current,
.rail a[aria-current] { color: var(--accent-strong); border-left-color: var(--accent); }

.doc-main { min-width: 0; }
.doc-main > section { scroll-margin-top: var(--sp-6); }

h2 {
  font-size: var(--fs-h2); line-height: var(--lh-h2); letter-spacing: var(--tr-h2);
  font-weight: var(--wt-semi);
  margin: var(--sp-10) 0 var(--sp-3);
}
.doc-main > section:first-child h2 { margin-top: 0; }
h3 {
  font-size: var(--fs-h3); letter-spacing: var(--tr-h3); font-weight: var(--wt-semi);
  margin: var(--sp-6) 0 var(--sp-2);
}
p, li { color: var(--text-dim); }
p { margin: 0 0 var(--sp-3); max-width: var(--measure); }
ul, ol { margin: 0 0 var(--sp-3); padding-left: var(--sp-5); max-width: var(--measure); }
li { margin-bottom: var(--sp-1); }
a {
  color: var(--accent-strong);
  text-decoration-color: var(--accent-border);
  text-underline-offset: 2px;
  transition: color var(--dur) var(--ease), text-decoration-color var(--dur) var(--ease);
}
a:hover { color: var(--accent); text-decoration-color: var(--accent-border-strong); }
a:active { color: var(--accent-strong); }

code {
  font: var(--fs-xs) / inherit var(--mono);
  background: var(--code-inline-bg);
  border-radius: var(--r-xs); padding: 1px var(--sp-1);
  color: var(--text);
}
pre {
  position: relative;
  background: var(--code-bg);
  border-radius: var(--r-md);
  box-shadow: var(--e1);
  padding: var(--sp-4);
  overflow-x: auto;
  margin: 0 0 var(--sp-4);
  border: 1px solid var(--border);
  transition: border-color var(--dur) var(--ease);
}
pre:hover {
  border-color: var(--border-strong);
}
pre code {
  background: none; padding: 0; color: var(--text-dim);
  font-size: var(--fs-xs); line-height: var(--lh-code);
}

/* ============ copy button — this page exists to be copied from ============ */
.code-copy {
  position: absolute; top: var(--sp-2); right: var(--sp-2);
  display: inline-flex; align-items: center; justify-content: center;
  width: 28px; height: 28px;
  background: var(--bg-elev); color: var(--text-faint);
  border: 1px solid var(--border); border-radius: var(--r-sm);
  cursor: pointer; opacity: 0;
  transition: opacity var(--dur) var(--ease), color var(--dur) var(--ease),
              background var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
pre:hover .code-copy,
pre:focus-within .code-copy,
.code-copy:focus-visible { opacity: 1; }
.code-copy:hover { color: var(--text); background: var(--code-btn-hover); border-color: var(--border-strong); }
.code-copy:active { transform: translateY(1px); }
.code-copy.done { opacity: 1; color: var(--ok); border-color: var(--ok); }
/* Touch devices have no hover, so never hide it there. */
@media (pointer: coarse) {
  .code-copy { opacity: 1; width: var(--tap); height: var(--tap); }
}

/* ============ tables — hairlines, no box ============ */
table {
  width: 100%; border-collapse: collapse;
  font-size: var(--fs-sm); margin: var(--sp-3) 0 var(--sp-4);
  font-variant-numeric: tabular-nums;
}
th, td {
  text-align: left; padding: var(--sp-2-5) var(--sp-3) var(--sp-2-5) 0;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
}
th {
  color: var(--text-faint); font-size: var(--fs-label);
  text-transform: uppercase; letter-spacing: var(--tr-label);
  font-weight: var(--wt-semi);
  border-bottom-color: var(--border-strong);
}
td { color: var(--text-dim); }
tr:last-child td { border-bottom: none; }
/* Row hover — the endpoint tables are scan-lists; tracking a row across two
   columns on a wide screen was guesswork. */
tbody tr { transition: background var(--dur-fast) var(--ease); }
tbody tr:hover td { background: var(--bg-elev); }
/* Long JSON samples inside a cell used to push the table past the viewport. */
td code { overflow-wrap: anywhere; }

/* ============ verb badges — square, and readable on every theme ==========
   These used to be eight hardcoded dark-theme hexes with no light override,
   so they stayed unreadable on `paper`. */
.badge {
  display: inline-block;
  font: var(--wt-semi) var(--fs-micro) var(--mono);
  letter-spacing: var(--tr-badge);
  padding: var(--sp-05) var(--sp-1-5); border-radius: var(--r-xs);
  background: var(--bg-elev-2); border: 1px solid var(--border-strong);
  color: var(--text-dim);
  margin-right: var(--sp-1-5);
}
.badge.get { color: var(--verb-get); border-color: var(--verb-get-border); background: var(--verb-get-bg); }
.badge.post { color: var(--verb-post); border-color: var(--verb-post-border); background: var(--verb-post-bg); }
.badge.put { color: var(--verb-put); border-color: var(--verb-put-border); background: var(--verb-put-bg); }
.badge.patch { color: var(--verb-patch); border-color: var(--verb-patch-border); background: var(--verb-patch-bg); }
.badge.delete { color: var(--verb-delete); border-color: var(--verb-delete-border); background: var(--verb-delete-bg); }

.note {
  background: var(--bg-elev);
  border-left: 3px solid var(--accent);
  border-radius: 0 var(--r-sm) var(--r-sm) 0;
  padding: var(--sp-3) var(--sp-4);
  font-size: var(--fs-sm); color: var(--text-dim);
  margin: 0 0 var(--sp-3);
  max-width: var(--measure);
}
.note b { color: var(--text); }

.doc-foot {
  margin-top: var(--sp-12); padding-top: var(--sp-5);
  border-top: 1px solid var(--border);
  color: var(--text-faint); font-size: var(--fs-xs);
}
.doc-foot p { margin: 0; max-width: var(--measure); }

/* ============ responsive ============
   880px is deliberate: --doc-w (900px) plus the wrap padding, so the rail
   collapses exactly when the centred column stops growing. */
@media (max-width: 880px) {
  .doc-body { grid-template-columns: 1fr; gap: var(--sp-6); }
  .rail {
    position: static;
    flex-direction: row; flex-wrap: wrap; gap: var(--sp-1);
  }
  .rail-title { width: 100%; }
  .rail a {
    border-left: none; border: 1px solid var(--border);
    border-radius: var(--r-pill); padding: var(--sp-1) var(--sp-3);
  }
  .rail a.current,
  .rail a[aria-current] { border-color: var(--accent-border-strong); }
  .wrap { padding: var(--sp-5) var(--sp-5) var(--sp-12); }
}

@media (pointer: coarse) {
  .lang-switch button {
    display: inline-flex; align-items: center;
    min-height: var(--tap); padding: 0 var(--sp-4);
  }
  .theme-btn { width: var(--tap); height: var(--tap); }
  .rail a { display: flex; align-items: center; min-height: var(--tap); }
}
