/* ============================================================================
   SKILLGATE · docs.css  —  API documentation page
   Composes tokens.css + base.css. No new colors; tokens only.
   ============================================================================ */

/* nav: logged-in identity chip (email/name → /app), truncates gracefully -----
   Mirrors landing.css so the top bar reads identically on docs and the landing. */
.nav-user { max-width: 200px; overflow: hidden; text-overflow: ellipsis;
  white-space: nowrap; }

/* ---- Doc shell: sticky sidebar + centered content ------------------------- */
.doc-shell {
  display: grid;
  grid-template-columns: var(--sidebar-w) minmax(0, 1fr);
  gap: var(--s-9);
  padding-top: calc(var(--nav-h) + var(--s-8));
  padding-bottom: var(--s-11);
  align-items: start;
}

/* ---- Sidebar -------------------------------------------------------------- */
.doc-sidebar {
  position: sticky;
  top: calc(var(--nav-h) + var(--s-5));
  align-self: start;
  max-height: calc(100vh - var(--nav-h) - var(--s-7));
  overflow-y: auto;
  overscroll-behavior: contain;
}
.doc-side-inner { display: flex; flex-direction: column; gap: var(--s-5); padding-right: var(--s-2); }
.doc-side-head { display: flex; align-items: center; justify-content: space-between; gap: var(--s-3); }
.doc-side-ver { font-size: var(--fs-xs); }

.doc-nav { display: flex; flex-direction: column; gap: 2px; }
.doc-nav-link {
  display: flex; align-items: center; gap: var(--s-2);
  padding: 8px 12px; border-radius: var(--r-sm);
  font-size: var(--fs-sm); color: var(--text-2);
  border-left: 2px solid transparent;
  transition: color var(--t-fast) var(--ease), background var(--t-fast) var(--ease),
              border-color var(--t-fast) var(--ease);
}
.doc-nav-link .icon { color: var(--text-muted); transition: color var(--t-fast) var(--ease); }
.doc-nav-link:hover { color: var(--text); background: rgba(255,255,255,0.04); }
.doc-nav-link:hover .icon { color: var(--copper-hi); }
.doc-nav-link.is-active {
  color: var(--text); background: rgba(200,133,90,0.10);
  border-left-color: var(--copper); font-weight: 600;
}
.doc-nav-link.is-active .icon { color: var(--copper-hi); }

.doc-nav-sub {
  display: flex; flex-direction: column; gap: 1px;
  margin: 2px 0 4px; padding-left: var(--s-4);
  border-left: 1px solid var(--line-soft); margin-left: var(--s-4);
}
.doc-nav-link.is-sub {
  font-family: var(--font-mono); font-size: var(--fs-xs);
  padding: 6px 10px; gap: var(--s-2); border-left-width: 0;
}
.doc-nav-link.is-sub.is-active { background: rgba(200,133,90,0.08); border-radius: var(--r-xs); }
.mp { /* mini method tag in sidebar */
  font-size: 9px; font-weight: 700; letter-spacing: 0.06em;
  padding: 1px 5px; border-radius: 4px; line-height: 1.4; flex: none;
}
.mp-get  { color: var(--ok);     background: var(--ok-soft); }
.mp-post { color: var(--copper-hi); background: rgba(200,133,90,0.14); }

.doc-side-foot { padding-top: var(--s-3); border-top: 1px solid var(--line-soft); }

/* ---- Content -------------------------------------------------------------- */
.doc-content { min-width: 0; max-width: 820px; }
.doc-section { padding-block: var(--s-9) var(--s-7); scroll-margin-top: calc(var(--nav-h) + var(--s-5)); }
.doc-section:first-child { padding-top: 0; }
.doc-section + .doc-section { border-top: 1px solid var(--line-soft); }

.doc-h1 { font-size: var(--fs-3xl); margin-top: var(--s-3); }
.doc-intro { margin-top: var(--s-4); max-width: 64ch; }
.doc-h2 { margin-bottom: var(--s-2); }
.doc-sub { color: var(--text-2); margin-bottom: var(--s-6); max-width: 64ch; }

.copper-ico { color: var(--copper-hi); }
.code-inline {
  font-family: var(--font-mono); font-size: 0.92em;
  padding: 2px 6px; border-radius: var(--r-xs);
  background: var(--surface-2); border: 1px solid var(--line);
  color: var(--text); white-space: nowrap;
}
.link { color: var(--copper-hi); border-bottom: 1px solid var(--line-copper); transition: color var(--t-fast) var(--ease); }
.link:hover { color: var(--amber); }

/* ---- Base URL cards ------------------------------------------------------- */
.doc-base-grid { grid-template-columns: 1fr 1fr; margin-top: var(--s-6); gap: var(--s-4); }
.doc-kv-head { margin-bottom: var(--s-3); }
.doc-url {
  display: block; font-size: var(--fs-base); color: var(--copper-hi);
  word-break: break-all; line-height: 1.4;
}
.doc-note-sm { font-size: var(--fs-xs); margin-top: var(--s-2); }

/* ---- Download panel (stands out, copper) ---------------------------------- */
.download-panel {
  display: flex; gap: var(--s-6); align-items: flex-start;
  margin-top: var(--s-7); padding: var(--s-7);
  position: relative; overflow: hidden;
}
.download-panel::before {
  content: ""; position: absolute; inset: 0; pointer-events: none;
  background: radial-gradient(420px 200px at 100% -20%, rgba(224,168,106,0.12), transparent 60%);
}
.dl-glyph {
  flex: none; width: 56px; height: 56px; border-radius: var(--r-md);
  display: grid; place-items: center; color: var(--copper-hi);
  background: rgba(200,133,90,0.12); border: 1px solid var(--line-copper);
  box-shadow: inset 0 1px 0 rgba(255,255,255,0.06);
}
.dl-copy { position: relative; min-width: 0; }
.dl-copy h2 { margin-bottom: var(--s-2); }

/* ---- Quickstart steps ----------------------------------------------------- */
.steps { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: var(--s-6); }
.step { display: grid; grid-template-columns: 40px 1fr; gap: var(--s-4); align-items: start; }
.step-n {
  width: 36px; height: 36px; border-radius: var(--r-pill);
  display: grid; place-items: center; flex: none;
  font-family: var(--font-mono); font-weight: 700; font-size: var(--fs-md);
  color: var(--copper-hi); background: var(--surface-2);
  border: 1px solid var(--line-copper); box-shadow: var(--sh-inset);
}
.step-body { min-width: 0; }
.step-title { font-size: var(--fs-md); margin-bottom: var(--s-2); }
.step-body .code { margin-top: var(--s-3); }

/* ---- Auth grid ------------------------------------------------------------ */
.auth-grid { grid-template-columns: 1fr 1fr; gap: var(--s-4); }

/* ---- Callouts ------------------------------------------------------------- */
.callout {
  display: flex; gap: var(--s-3); align-items: flex-start;
  margin-top: var(--s-5); padding: var(--s-4) var(--s-5);
  border-radius: var(--r-md); background: var(--surface-1);
  border: 1px solid var(--line); border-left: 2px solid var(--line-strong);
}
.callout .icon { color: var(--text-muted); margin-top: 2px; flex: none; }
.callout p { color: var(--text-2); font-size: var(--fs-sm); }
.callout-warn { border-left-color: var(--warn); background: var(--warn-soft); }
.callout-warn .icon { color: var(--warn); }

/* ---- Endpoint blocks ------------------------------------------------------ */
.endpoint {
  margin-top: var(--s-6); padding: var(--s-6);
  border-radius: var(--r-md); background: var(--surface-1);
  border: 1px solid var(--line); box-shadow: var(--sh-1);
  scroll-margin-top: calc(var(--nav-h) + var(--s-5));
}
.ep-head { display: flex; align-items: center; gap: var(--s-3); flex-wrap: wrap; }
.ep-path { font-size: var(--fs-md); color: var(--text); word-break: break-all; }
.ep-var { color: var(--copper-hi); }
.ep-desc { margin-top: var(--s-3); max-width: 62ch; }
.ep-label {
  font-size: var(--fs-xs); text-transform: uppercase; letter-spacing: var(--tracking-wide);
  color: var(--text-muted); font-weight: 600; margin: var(--s-5) 0 var(--s-2);
}
.ep-label .resp-200 { color: var(--ok); letter-spacing: normal; }

/* method pills (GET/POST) */
.method-pill {
  font-family: var(--font-mono); font-size: var(--fs-xs); font-weight: 700;
  letter-spacing: 0.06em; padding: 4px 10px; border-radius: var(--r-sm);
  border: 1px solid transparent; flex: none;
}
.mp-get  { color: var(--ok);        background: var(--ok-soft);            border-color: rgba(127,168,139,0.3); }
.mp-post { color: var(--copper-hi); background: rgba(200,133,90,0.14);     border-color: var(--line-copper); }

/* ---- Tables --------------------------------------------------------------- */
.table-wrap { overflow-x: auto; border: 1px solid var(--line); border-radius: var(--r-md); background: var(--bg-2); }
.doc-table { width: 100%; border-collapse: collapse; font-size: var(--fs-sm); min-width: 460px; }
.doc-table th {
  text-align: left; font-size: var(--fs-xs); font-weight: 600;
  text-transform: uppercase; letter-spacing: 0.04em; color: var(--text-muted);
  padding: 10px 14px; border-bottom: 1px solid var(--line); background: var(--surface-1);
}
.doc-table td { padding: 11px 14px; border-bottom: 1px solid var(--line-soft); color: var(--text-2); vertical-align: top; }
.doc-table tr:last-child td { border-bottom: 0; }
.doc-table td code { color: var(--copper-hi); }
.doc-table td .mono { font-family: var(--font-mono); }

/* status pills in tables */
.status-pill {
  display: inline-flex; align-items: center; justify-content: center;
  font-family: var(--font-mono); font-weight: 700; font-size: var(--fs-xs);
  min-width: 42px; padding: 2px 8px; border-radius: var(--r-xs); border: 1px solid var(--line);
}
.s-ok   { color: var(--ok);     background: var(--ok-soft);     border-color: rgba(127,168,139,0.3); }
.s-warn { color: var(--warn);   background: var(--warn-soft);   border-color: rgba(217,168,92,0.3); }
.s-bad  { color: var(--danger); background: var(--danger-soft); border-color: rgba(196,106,94,0.3); }

/* ---- Code copy button ----------------------------------------------------- */
.code { margin-top: var(--s-2); }
.code[data-copy] .code-head { gap: var(--s-3); }
.copy-btn {
  display: inline-flex; align-items: center; gap: 6px;
  height: 26px; padding: 0 10px; border-radius: var(--r-xs);
  background: rgba(255,255,255,0.03); border: 1px solid var(--line);
  color: var(--text-2); font-size: var(--fs-xs); font-weight: 600; font-family: var(--font-sans);
  transition: color var(--t-fast) var(--ease), background var(--t-fast) var(--ease),
              border-color var(--t-fast) var(--ease);
}
.copy-btn .icon { color: var(--text-muted); transition: color var(--t-fast) var(--ease); }
.copy-btn:hover { color: var(--text); background: rgba(255,255,255,0.07); border-color: var(--line-strong); }
.copy-btn:hover .icon { color: var(--copper-hi); }
.copy-btn.is-done { color: var(--ok); border-color: rgba(127,168,139,0.4); }
.copy-btn.is-done .icon { color: var(--ok); }

/* ---- Tabs (code samples) -------------------------------------------------- */
.tabs { margin-top: var(--s-2); }
.tabs-bar {
  display: inline-flex; gap: 4px; padding: 4px;
  border-radius: var(--r-pill); background: var(--surface-1);
  border: 1px solid var(--line); margin-bottom: var(--s-4);
}
.tab {
  height: 32px; padding-inline: 16px; border-radius: var(--r-pill);
  border: 0; background: transparent; color: var(--text-2);
  font-size: var(--fs-sm); font-weight: 600;
  transition: color var(--t-fast) var(--ease), background var(--t-fast) var(--ease);
}
.tab:hover { color: var(--text); }
.tab.is-active { background: var(--surface-3); color: var(--text); box-shadow: var(--sh-inset); }
.tab-panel { display: none; }
.tab-panel.is-active { display: block; }

/* ---- Trust scoring -------------------------------------------------------- */
.trust-grid { grid-template-columns: 1fr 1fr; gap: var(--s-5); margin-top: var(--s-6); align-items: start; }
.trust-card-title { font-size: var(--fs-lg); margin-bottom: var(--s-5); }

.weights { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: var(--s-5); }
.weight-head { display: flex; align-items: baseline; justify-content: space-between; }
.wt-name { font-weight: 600; color: var(--text); }
.wt-pct { color: var(--copper-hi); font-weight: 700; }
.wt-desc { font-size: var(--fs-xs); margin: 4px 0 8px; }

.verdicts { display: flex; flex-direction: column; gap: var(--s-5); }
.verdict-row { display: flex; gap: var(--s-4); align-items: center; }
.verdict-desc { font-size: var(--fs-sm); margin-top: var(--s-2); max-width: 40ch; }
.score-ring .ring-num { font-size: 18px; }

/* ---- Footer overrides (verbatim markup needs token sizing) ---------------- */
.footer-grid { grid-template-columns: 1.6fr 1fr 1fr 1fr; gap: var(--s-8); }
.footer-tag { max-width: 280px; }
.footer-bottom { border-top: 1px solid var(--line); padding-top: 24px; }
.footer-fine { font-size: 13px; }

/* ---- Mobile sidebar toggle (hidden on desktop) ---------------------------- */
.doc-menu-btn { display: none; }
.doc-scrim {
  position: fixed; inset: 0; z-index: calc(var(--z-nav) - 1);
  background: rgba(3,3,4,0.6); backdrop-filter: blur(4px);
}

/* ============================================================================
   Responsive
   ============================================================================ */
@media (max-width: 1080px) {
  .doc-shell { grid-template-columns: 210px minmax(0,1fr); gap: var(--s-7); }
}

@media (max-width: 880px) {
  /* collapse sidebar into an off-canvas drawer */
  .doc-shell { grid-template-columns: minmax(0, 1fr); gap: 0; padding-top: calc(var(--nav-h) + var(--s-6)); }
  .doc-content { max-width: 100%; }

  .doc-menu-btn {
    display: inline-flex; align-items: center; gap: 8px;
    position: fixed; top: calc(var(--nav-h) + 10px); left: var(--s-5); z-index: var(--z-pop);
    height: 38px; padding: 0 14px; border-radius: var(--r-pill);
    background: var(--surface-3); border: 1px solid var(--line-strong);
    color: var(--text); font-size: var(--fs-sm); font-weight: 600; box-shadow: var(--sh-2);
  }
  .doc-menu-btn .icon { color: var(--copper-hi); }

  .doc-sidebar {
    position: fixed; top: 0; left: 0; bottom: 0; z-index: var(--z-nav);
    width: min(82vw, 300px); max-height: 100vh;
    background: var(--surface-1); border-right: 1px solid var(--line-strong);
    box-shadow: var(--sh-4); padding: calc(var(--nav-h) + var(--s-4)) var(--s-5) var(--s-6);
    transform: translateX(-104%); transition: transform var(--t-mid) var(--ease-out);
  }
  .doc-sidebar.is-open { transform: none; }

  .doc-base-grid, .auth-grid, .trust-grid { grid-template-columns: 1fr; }
  .doc-content { padding-top: var(--s-7); }
}

@media (max-width: 640px) {
  .download-panel { flex-direction: column; gap: var(--s-4); padding: var(--s-5); }
  .footer-grid { grid-template-columns: 1fr 1fr; gap: var(--s-6); }
  .footer-bottom { flex-direction: column; gap: var(--s-2); align-items: flex-start; }
}

@media (max-width: 420px) {
  .doc-h1 { font-size: var(--fs-2xl); }
  .endpoint { padding: var(--s-4); }
  .footer-grid { grid-template-columns: 1fr; }
  .verdict-row { gap: var(--s-3); }
}
