/* ─────────────────────────────────────────────────────────────────────
   Kosha docs — /docs
   Layered on styles.css: the tokens, top bar, footer, and buttons are
   shared with the marketing page; everything here is the three-column
   documentation shell and the prose inside it.
   ───────────────────────────────────────────────────────────────────── */

:root {
  --side-w: 236px;
  --toc-w: 200px;
  --top-h: 68px;
}

.docs-body { background: var(--bg); }

.docs-shell {
  max-width: 1440px;
  margin: 0 auto;
  padding: 0 var(--gutter);
}

.docs-layout {
  display: grid;
  grid-template-columns: var(--side-w) minmax(0, 1fr) var(--toc-w);
  gap: 48px;
  align-items: start;
}

/* ─── Sidebar ─────────────────────────────────────────────────────── */

.side {
  position: sticky;
  top: var(--top-h);
  align-self: start;
  max-height: calc(100vh - var(--top-h));
  overflow-y: auto;
  overscroll-behavior: contain;
  padding: 28px 0 48px;
  border-right: 1px solid var(--line);
  margin-right: -24px;
  padding-right: 24px;
}

/* The disclosure is only interactive on narrow screens; on desktop it is
   forced open and its summary hidden, so the markup is identical either way. */
.side-summary { display: none; }
.side-disclosure { display: block; }

.side-search {
  position: relative;
  display: block;
  margin-bottom: 22px;
}
.side-search input {
  width: 100%;
  font-family: var(--sans);
  font-size: 13px;
  color: var(--ink);
  background: var(--bg-tint);
  border: 1px solid var(--line);
  border-radius: 8px;
  padding: 8px 34px 8px 12px;
  -webkit-appearance: none;
  appearance: none;
}
.side-search input::placeholder { color: var(--faint); }
.side-search input:focus {
  outline: none;
  border-color: var(--violet);
  background: var(--bg);
  box-shadow: 0 0 0 3px var(--violet-chip);
}
.side-search kbd {
  position: absolute;
  right: 8px;
  top: 50%;
  transform: translateY(-50%);
  font-family: var(--mono);
  font-size: 10px;
  color: var(--muted);
  background: var(--bg);
  border: 1px solid var(--line);
  border-radius: 4px;
  padding: 2px 6px;
  pointer-events: none;
}

.side-group + .side-group { margin-top: 24px; }

.side-label {
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--faint);
  margin: 0 0 8px 10px;
}

.side-link {
  display: block;
  font-size: 14px;
  line-height: 1.35;
  color: var(--text-2);
  padding: 6px 10px;
  border-radius: 6px;
}
.side-link:hover { color: var(--ink); background: var(--bg-tint); }
.side-link.is-on {
  color: var(--brand);
  background: var(--violet-chip);
  font-weight: 600;
}
.side-link[hidden] { display: none; }

.side-empty {
  font-size: 13px;
  color: var(--muted);
  padding: 6px 10px;
}

/* ─── Article column ──────────────────────────────────────────────── */

.doc {
  min-width: 0;
  padding: 44px 0 72px;
}

.doc-article { max-width: 720px; }

.doc-eyebrow {
  font-family: var(--mono);
  font-size: 12px;
  font-weight: 500;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--link);
  margin-bottom: 12px;
}

.doc-article h1 {
  font-size: 38px;
  line-height: 1.15;
  letter-spacing: -0.025em;
  font-weight: 700;
  color: var(--ink);
  margin-bottom: 16px;
}

.doc-lede {
  font-size: 18px;
  line-height: 1.6;
  color: var(--text-2);
}

.doc-article h2 {
  font-size: 24px;
  line-height: 1.25;
  letter-spacing: -0.018em;
  font-weight: 700;
  color: var(--ink);
  margin: 52px 0 14px;
  scroll-margin-top: calc(var(--top-h) + 20px);
}

.doc-article h3 {
  font-size: 17px;
  line-height: 1.35;
  font-weight: 700;
  color: var(--ink-2);
  margin: 32px 0 10px;
  scroll-margin-top: calc(var(--top-h) + 20px);
}

.doc-article p,
.doc-article li {
  font-size: 15.5px;
  line-height: 1.68;
  color: var(--text);
}
.doc-article p { margin: 0 0 16px; }

.doc-article ul,
.doc-article ol {
  margin: 0 0 18px;
  padding-left: 22px;
}
.doc-article li { margin-bottom: 8px; }
.doc-article li::marker { color: var(--faint); }

.doc-article strong { color: var(--ink-2); font-weight: 600; }

.doc-article code {
  font-family: var(--mono);
  font-size: 0.875em;
  color: var(--ink-2);
  background: var(--bg-tint);
  border: 1px solid var(--line-soft);
  border-radius: 4px;
  padding: 1px 5px;
}

.doc-article a { text-decoration: underline; text-underline-offset: 2px; }
.doc-article h1 a, .doc-article h2 a, .doc-article h3 a { text-decoration: none; }

/* ─── Code blocks ─────────────────────────────────────────────────── */

.code {
  margin: 0 0 22px;
  border: 1px solid var(--line);
  border-radius: 10px;
  background: var(--bg-tint);
  overflow: hidden;
}
.code-head {
  font-family: var(--mono);
  font-size: 11.5px;
  color: var(--muted);
  padding: 8px 14px;
  background: var(--bg);
  border-bottom: 1px solid var(--line);
}
.code pre {
  margin: 0;
  padding: 14px;
  overflow-x: auto;
}
.code code {
  font-family: var(--mono);
  font-size: 13px;
  line-height: 1.65;
  color: var(--ink-2);
  background: none;
  border: 0;
  padding: 0;
  white-space: pre;
}
.code .c { color: var(--muted); }
.code .s { color: #0F7B6C; }
.code .k { color: var(--brand); }
.code .n { color: #B54708; }

/* ─── Tables ──────────────────────────────────────────────────────── */

.doc-table {
  width: 100%;
  margin: 0 0 22px;
  border: 1px solid var(--line);
  border-radius: 10px;
  overflow: hidden;
}
.doc-table table {
  width: 100%;
  border-collapse: collapse;
}
.doc-table th,
.doc-table td {
  text-align: left;
  vertical-align: top;
  font-size: 14px;
  line-height: 1.6;
  padding: 10px 14px;
  border-bottom: 1px solid var(--line-soft);
}
.doc-table th {
  font-weight: 600;
  color: var(--ink-2);
  background: var(--bg-tint);
  white-space: nowrap;
}
.doc-table tbody tr:last-child td { border-bottom: 0; }
.doc-table td code { white-space: nowrap; }
.doc-table-scroll { overflow-x: auto; }

/* ─── Callouts ────────────────────────────────────────────────────── */

.note {
  margin: 0 0 22px;
  padding: 14px 16px;
  border: 1px solid var(--violet-line);
  border-left: 3px solid var(--violet);
  border-radius: 8px;
  background: var(--violet-bg);
}
.note p { margin: 0; font-size: 14.5px; color: var(--text-2); }
.note p + p { margin-top: 10px; }
.note-title {
  font-size: 12px !important;
  font-weight: 700;
  letter-spacing: 0.05em;
  text-transform: uppercase;
  color: var(--link) !important;
  margin-bottom: 6px !important;
}

/* ─── Definition lists ────────────────────────────────────────────── */

.fields { margin: 0 0 22px; }
.field {
  padding: 14px 0;
  border-top: 1px solid var(--line-soft);
}
.field:last-child { border-bottom: 1px solid var(--line-soft); }
.field dt {
  font-family: var(--mono);
  font-size: 13.5px;
  font-weight: 500;
  color: var(--ink);
  margin-bottom: 4px;
}
.field dt .type {
  font-size: 11.5px;
  color: var(--muted);
  margin-left: 8px;
  font-weight: 400;
}
.field dd {
  font-size: 14.5px;
  line-height: 1.6;
  color: var(--text);
  margin: 0;
}

/* ─── Card grid (index page) ──────────────────────────────────────── */

.doc-cards {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(228px, 1fr));
  gap: 12px;
  margin: 0 0 22px;
}
.doc-card {
  display: block;
  padding: 16px;
  border: 1px solid var(--line);
  border-radius: 10px;
  background: var(--bg);
  text-decoration: none !important;
  transition: border-color 120ms ease, box-shadow 120ms ease;
}
.doc-card:hover { border-color: var(--violet); box-shadow: var(--shadow-sm); }
.doc-card strong {
  display: block;
  font-size: 15px;
  color: var(--ink) !important;
  margin-bottom: 4px;
}
.doc-card span {
  display: block;
  font-size: 13.5px;
  line-height: 1.55;
  color: var(--muted);
}

/* ─── On this page ────────────────────────────────────────────────── */

.toc {
  position: sticky;
  top: var(--top-h);
  align-self: start;
  max-height: calc(100vh - var(--top-h));
  overflow-y: auto;
  padding: 48px 0 48px;
}
.toc-label {
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--faint);
  margin-bottom: 10px;
}
.toc a {
  display: block;
  font-size: 13px;
  line-height: 1.45;
  color: var(--muted);
  padding: 5px 0 5px 12px;
  border-left: 2px solid var(--line);
}
.toc a:hover { color: var(--ink); }
.toc a.is-on {
  color: var(--brand);
  border-left-color: var(--brand);
}

/* ─── Pager ───────────────────────────────────────────────────────── */

.pager {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 12px;
  max-width: 720px;
  margin-top: 56px;
  padding-top: 28px;
  border-top: 1px solid var(--line);
}
.pager-link {
  display: block;
  padding: 14px 16px;
  border: 1px solid var(--line);
  border-radius: 10px;
  transition: border-color 120ms ease;
}
.pager-link:hover { border-color: var(--violet); }
.pager-next { text-align: right; }
.pager-link span {
  display: block;
  font-size: 12px;
  color: var(--muted);
  margin-bottom: 3px;
}
.pager-link strong {
  font-size: 14.5px;
  font-weight: 600;
  color: var(--ink);
}

/* ─── Responsive ──────────────────────────────────────────────────── */

@media (max-width: 1180px) {
  .docs-layout { grid-template-columns: var(--side-w) minmax(0, 1fr); }
  .toc { display: none; }
}

@media (max-width: 860px) {
  :root { --gutter: 20px; }
  .docs-layout { display: block; }
  .side {
    position: static;
    max-height: none;
    overflow: visible;
    border-right: 0;
    border-bottom: 1px solid var(--line);
    margin: 0;
    padding: 12px 0;
  }
  .side-summary {
    display: block;
    font-size: 14px;
    font-weight: 600;
    color: var(--ink);
    cursor: pointer;
    padding: 8px 0;
    list-style: none;
  }
  .side-summary::-webkit-details-marker { display: none; }
  .side-summary::after {
    content: "▾";
    float: right;
    color: var(--muted);
  }
  .side-disclosure[open] .side-summary::after { content: "▴"; }
  .side-inner { padding: 12px 0 4px; }
  .doc { padding: 28px 0 56px; }
  .doc-article h1 { font-size: 30px; }
  .doc-article h2 { font-size: 21px; margin-top: 40px; }
  .pager { grid-template-columns: 1fr; }
}