/* ============================================================
   Komms docs — komms.org/docs
   Shares the landing "softened brutalism" palette & chrome.
   Self-contained: docs pages load only this stylesheet.
   ============================================================ */

:root {
  --bg:      #0e0c17;   /* page background */
  --panel:   #171425;   /* card / panel surface */
  --violet:  #8b5cf6;   /* accent */
  --violet-d:#6d28d9;   /* deep accent */
  --violet-l:#b79dff;   /* light accent (code numbers/types) */
  --lilac:   #cfc7ff;   /* primary text */
  --white:   #efecff;   /* headings */
  --ink:     #14121f;   /* text on lilac surfaces */
  --line:    rgba(207,199,255,.12);
  --line-strong: rgba(207,199,255,.15);
  --content-max: 1216px;
}

*, *::before, *::after { box-sizing: border-box; }
html { scroll-behavior: smooth; }
body {
  margin: 0;
  background: var(--bg);
  color: var(--lilac);
  font-family: 'Archivo', system-ui, sans-serif;
  -webkit-font-smoothing: antialiased;
  overflow-x: hidden;
}
a { color: var(--lilac); text-decoration: none; }
a:hover { color: var(--violet); }

.eyebrow {
  font: 500 13px 'JetBrains Mono', monospace;
  color: var(--violet);
  letter-spacing: .14em;
  margin: 0 0 20px;
}
.section-label {
  font: 500 12px 'JetBrains Mono', monospace;
  color: var(--violet);
  letter-spacing: .14em;
  margin: 0 0 10px;
}

/* ---------- shared nav (ported from the landing) ---------- */
.nav {
  max-width: var(--content-max);
  margin: 0 auto;
  display: flex;
  justify-content: space-between;
  align-items: center;
  gap: 16px;
  padding: 20px clamp(20px, 4vw, 32px);
  border-bottom: 1px solid var(--line-strong);
}
.wordmark { display: flex; align-items: center; gap: 10px; color: var(--white); }
.wordmark:hover { color: var(--white); }
.wordmark-mark { height: 28px; width: auto; display: block; }
.wordmark-name { font: 900 18px 'Archivo'; letter-spacing: -.02em; font-stretch: 125%; }
.wordmark-id { font: 500 11px 'JetBrains Mono'; color: var(--violet); }
.nav-links {
  display: flex;
  gap: clamp(14px, 3vw, 28px);
  align-items: center;
  font: 500 12px 'JetBrains Mono';
  letter-spacing: .08em;
}
.nav-links a[aria-current="true"] { color: var(--white); }
.btn-github {
  border-radius: 100px;
  padding: 9px 20px;
  color: #fff;
  background: var(--violet);
}
.btn-github:hover { color: #fff; background: var(--violet-d); }

/* ---------- shared buttons ---------- */
.btn-solid {
  background: var(--lilac);
  color: var(--bg);
  font: 800 15px 'Archivo';
  padding: 16px 30px;
  text-transform: uppercase;
  letter-spacing: .04em;
  border-radius: 100px;
}
.btn-solid:hover { background: #fff; color: var(--bg); }
.btn-ghost {
  border: 1px solid rgba(207,199,255,.35);
  color: var(--lilac);
  font: 600 14px 'Archivo';
  padding: 15px 26px;
  border-radius: 100px;
}
.btn-ghost:hover { border-color: var(--violet); color: var(--violet); }

/* ============================================================
   DOCS SHELL — sidebar + content
   ============================================================ */
.docs-shell {
  max-width: var(--content-max);
  margin: 0 auto;
  display: grid;
  grid-template-columns: 248px minmax(0, 1fr);
  gap: clamp(24px, 4vw, 56px);
  padding: clamp(24px, 4vw, 40px) clamp(20px, 4vw, 32px) 96px;
  align-items: start;
}

/* ---------- sidebar ---------- */
.docs-sidebar { position: sticky; top: 20px; }
.docs-nav-toggle > summary {
  list-style: none;
  cursor: pointer;
  display: flex;
  justify-content: space-between;
  align-items: center;
  gap: 12px;
  padding: 14px 18px;
  background: var(--panel);
  border: 1px solid var(--line);
  border-radius: 12px;
  font: 500 12px 'JetBrains Mono';
  letter-spacing: .06em;
  color: var(--white);
  text-transform: uppercase;
}
.docs-nav-toggle > summary::-webkit-details-marker { display: none; }
.docs-nav-toggle > summary::after {
  content: '▾';
  color: var(--violet);
  transition: transform .2s ease;
}
.docs-nav-toggle[open] > summary::after { transform: rotate(180deg); }

.docs-nav { margin-top: 8px; display: none; }              /* hidden on mobile until toggled */
.docs-nav-toggle[open] ~ .docs-nav { display: block; }
.docs-nav-group { margin-bottom: 22px; }
.docs-nav-head {
  font: 700 11px 'JetBrains Mono';
  letter-spacing: .12em;
  text-transform: uppercase;
  color: var(--violet);
  margin: 0 0 10px;
}
.docs-nav ul { list-style: none; margin: 0; padding: 0; }
.docs-nav li { margin: 0; }
.docs-nav a {
  display: block;
  padding: 6px 12px;
  border-left: 2px solid transparent;
  font: 400 14px/1.3 'Archivo';
  color: rgba(207,199,255,.72);
}
.docs-nav a:hover { color: var(--white); border-left-color: var(--line-strong); }
.docs-nav a[aria-current="page"] {
  color: var(--white);
  border-left-color: var(--violet);
  background: var(--panel);
  font-weight: 600;
}

/* ============================================================
   ARTICLE
   ============================================================ */
.docs-main { min-width: 0; }
.doc-article { max-width: 74ch; }
.doc-eyebrow {
  font: 500 12px 'JetBrains Mono';
  letter-spacing: .14em;
  text-transform: uppercase;
  color: var(--violet);
  margin: 0 0 14px;
}
.doc-title {
  margin: 0 0 32px;
  font: 900 clamp(34px, 5.5vw, 56px)/1.02 'Archivo';
  font-stretch: 116%;
  letter-spacing: -.02em;
  text-transform: uppercase;
  color: var(--white);
}

/* ---------- prose ---------- */
.doc-body { font: 400 clamp(15px, 1.4vw, 17px)/1.72 'Archivo'; color: rgba(207,199,255,.82); }
.doc-body > *:first-child { margin-top: 0; }
.doc-body h2 {
  margin: 52px 0 16px;
  padding-top: 24px;
  border-top: 1px solid var(--line);
  font: 800 clamp(22px, 3vw, 30px)/1.15 'Archivo';
  font-stretch: 110%;
  letter-spacing: -.01em;
  text-transform: uppercase;
  color: var(--white);
}
.doc-body h3 {
  margin: 36px 0 12px;
  font: 800 clamp(18px, 2.2vw, 21px) 'Archivo';
  color: var(--white);
}
.doc-body h4 {
  margin: 28px 0 10px;
  font: 700 15px 'JetBrains Mono';
  letter-spacing: .04em;
  color: var(--lilac);
}
.doc-body p { margin: 0 0 18px; }
.doc-body a {
  color: var(--violet);
  text-decoration: underline;
  text-decoration-color: rgba(139,92,246,.4);
  text-underline-offset: 3px;
}
.doc-body a:hover { color: var(--violet-l); text-decoration-color: var(--violet-l); }
.doc-body strong { color: var(--white); font-weight: 700; }
.doc-body em { color: var(--lilac); }
.doc-body ul, .doc-body ol { margin: 0 0 20px; padding-left: 24px; }
.doc-body li { margin: 0 0 8px; }
.doc-body li::marker { color: var(--violet); }
.doc-body hr { border: 0; border-top: 1px solid var(--line); margin: 40px 0; }
.doc-body img { max-width: 100%; height: auto; border-radius: 12px; }

.doc-body blockquote {
  margin: 0 0 22px;
  padding: 4px 0 4px 22px;
  border-left: 3px solid var(--violet);
  color: var(--lilac);
  font-style: italic;
}
.doc-body blockquote p:last-child { margin-bottom: 0; }

/* inline code */
.doc-body :not(pre) > code {
  font: 500 .88em 'JetBrains Mono';
  color: var(--violet-l);
  background: rgba(139,92,246,.12);
  border: 1px solid var(--line);
  padding: .12em .4em;
  border-radius: 6px;
  word-break: break-word;
}

/* code blocks */
.code-wrap { margin: 0 0 22px; overflow-x: auto; border-radius: 14px; border: 1px solid var(--line); background: var(--panel); }
pre.code { margin: 0; padding: 18px 20px; }
pre.code code {
  display: block;
  font: 400 13.5px/1.6 'JetBrains Mono';
  color: rgba(207,199,255,.9);
  background: none;
  white-space: pre;
}

/* ---------- tables ---------- */
.doc-body table {
  width: 100%;
  border-collapse: collapse;
  margin: 0 0 24px;
  font-size: .94em;
  display: block;
  overflow-x: auto;
}
.doc-body thead th {
  font: 700 11px 'JetBrains Mono';
  letter-spacing: .08em;
  text-transform: uppercase;
  color: var(--violet);
  text-align: left;
}
.doc-body th, .doc-body td {
  border: 1px solid var(--line);
  padding: 10px 14px;
  vertical-align: top;
}
.doc-body tbody tr:nth-child(even) { background: rgba(207,199,255,.03); }
.doc-body td strong { color: var(--white); }

/* ---------- diagrams (bespoke Mermaid renditions) ---------- */
.diagram { margin: 0 0 28px; }
.diagram figcaption {
  margin-top: 14px;
  font: 400 13px/1.5 'Archivo';
  color: rgba(207,199,255,.55);
}
.diagram figcaption code {
  font: 500 .88em 'JetBrains Mono';
  color: var(--violet-l);
}

/* layered stack (architecture) */
.diagram-stack { display: flex; flex-direction: column; align-items: stretch; }
.dlayer {
  background: var(--panel);
  border: 1px solid var(--line);
  border-radius: 14px;
  padding: 16px 18px;
}
.dlayer-tag {
  display: block;
  font: 700 11px 'JetBrains Mono';
  letter-spacing: .08em;
  text-transform: uppercase;
  color: var(--violet);
  margin-bottom: 12px;
}
.dnodes { display: flex; flex-wrap: wrap; gap: 8px; }
.dnodes > span {
  font: 500 13px 'Archivo';
  color: var(--white);
  background: rgba(207,199,255,.06);
  border: 1px solid var(--line);
  border-radius: 8px;
  padding: 7px 12px;
}
.dlayer-crypto { border-color: rgba(139,92,246,.5); }
.dlayer-crypto .dnodes > span { border-color: rgba(139,92,246,.3); }
.darrow { align-self: center; width: 2px; height: 22px; background: linear-gradient(var(--violet), rgba(139,92,246,.2)); position: relative; }
.darrow::after {
  content: '';
  position: absolute;
  bottom: -1px; left: 50%;
  transform: translateX(-50%);
  border: 5px solid transparent;
  border-top-color: var(--violet);
}
.dsplit { display: grid; grid-template-columns: repeat(3, 1fr); gap: 10px; }

/* linear flow (mesh path) */
.dflow { display: flex; flex-wrap: wrap; align-items: stretch; gap: 10px; }
.dnode {
  display: flex;
  flex-direction: column;
  justify-content: center;
  gap: 3px;
  flex: 1 1 140px;
  min-height: 64px;
  text-align: center;
  background: var(--panel);
  border: 1px solid var(--line);
  border-radius: 14px;
  padding: 12px 14px;
  font: 700 14px 'Archivo';
  color: var(--white);
}
.dnode small { font: 400 11px 'JetBrains Mono'; color: rgba(207,199,255,.55); }
.dnode-round { border-radius: 40px; border-color: rgba(139,92,246,.5); }
.dconn {
  display: flex;
  align-items: center;
  font: 500 11px 'JetBrains Mono';
  letter-spacing: .04em;
  color: var(--violet);
  white-space: nowrap;
}

/* ---------- edit link + pager ---------- */
.doc-edit {
  display: inline-block;
  margin: 48px 0 0;
  font: 500 12px 'JetBrains Mono';
  letter-spacing: .04em;
  color: rgba(207,199,255,.55);
}
.doc-edit:hover { color: var(--violet); }

.doc-pager {
  display: flex;
  justify-content: space-between;
  gap: 16px;
  margin-top: 28px;
  padding-top: 28px;
  border-top: 1px solid var(--line);
}
.doc-pager a {
  display: flex;
  flex-direction: column;
  gap: 4px;
  max-width: 48%;
  padding: 16px 20px;
  background: var(--panel);
  border: 1px solid var(--line);
  border-radius: 14px;
}
.doc-pager a:hover { border-color: var(--violet); }
.pager-next { text-align: right; align-items: flex-end; }
.doc-pager span { font: 500 11px 'JetBrains Mono'; letter-spacing: .06em; color: var(--violet); }
.doc-pager strong { font: 700 15px 'Archivo'; color: var(--white); }

/* ============================================================
   DOCS INDEX
   ============================================================ */
.docs-index {
  max-width: var(--content-max);
  margin: 0 auto;
  padding: clamp(40px, 7vw, 80px) clamp(20px, 4vw, 32px) 96px;
}
.idx-hero { max-width: 760px; margin-bottom: clamp(40px, 6vw, 72px); }
.idx-title {
  margin: 0 0 20px;
  font: 900 clamp(44px, 9vw, 96px)/0.96 'Archivo';
  font-stretch: 120%;
  letter-spacing: -.03em;
  text-transform: uppercase;
  color: var(--white);
}
.idx-sub { font: 400 clamp(16px, 2vw, 19px)/1.55 'Archivo'; color: rgba(207,199,255,.8); margin: 0 0 32px; }
.idx-cta { display: flex; flex-wrap: wrap; gap: 14px; align-items: center; }

.idx-group {
  padding: 32px 0;
  border-top: 1px solid var(--line);
}
.idx-blurb { font: 400 16px/1.5 'Archivo'; color: rgba(207,199,255,.65); margin: 0 0 24px; max-width: 620px; }
.idx-list {
  list-style: none;
  margin: 0;
  padding: 0;
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
  gap: 12px;
}
.idx-list a {
  display: block;
  padding: 18px 22px;
  background: var(--panel);
  border: 1px solid var(--line);
  border-radius: 14px;
  color: var(--white);
  transition: border-color .15s ease, transform .15s ease;
}
.idx-list a:hover { border-color: var(--violet); transform: translateY(-2px); }
.idx-name { font: 800 16px 'Archivo'; text-transform: uppercase; letter-spacing: .01em; }

/* ============================================================
   highlight.js — violet/lilac theme
   ============================================================ */
.hljs-comment, .hljs-quote { color: rgba(207,199,255,.42); font-style: italic; }
.hljs-keyword, .hljs-selector-tag, .hljs-literal, .hljs-section,
.hljs-meta, .hljs-operator, .hljs-doctag { color: var(--violet); }
.hljs-number, .hljs-type, .hljs-built_in, .hljs-class .hljs-title,
.hljs-params { color: var(--violet-l); }
.hljs-string, .hljs-attr, .hljs-attribute, .hljs-symbol,
.hljs-bullet, .hljs-addition, .hljs-regexp { color: #d7e9c8; }
.hljs-title, .hljs-title.function_, .hljs-name, .hljs-selector-id,
.hljs-selector-class { color: var(--white); }
.hljs-variable, .hljs-template-variable, .hljs-link { color: var(--lilac); }
.hljs-deletion { color: #f0a1a1; }
.hljs-emphasis { font-style: italic; }
.hljs-strong { font-weight: 700; color: var(--white); }

/* ============================================================
   RESPONSIVE
   ============================================================ */
@media (min-width: 861px) {
  /* sidebar always expanded on desktop; hide the disclosure toggle */
  .docs-nav-toggle { display: none; }
  .docs-nav { display: block; }
}
@media (max-width: 860px) {
  .docs-shell { grid-template-columns: 1fr; }
  .docs-sidebar { position: static; }
  .doc-title { font-size: clamp(30px, 8vw, 40px); }
  .dsplit { grid-template-columns: 1fr; }
  .dflow { flex-direction: column; }
  .dconn { justify-content: center; }
}
@media (max-width: 560px) {
  .nav-links { gap: 12px; font-size: 11px; }
  .nav-links a:not(.btn-github) { display: none; }
  .doc-pager { flex-direction: column; }
  .doc-pager a { max-width: 100%; }
  .pager-next { text-align: left; align-items: flex-start; }
}

/* ============================================================
   REDUCED MOTION
   ============================================================ */
@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
  .idx-list a:hover { transform: none; }
  .docs-nav-toggle[open] > summary::after { transition: none; }
}