/* ==========================================================================
   Credit Pull Engine — Developer Documentation
   docs.css — three-column Stripe-style layout, light/dark themes
   ========================================================================== */

/* ---- Design tokens ------------------------------------------------------- */
:root {
  --accent:        #038edc;
  --accent-strong: #0670a8;
  --accent-soft:   rgba(3, 142, 220, 0.10);

  --bg:        #ffffff;
  --bg-subtle: #f7f8fa;
  --bg-inset:  #eef1f5;
  --text:      #1a2332;
  --text-mid:  #445063;
  --text-dim:  #6b7688;
  --border:    #e5e8ee;
  --border-strong: #d4d9e2;

  --topbar-h: 60px;
  --side-w:   288px;
  --panel-w:  480px;
  --content-max: 760px;

  --radius:   8px;
  --radius-sm: 6px;
  --shadow:   0 1px 2px rgba(16, 24, 40, 0.06), 0 4px 16px rgba(16, 24, 40, 0.06);

  --font: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial,
          sans-serif;
  --mono: "SF Mono", "JetBrains Mono", "Fira Code", ui-monospace, Menlo, Consolas,
          monospace;

  /* Code surfaces stay dark in both themes (Stripe-style) */
  --code-bg:    #0c1322;
  --code-bg-2:  #131c30;
  --code-text:  #c9d4e3;
  --code-border:#1f2a40;

  /* Syntax tokens (tuned for dark code surface) */
  --tok-comment: #5b6b86;
  --tok-string:  #7ee0a8;
  --tok-number:  #f0b866;
  --tok-keyword: #6cb6ff;
  --tok-key:     #8fd0ff;
  --tok-punct:   #8893a7;
  --tok-flag:    #f0b866;
  --tok-cmd:     #d9a6ff;
  --tok-var:     #f59fb6;
}

:root[data-theme="dark"] {
  --accent:        #4cb3f0;
  --accent-strong: #7cc8f5;
  --accent-soft:   rgba(76, 179, 240, 0.14);

  --bg:        #0d1117;
  --bg-subtle: #11161e;
  --bg-inset:  #1a212c;
  --text:      #e6edf3;
  --text-mid:  #b3bdca;
  --text-dim:  #8b95a3;
  --border:    #232b37;
  --border-strong: #313b49;

  --shadow:   0 1px 2px rgba(0, 0, 0, 0.4), 0 4px 16px rgba(0, 0, 0, 0.4);
}

/* ---- Reset -------------------------------------------------------------- */
* { box-sizing: border-box; margin: 0; padding: 0; }
html { scroll-behavior: smooth; scroll-padding-top: calc(var(--topbar-h) + 16px); }

body {
  font-family: var(--font);
  background: var(--bg);
  color: var(--text);
  line-height: 1.65;
  font-size: 15.5px;
  -webkit-font-smoothing: antialiased;
}

a { color: var(--accent-strong); text-decoration: none; }
a:hover { text-decoration: underline; }

/* ---- Topbar ------------------------------------------------------------- */
.topbar {
  position: fixed;
  top: 0; left: 0; right: 0;
  height: var(--topbar-h);
  display: flex;
  align-items: center;
  gap: 16px;
  padding: 0 20px;
  background: color-mix(in srgb, var(--bg) 88%, transparent);
  backdrop-filter: saturate(180%) blur(10px);
  border-bottom: 1px solid var(--border);
  z-index: 100;
}

.topbar .brand {
  display: flex;
  align-items: center;
  gap: 10px;
  flex-shrink: 0;
}
.topbar .brand img { height: 26px; display: block; color: var(--accent); }
.topbar .brand .brand-text { font-weight: 700; font-size: 16px; color: var(--text); letter-spacing: -0.01em; }
.topbar .brand .brand-tag {
  font-size: 11px; font-weight: 600; text-transform: uppercase;
  letter-spacing: 0.06em; color: var(--text-dim);
  border-left: 1px solid var(--border-strong); padding-left: 10px;
}

/* Top page navigation (Stripe / Spinwheel style) */
.topnav {
  display: flex;
  align-items: center;
  gap: 2px;
  margin-left: 8px;
}
.topnav-link {
  display: inline-block;
  padding: 7px 12px;
  font-size: 14px;
  font-weight: 550;
  color: var(--text-mid);
  border-radius: var(--radius-sm);
  white-space: nowrap;
}
.topnav-link:hover { color: var(--text); background: var(--bg-subtle); text-decoration: none; }
.topnav-link.active { color: var(--accent-strong); background: var(--accent-soft); font-weight: 650; }

.topbar .spacer { flex: 1; }

/* Mobile-only page switcher inside the sidebar drawer */
.nav-pages { display: none; }
.nav-page {
  display: block;
  padding: 8px 12px;
  font-size: 14px;
  font-weight: 600;
  color: var(--text-mid);
  border-radius: var(--radius-sm);
}
.nav-page:hover { color: var(--text); background: var(--bg-subtle); text-decoration: none; }
.nav-page.active { color: var(--accent-strong); background: var(--accent-soft); }

/* Search */
.searchbox { position: relative; width: 300px; max-width: 36vw; }
.searchbox input {
  width: 100%;
  height: 36px;
  padding: 0 12px 0 34px;
  font-family: var(--font);
  font-size: 14px;
  color: var(--text);
  background: var(--bg-subtle);
  border: 1px solid var(--border);
  border-radius: var(--radius-sm);
  outline: none;
}
.searchbox input:focus { border-color: var(--accent); box-shadow: 0 0 0 3px var(--accent-soft); }
.searchbox .s-icon {
  position: absolute; left: 10px; top: 50%; transform: translateY(-50%);
  width: 15px; height: 15px; opacity: 0.5; pointer-events: none;
}
.search-results {
  position: absolute;
  top: 44px; left: 0; right: 0;
  background: var(--bg);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  box-shadow: var(--shadow);
  max-height: 60vh; overflow-y: auto;
  padding: 6px;
  display: none;
}
.search-results.open { display: block; }
.search-results a {
  display: block;
  padding: 8px 10px;
  border-radius: var(--radius-sm);
  color: var(--text);
  font-size: 14px;
}
.search-results a:hover, .search-results a.active {
  background: var(--accent-soft); text-decoration: none;
}
.search-results a .sr-parent { color: var(--text-dim); font-size: 12px; }
.search-results .sr-empty { padding: 10px; color: var(--text-dim); font-size: 14px; }

/* Icon buttons */
.icon-btn {
  display: inline-flex; align-items: center; justify-content: center;
  width: 36px; height: 36px;
  background: var(--bg-subtle);
  border: 1px solid var(--border);
  border-radius: var(--radius-sm);
  color: var(--text-mid);
  cursor: pointer;
  flex-shrink: 0;
}
.icon-btn:hover { color: var(--text); border-color: var(--border-strong); }
.icon-btn svg { width: 17px; height: 17px; }
.theme-toggle .moon { display: none; }
:root[data-theme="dark"] .theme-toggle .sun  { display: none; }
:root[data-theme="dark"] .theme-toggle .moon { display: block; }

.hamburger { display: none; }

/* ---- Layout grid -------------------------------------------------------- */
.layout {
  display: grid;
  grid-template-columns: var(--side-w) minmax(0, 1fr) var(--panel-w);
  max-width: 1680px;
  margin: 0 auto;
}

/* ---- Sidebar ------------------------------------------------------------ */
.sidebar {
  position: sticky;
  top: var(--topbar-h);
  align-self: start;
  height: calc(100vh - var(--topbar-h));
  overflow-y: auto;
  padding: 26px 16px 60px;
  border-right: 1px solid var(--border);
}

.nav-group { margin-bottom: 22px; }
.nav-group-title {
  display: block;
  font-size: 12px;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.07em;
  color: var(--text-dim);
  padding: 6px 12px;
  border-radius: var(--radius-sm);
}
.nav-group-title:hover { text-decoration: none; color: var(--text-mid); }
.nav-group.is-current .nav-group-title { color: var(--accent-strong); }

.nav-group ul { list-style: none; margin-top: 2px; }
.nav-link {
  display: block;
  padding: 6px 12px;
  margin: 1px 0;
  font-size: 14px;
  color: var(--text-mid);
  border-radius: var(--radius-sm);
  border-left: 2px solid transparent;
}
.nav-link:hover { color: var(--text); background: var(--bg-subtle); text-decoration: none; }
.nav-link.active {
  color: var(--accent-strong);
  background: var(--accent-soft);
  font-weight: 600;
}

/* ---- Main content ------------------------------------------------------- */
.content {
  min-width: 0;
  padding: 44px 60px 120px;
}
.content-inner { max-width: var(--content-max); margin: 0 auto; }

.eyebrow {
  font-size: 12.5px; font-weight: 700; text-transform: uppercase;
  letter-spacing: 0.08em; color: var(--accent-strong); margin-bottom: 10px;
}

.content h1 {
  font-size: 33px; font-weight: 800; letter-spacing: -0.02em;
  line-height: 1.2; margin-bottom: 12px;
}
.lead { font-size: 17.5px; color: var(--text-mid); margin-bottom: 8px; }

.content section { padding-top: 30px; margin-top: 14px; }
.content section + section { border-top: 1px solid var(--border); }

.content h2 {
  font-size: 23px; font-weight: 700; letter-spacing: -0.015em;
  margin-bottom: 10px; scroll-margin-top: calc(var(--topbar-h) + 16px);
}
.content h3 {
  font-size: 17px; font-weight: 700; margin: 26px 0 8px;
  scroll-margin-top: calc(var(--topbar-h) + 16px);
}
.content h4 { font-size: 14px; font-weight: 700; margin: 20px 0 6px; color: var(--text-mid); }

.content p { margin: 12px 0; color: var(--text-mid); }
.content section > p:first-of-type { color: var(--text-mid); }
.content strong { color: var(--text); font-weight: 650; }
.content ul, .content ol { margin: 12px 0 12px 22px; color: var(--text-mid); }
.content li { margin: 5px 0; }
.content li::marker { color: var(--text-dim); }

/* Anchor links on headings */
.anchor {
  opacity: 0; margin-left: 8px; font-weight: 400;
  color: var(--text-dim); text-decoration: none; font-size: 0.8em;
}
h2:hover .anchor, h3:hover .anchor { opacity: 1; }
.anchor:hover { color: var(--accent); }

/* Inline code */
:not(pre) > code {
  font-family: var(--mono);
  font-size: 0.86em;
  background: var(--bg-inset);
  color: var(--text);
  padding: 0.12em 0.4em;
  border-radius: 4px;
  border: 1px solid var(--border);
  white-space: nowrap;
}

/* Tables */
.table-wrap { overflow-x: auto; margin: 16px 0; border: 1px solid var(--border); border-radius: var(--radius); }
table { width: 100%; border-collapse: collapse; font-size: 14px; }
thead th {
  text-align: left; font-weight: 700; color: var(--text);
  background: var(--bg-subtle);
  padding: 10px 14px; border-bottom: 1px solid var(--border);
  white-space: nowrap;
}
tbody td { padding: 10px 14px; border-bottom: 1px solid var(--border); color: var(--text-mid); vertical-align: top; }
tbody tr:last-child td { border-bottom: none; }
table code { white-space: nowrap; }

/* Pills */
.pill {
  display: inline-block; font-size: 11px; font-weight: 700;
  padding: 1px 7px; border-radius: 20px; letter-spacing: 0.02em;
  vertical-align: middle;
}
.pill-req   { background: rgba(243,78,78,0.13);  color: #d8423b; }
.pill-opt   { background: var(--bg-inset);       color: var(--text-dim); }
.pill-get   { background: rgba(81,210,140,0.16); color: #1f9d5e; }
.pill-post  { background: rgba(3,142,220,0.14);  color: var(--accent-strong); }
.pill-new   { background: var(--accent-soft);    color: var(--accent-strong); }
:root[data-theme="dark"] .pill-req { color: #ff8a84; }
:root[data-theme="dark"] .pill-get { color: #6fe0a6; }

/* Method line */
.endpoint {
  display: flex; align-items: center; gap: 10px;
  font-family: var(--mono); font-size: 14px;
  background: var(--bg-subtle); border: 1px solid var(--border);
  border-radius: var(--radius-sm); padding: 9px 12px; margin: 14px 0;
}
.endpoint .method { font-weight: 700; }
.endpoint .path { color: var(--text); }

/* Callouts */
.callout {
  display: flex; gap: 12px;
  border: 1px solid var(--border);
  border-left-width: 3px;
  border-radius: var(--radius-sm);
  padding: 13px 16px; margin: 18px 0;
  background: var(--bg-subtle);
  font-size: 14.5px;
}
.callout p { margin: 4px 0; color: var(--text-mid); }
.callout p:first-child { margin-top: 0; }
.callout p:last-child { margin-bottom: 0; }
.callout .c-ico { flex-shrink: 0; font-size: 16px; line-height: 1.5; }
.callout-note { border-left-color: var(--accent); }
.callout-warn { border-left-color: #e0a23a; background: rgba(224,162,58,0.07); }
.callout-tip  { border-left-color: #51d28c; background: rgba(81,210,140,0.07); }

/* Code blocks (prose + panel share the dark surface) */
.code {
  background: var(--code-bg);
  border: 1px solid var(--code-border);
  border-radius: var(--radius);
  overflow: hidden;
  margin: 16px 0;
}
.code-head {
  display: flex; align-items: center; justify-content: space-between;
  padding: 8px 12px;
  background: var(--code-bg-2);
  border-bottom: 1px solid var(--code-border);
}
.code-label {
  font-size: 11.5px; font-weight: 700; text-transform: uppercase;
  letter-spacing: 0.06em; color: #7c89a3;
}
.code pre {
  margin: 0; padding: 14px 16px;
  overflow-x: auto;
  font-family: var(--mono);
  font-size: 13px;
  line-height: 1.65;
  color: var(--code-text);
}
.code pre code { font-family: inherit; background: none; border: none; padding: 0; white-space: pre; }

.copy-btn {
  display: inline-flex; align-items: center; gap: 5px;
  background: transparent;
  border: 1px solid var(--code-border);
  color: #8b97ad;
  font-size: 11.5px; font-weight: 600;
  font-family: var(--font);
  padding: 3px 8px; border-radius: 5px; cursor: pointer;
}
.copy-btn:hover { color: #cdd6e4; border-color: #3a4660; }
.copy-btn.copied { color: #7ee0a8; border-color: #2d5a42; }
.copy-btn svg { width: 12px; height: 12px; }

/* Syntax tokens */
.tok-comment { color: var(--tok-comment); font-style: italic; }
.tok-string  { color: var(--tok-string); }
.tok-number  { color: var(--tok-number); }
.tok-keyword { color: var(--tok-keyword); }
.tok-key     { color: var(--tok-key); }
.tok-punct   { color: var(--tok-punct); }
.tok-flag    { color: var(--tok-flag); }
.tok-cmd     { color: var(--tok-cmd); font-weight: 600; }
.tok-var     { color: var(--tok-var); }

/* ---- Right code panel --------------------------------------------------- */
.codepanel {
  position: sticky;
  top: var(--topbar-h);
  align-self: start;
  height: calc(100vh - var(--topbar-h));
  overflow-y: auto;
  border-left: 1px solid var(--border);
  background: var(--bg-subtle);
  padding: 24px 22px 60px;
}
.codepanel .cp-section { margin-bottom: 18px; }
.codepanel .cp-title {
  font-size: 12px; font-weight: 700; text-transform: uppercase;
  letter-spacing: 0.07em; color: var(--text-dim); margin-bottom: 8px;
}
.codepanel .code { margin: 0 0 14px; }
.cp-empty { color: var(--text-dim); font-size: 14px; padding: 8px 0; }

/* Inline samples (shown only when the side panel is hidden) */
.inline-sample { display: none; }
.inline-sample .cp-title {
  font-size: 12px; font-weight: 700; text-transform: uppercase;
  letter-spacing: 0.07em; color: var(--text-dim); margin: 18px 0 6px;
}

/* ---- Footer nav (prev / next) ------------------------------------------ */
.pagenav {
  display: flex; justify-content: space-between; gap: 16px;
  margin-top: 48px; padding-top: 24px;
  border-top: 1px solid var(--border);
}
.pagenav a {
  flex: 1; max-width: 49%;
  border: 1px solid var(--border); border-radius: var(--radius);
  padding: 12px 16px; color: var(--text);
}
.pagenav a:hover { border-color: var(--accent); text-decoration: none; }
.pagenav a.next { text-align: right; }
.pagenav .pn-label { font-size: 12px; color: var(--text-dim); }
.pagenav .pn-title { font-weight: 650; color: var(--accent-strong); }

/* ---- Mobile scrim ------------------------------------------------------- */
.scrim {
  display: none;
  position: fixed; inset: var(--topbar-h) 0 0 0;
  background: rgba(10, 15, 25, 0.45);
  z-index: 80;
}
body.nav-open .scrim { display: block; }

/* ---- Responsive --------------------------------------------------------- */
@media (max-width: 1240px) {
  .layout { grid-template-columns: var(--side-w) minmax(0, 1fr); }
  .codepanel { display: none; }
  .inline-sample { display: block; }
  .content { padding: 40px 48px 110px; }
  :root { --content-max: 820px; }
}

/* Top page-nav folds into the sidebar drawer on narrower screens */
@media (max-width: 1080px) {
  .topnav { display: none; }
  .nav-pages {
    display: block;
    margin-bottom: 20px;
    padding-bottom: 16px;
    border-bottom: 1px solid var(--border);
  }
}

@media (max-width: 900px) {
  :root { --side-w: 280px; }
  .hamburger { display: inline-flex; }
  .layout { grid-template-columns: minmax(0, 1fr); }
  .sidebar {
    position: fixed;
    top: var(--topbar-h); bottom: 0; left: 0;
    width: var(--side-w); height: auto;
    background: var(--bg);
    transform: translateX(-100%);
    transition: transform 0.22s ease;
    z-index: 90;
  }
  body.nav-open .sidebar { transform: translateX(0); box-shadow: var(--shadow); }
  .content { padding: 32px 22px 100px; }
  .searchbox { width: 180px; }
  .topbar .brand .brand-tag { display: none; }
}

@media (max-width: 560px) {
  body { font-size: 15px; }
  .content h1 { font-size: 27px; }
  .content h2 { font-size: 20px; }
  .searchbox { display: none; }
  .pagenav { flex-direction: column; }
  .pagenav a, .pagenav a.next { max-width: 100%; text-align: left; }
}

/* Reduced motion */
@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
  .sidebar { transition: none; }
}