/* ========================================================================
   flinkit.org/docs — layout + prose styles
   Builds on ../styles.css (palette tokens, header, footer, buttons, .c-*).
   ======================================================================== */

:root { --sidebar-w: 248px; --docs-maxw: 1220px; --header-h: 60px; }

.brand-sub { font-family: var(--mono); font-size: 14px; color: var(--dim); margin-left: 2px; }

.c-cyan { color: var(--cyan); }
.c-key  { color: var(--cyan); }
.c-str  { color: var(--ok); }

/* ---- shell ---------------------------------------------------------- */
.docs-shell {
  max-width: var(--docs-maxw); margin: 0 auto; padding: 0 24px;
  display: grid; grid-template-columns: var(--sidebar-w) minmax(0, 1fr);
  gap: 48px; align-items: start;
}

/* ---- sidebar -------------------------------------------------------- */
.docs-sidebar {
  position: sticky; top: var(--header-h);
  max-height: calc(100vh - var(--header-h));
  overflow-y: auto; padding: 36px 0 48px;
}
.docs-nav-mobile-summary { display: none; }  /* desktop: no toggle, nav always open */
.docs-nav-group { margin-bottom: 26px; }
.docs-nav-title {
  font-family: var(--mono); font-size: 11.5px; letter-spacing: 0.08em;
  text-transform: uppercase; color: var(--dim); margin: 0 0 10px; padding-left: 12px;
}
.docs-nav a {
  display: block; padding: 7px 12px; border-radius: 7px;
  color: var(--muted); font-size: 14.5px; line-height: 1.35;
  border-left: 2px solid transparent;
}
.docs-nav a:hover { color: var(--text); background: var(--surface); text-decoration: none; }
.docs-nav a.sub { padding-left: 24px; font-family: var(--mono); font-size: 13px; }
.docs-nav a.active {
  color: var(--cyan); background: var(--cyan-soft);
  border-left-color: var(--cyan); font-weight: 500;
}

/* ---- main / prose --------------------------------------------------- */
.docs-main { padding: 40px 0 72px; max-width: 760px; }
.docs-breadcrumb {
  font-family: var(--mono); font-size: 12.5px; color: var(--dim);
  margin: 0 0 14px; letter-spacing: 0.02em;
}
.docs-breadcrumb a { color: var(--dim); }
.docs-breadcrumb a:hover { color: var(--muted); }

.prose h1 { font-size: clamp(1.9rem, 4vw, 2.5rem); font-weight: 700; margin: 0 0 14px; }
.prose .lead { font-size: 1.18rem; color: var(--muted); margin: 0 0 8px; line-height: 1.5; }
.prose h2 {
  font-size: 1.5rem; font-weight: 650; margin: 48px 0 14px;
  padding-top: 14px; border-top: 1px solid var(--border-soft);
}
.prose h3 { font-size: 1.15rem; font-weight: 600; margin: 32px 0 10px; }
.prose p { margin: 0 0 16px; color: #cfd4dc; }
.prose ul, .prose ol { margin: 0 0 16px; padding-left: 22px; color: #cfd4dc; }
.prose li { margin: 6px 0; }
.prose li::marker { color: var(--dim); }
.prose strong { color: var(--text); font-weight: 650; }
.prose a { color: var(--cyan); }

/* command/anchor headings get scroll offset under sticky header */
.prose h2[id], .prose h3[id] { scroll-margin-top: calc(var(--header-h) + 16px); }

/* inline code */
.prose code {
  font-family: var(--mono); font-size: 0.88em;
  background: var(--surface); border: 1px solid var(--border-soft);
  color: #d8dee7; padding: 1.5px 6px; border-radius: 5px; white-space: nowrap;
}

/* code blocks */
.code {
  margin: 0 0 20px; background: #12141a; border: 1px solid var(--border);
  border-radius: 10px; overflow-x: auto;
  font-family: var(--mono); font-size: 13.5px; line-height: 1.65;
}
.code pre { margin: 0; padding: 16px 18px; }
.code code {
  background: none; border: none; padding: 0; white-space: pre;
  font-size: inherit; color: var(--text);
}
.code-label {
  font-family: var(--mono); font-size: 11.5px; letter-spacing: 0.05em;
  text-transform: uppercase; color: var(--dim);
  padding: 9px 18px; border-bottom: 1px solid var(--border-soft);
  background: var(--surface);
}

/* callouts */
.note {
  display: flex; gap: 12px; margin: 0 0 20px; padding: 14px 16px;
  border: 1px solid var(--border); border-left-width: 3px;
  border-radius: 9px; background: var(--surface); font-size: 0.96rem;
}
.note p { margin: 0; color: var(--muted); }
.note p + p { margin-top: 8px; }
.note .note-icon { flex: none; font-family: var(--mono); font-weight: 700; }
.note-info { border-left-color: var(--cyan); }
.note-info .note-icon { color: var(--cyan); }
.note-warn { border-left-color: var(--warn); }
.note-warn .note-icon { color: var(--warn); }

/* tables */
.prose table {
  width: 100%; border-collapse: collapse; margin: 0 0 22px; font-size: 0.94rem;
}
.prose th, .prose td {
  text-align: left; padding: 10px 14px; border-bottom: 1px solid var(--border-soft);
  vertical-align: top;
}
.prose th {
  font-size: 12.5px; letter-spacing: 0.03em; text-transform: uppercase;
  color: var(--dim); font-weight: 600; border-bottom-color: var(--border);
}
.prose td code { white-space: nowrap; }
.table-wrap { overflow-x: auto; }

/* keyboard keys */
kbd {
  font-family: var(--mono); font-size: 12px; color: var(--text);
  background: var(--surface-2); border: 1px solid var(--border);
  border-bottom-width: 2px; border-radius: 5px; padding: 1px 7px;
}

/* severity pills (shared look with landing .sev) */
.pill {
  display: inline-block; font-family: var(--mono); font-size: 11px;
  letter-spacing: 0.05em; text-transform: uppercase; font-weight: 600;
  padding: 2px 9px; border-radius: 999px; white-space: nowrap;
}
.pill-crit { color: var(--crit); background: var(--crit-soft); }
.pill-warn { color: var(--warn); background: var(--warn-soft); }
.pill-ok   { color: var(--ok);   background: var(--ok-soft); }
.pill-info { color: var(--cyan); background: var(--cyan-soft); }

/* screenshot inside docs */
.docs-shot {
  margin: 0 0 22px; border: 1px solid var(--border); border-radius: 12px;
  overflow: hidden; background: #12141a;
}
.docs-shot img { width: 100%; display: block; }
.docs-shot figcaption {
  padding: 12px 16px; font-size: 13.5px; color: var(--muted);
  border-top: 1px solid var(--border-soft); background: var(--bg-elev);
}

/* prev / next pager */
.docs-pager {
  display: flex; gap: 16px; margin-top: 56px;
  border-top: 1px solid var(--border-soft); padding-top: 28px;
}
.docs-pager a {
  flex: 1; display: block; padding: 16px 18px; border: 1px solid var(--border);
  border-radius: 10px; background: var(--surface);
}
.docs-pager a:hover { border-color: var(--cyan); text-decoration: none; }
.docs-pager .pg-dir { font-family: var(--mono); font-size: 12px; color: var(--dim); }
.docs-pager .pg-title { color: var(--text); font-weight: 600; margin-top: 4px; }
.docs-pager .pg-next { text-align: right; }

/* ---- responsive ----------------------------------------------------- */
@media (max-width: 880px) {
  .docs-shell { grid-template-columns: 1fr; gap: 0; }
  .docs-sidebar {
    position: static; max-height: none; overflow: visible;
    padding: 16px 0; border-bottom: 1px solid var(--border-soft); margin-bottom: 8px;
  }
  .docs-sidebar details { }
  .docs-nav-mobile-summary {
    font-family: var(--mono); font-size: 14px; color: var(--text);
    cursor: pointer; padding: 10px 12px; list-style: none;
    display: flex; align-items: center; justify-content: space-between;
    border: 1px solid var(--border); border-radius: 8px; background: var(--surface);
  }
  .docs-nav-mobile-summary::-webkit-details-marker { display: none; }
  .docs-nav-mobile-summary::after { content: "▾"; color: var(--dim); }
  details[open] .docs-nav-mobile-summary::after { content: "▴"; }
  .docs-nav { padding-top: 14px; }
  .docs-main { padding: 28px 0 56px; }
  .docs-pager { flex-direction: column; }
}