/* ============================================================
   Resonode docs — layout & typography on top of ../css/style.css
   ============================================================ */

.docs-shell {
  display: grid;
  grid-template-columns: 250px minmax(0, 1fr);
  gap: 48px;
  max-width: var(--container);
  margin: 0 auto;
  padding: 40px 28px 90px;
  align-items: start;
}

/* ---------- sidebar ---------- */

.docs-nav {
  position: sticky;
  top: 90px;
  font-size: 14px;
}
.docs-nav h4 {
  font-family: var(--font-mono);
  font-size: 10.5px;
  font-weight: 600;
  letter-spacing: 0.2em;
  text-transform: uppercase;
  color: var(--dim);
  margin: 22px 0 8px;
}
.docs-nav h4:first-child { margin-top: 0; }
.docs-nav ul { list-style: none; margin: 0; padding: 0; }
.docs-nav a {
  display: block;
  color: var(--muted);
  padding: 5px 10px;
  border-radius: 6px;
  border-left: 2px solid transparent;
}
.docs-nav a:hover { color: var(--ink); background: var(--panel); }
.docs-nav a[aria-current="page"] {
  color: var(--amber);
  background: color-mix(in srgb, var(--amber) 7%, transparent);
  border-left-color: var(--amber);
  border-radius: 0 6px 6px 0;
}

/* ---------- article ---------- */

.docs-body { max-width: 76ch; }

.docs-body .eyebrow { margin-bottom: 12px; }

.docs-body h1 {
  font-size: clamp(36px, 4.4vw, 52px);
  margin-bottom: 14px;
}
.docs-body > p.intro { font-size: 17.5px; color: var(--muted); margin-bottom: 34px; }

.docs-body h2 {
  font-size: 26px;
  letter-spacing: 0.03em;
  margin: 44px 0 12px;
  padding-top: 18px;
  border-top: 1px solid var(--line);
}
.docs-body h3 {
  font-family: var(--font-body);
  text-transform: none;
  font-size: 17px;
  font-weight: 600;
  letter-spacing: 0;
  margin: 26px 0 8px;
  color: var(--ink);
}
.docs-body p, .docs-body li { color: var(--muted); font-size: 15.5px; }
.docs-body p { margin-bottom: 14px; }
.docs-body strong { color: var(--ink); font-weight: 600; }
.docs-body ul, .docs-body ol { padding-left: 22px; margin-bottom: 16px; display: grid; gap: 7px; }

.docs-body code, .docs-body kbd {
  font-family: var(--font-mono);
  font-size: 13px;
  background: var(--well);
  border: 1px solid var(--line);
  border-radius: 5px;
  padding: 1px 7px;
  color: var(--yellow);
  white-space: nowrap;
}
.docs-body kbd { color: var(--amber); border-color: var(--line2); box-shadow: 0 1.5px 0 var(--line2); }

.docs-body pre {
  background: var(--well);
  border: 1px solid var(--line);
  border-radius: 8px;
  padding: 14px 18px;
  overflow-x: auto;
  margin-bottom: 16px;
}
.docs-body pre code { background: none; border: none; padding: 0; white-space: pre; color: var(--muted); }

/* callouts */
.callout {
  border-left: 3px solid var(--teal);
  background: color-mix(in srgb, var(--teal) 6%, transparent);
  border-radius: 0 8px 8px 0;
  padding: 13px 16px;
  margin: 18px 0;
  font-size: 14.5px;
  color: var(--muted);
}
.callout.tip { border-color: var(--amber); background: color-mix(in srgb, var(--amber) 6%, transparent); }
.callout.warn { border-color: var(--red); background: color-mix(in srgb, var(--red) 7%, transparent); }
.callout b { color: var(--ink); }

/* tables (shortcuts, conventions) */
.docs-table { width: 100%; border-collapse: collapse; margin: 16px 0 24px; font-size: 14.5px; }
.docs-table th {
  font-family: var(--font-mono);
  font-size: 11px;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--dim);
  text-align: left;
  padding: 8px 14px;
  background: var(--panel2);
  border: 1px solid var(--line);
}
.docs-table td { padding: 9px 14px; border: 1px solid var(--line); background: var(--panel); color: var(--muted); vertical-align: top; }
.docs-table td:first-child { white-space: nowrap; }

/* module reference — category quick links */
.mod-toc {
  display: flex;
  flex-wrap: wrap;
  gap: 8px;
  margin: 24px 0 10px;
  scroll-margin-top: 90px;
}
.mod-toc a {
  display: inline-flex;
  align-items: center;
  gap: 8px;
  font-family: var(--font-mono);
  font-size: 12.5px;
  letter-spacing: 0.03em;
  color: var(--muted);
  background: var(--well);
  border: 1px solid var(--line);
  border-radius: 20px;
  padding: 6px 13px;
}
.mod-toc a:hover { border-color: var(--amber); color: var(--ink); }
.mod-toc .swatch { width: 9px; height: 9px; border-radius: 2px; flex: none; }
.mod-toc .n { color: var(--dim); }

/* module reference */
.mod-ref-cat {
  display: flex;
  align-items: center;
  gap: 10px;
  margin: 40px 0 6px;
  padding-top: 18px;
  border-top: 1px solid var(--line);
}
.mod-ref-cat .swatch { width: 12px; height: 12px; border-radius: 3px; flex: none; }
.mod-ref-cat h2 { border: none; margin: 0; padding: 0; }
.mod-ref-cat { scroll-margin-top: 84px; }
.mod-ref-cat .count {
  margin-left: auto;
  font-family: var(--font-mono);
  font-size: 11px;
  letter-spacing: 0.1em;
  color: var(--dim);
  border: 1px solid var(--line2);
  border-radius: 20px;
  padding: 2px 9px;
}
.mod-ref-cat .top {
  font-family: var(--font-mono);
  font-size: 13px;
  color: var(--dim);
  padding: 0 4px;
}
.mod-ref-cat .top:hover { color: var(--amber); }
dl.mod-ref { margin: 14px 0 6px; }
dl.mod-ref dt {
  font-family: var(--font-mono);
  font-size: 13.5px;
  font-weight: 600;
  color: var(--ink);
  background: var(--well);
  border: 1px solid var(--line);
  border-radius: 6px;
  display: inline-block;
  padding: 3px 10px;
  margin-top: 14px;
}
dl.mod-ref dd { margin: 6px 0 0 2px; color: var(--muted); font-size: 15px; }

/* screenshots in articles */
.docs-body figure.shot {
  margin: 22px 0 26px;
  border: 1px solid var(--line2);
  border-radius: 10px;
  overflow: hidden;
  background: var(--panel);
}
.docs-body figure.shot img { display: block; width: 100%; height: auto; }
.docs-body figure.shot.narrow { max-width: 470px; }
.docs-body figure.shot figcaption {
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--dim);
  padding: 9px 14px;
  border-top: 1px solid var(--line);
}

/* prev/next footer */
.docs-pager {
  display: flex;
  justify-content: space-between;
  gap: 16px;
  margin-top: 56px;
  padding-top: 22px;
  border-top: 1px solid var(--line);
  font-size: 14.5px;
}
.docs-pager a { color: var(--muted); }
.docs-pager a:hover { color: var(--amber); }
.docs-pager .label {
  display: block;
  font-family: var(--font-mono);
  font-size: 10.5px;
  letter-spacing: 0.18em;
  text-transform: uppercase;
  color: var(--dim);
  margin-bottom: 4px;
}

/* ---------- responsive ---------- */

@media (max-width: 900px) {
  .docs-shell { grid-template-columns: 1fr; gap: 24px; }
  .docs-nav { position: static; }
  .docs-nav details { border: 1px solid var(--line); border-radius: 9px; background: var(--panel); padding: 10px 14px; }
  .docs-nav summary {
    cursor: pointer;
    font-family: var(--font-mono);
    font-size: 12px;
    letter-spacing: 0.14em;
    text-transform: uppercase;
    color: var(--amber);
  }
}
@media (min-width: 901px) {
  .docs-nav details { display: contents; }
  .docs-nav summary { display: none; }
}