:root {
  --bg:          #f3f2ee;
  --bg-panel:    #eae7dd;
  --bg-code:     #1c1d18;
  --text-code:   #cfd6bd;
  --code-kw:     #d2a24c;
  --code-str:    #8fae6b;
  --code-com:    #767a68;
  --code-type:   #8fb4c9;

  --ink:         #18181a;
  --ink-soft:    #54534b;
  --ink-faint:   #8c8a7a;
  --rule:        #d2cfc0;
  --rule-strong: #b8b4a2;

  --accent:      #1f5f63;
  --accent-soft: #e3eae7;
  --amber:       #a85d00;
  --amber-soft:  #f3e7d4;
  --danger:      #8a1f11;
  --danger-soft: #f3e1dc;

  --font-mono: ui-monospace, "Cascadia Code", "JetBrains Mono", "Roboto Mono",
               Consolas, "Liberation Mono", monospace;
  --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica,
               Arial, sans-serif;

  --maxw: 740px;
  --sidebar-w: 230px;
}

* { box-sizing: border-box; }

html { color-scheme: light; }

body {
  margin: 0;
  background: var(--bg);
  color: var(--ink);
  font-family: var(--font-sans);
  font-size: 16px;
  line-height: 1.6;
  -webkit-font-smoothing: antialiased;
}

a {
  color: var(--accent);
  text-decoration-line: underline;
  text-decoration-color: var(--rule-strong);
  text-decoration-thickness: 1px;
  text-underline-offset: 2px;
}
a:hover { text-decoration-color: var(--accent); }
a:focus-visible,
button:focus-visible,
input:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
}

h1, h2, h3, h4 {
  font-family: var(--font-mono);
  font-weight: 600;
  line-height: 1.25;
  color: var(--ink);
  letter-spacing: -0.01em;
}
h1 { font-size: 1.9rem; margin: 0 0 0.5rem; }
h2 { font-size: 1.2rem; margin: 2.4rem 0 0.9rem; padding-top: 1.4rem; border-top: 1px solid var(--rule); }
h2:first-of-type { border-top: none; padding-top: 0; margin-top: 1.6rem; }
h3 { font-size: 1rem; margin: 1.8rem 0 0.6rem; color: var(--ink); }
h4 { font-size: 0.9rem; margin: 1.4rem 0 0.5rem; color: var(--ink-soft); }

p { margin: 0 0 1rem; max-width: 68ch; }
ul, ol { margin: 0 0 1rem; padding-left: 1.4rem; max-width: 68ch; }
li { margin-bottom: 0.4rem; }
strong { font-weight: 600; }

code, kbd, samp {
  font-family: var(--font-mono);
  font-size: 0.88em;
  background: var(--bg-panel);
  border: 1px solid var(--rule);
  border-radius: 2px;
  padding: 0.05em 0.35em;
}

pre {
  font-family: var(--font-mono);
  font-size: 0.84rem;
  line-height: 1.55;
  background: var(--bg-code);
  color: var(--text-code);
  border-radius: 3px;
  padding: 1rem 1.15rem;
  overflow-x: auto;
  margin: 0 0 1.25rem;
  max-width: 100%;
}
pre code {
  background: none;
  border: none;
  padding: 0;
  font-size: 1em;
  color: inherit;
}
.tok-kw   { color: var(--code-kw); }
.tok-str  { color: var(--code-str); }
.tok-com  { color: var(--code-com); font-style: italic; }
.tok-type { color: var(--code-type); }

.eyebrow {
  font-family: var(--font-mono);
  font-size: 0.78rem;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--ink-faint);
  margin: 0 0 0.6rem;
}
.lede {
  font-size: 1.1rem;
  color: var(--ink-soft);
  max-width: 60ch;
}

/* status indicator component */
.status {
  display: inline-flex;
  align-items: center;
  gap: 0.45rem;
  font-family: var(--font-mono);
  font-size: 0.78rem;
  padding: 0.2rem 0.6rem;
  border: 1px solid var(--rule-strong);
  border-radius: 2px;
  background: var(--bg-panel);
  white-space: nowrap;
}
.status::before {
  content: "";
  width: 7px; height: 7px;
  border-radius: 50%;
  background: var(--ink-faint);
  flex: none;
}
.status.armed { border-color: var(--amber); background: var(--amber-soft); color: #5e3a00; }
.status.armed::before { background: var(--amber); animation: wb-pulse 2.2s ease-in-out infinite; }
@media (prefers-reduced-motion: reduce) {
  .status.armed::before { animation: none; }
}
@keyframes wb-pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.3; } }

/* note / warn / danger callouts */
.note, .warn, .danger-box {
  border-left: 3px solid var(--accent);
  background: var(--accent-soft);
  padding: 0.85rem 1.1rem;
  margin: 1.3rem 0;
  font-size: 0.93rem;
  max-width: 68ch;
  border-radius: 0 2px 2px 0;
}
.note p, .warn p, .danger-box p { margin: 0; }
.warn { border-left-color: var(--amber); background: var(--amber-soft); }
.danger-box { border-left-color: var(--danger); background: var(--danger-soft); }
.tag {
  display: inline-block;
  font-family: var(--font-mono);
  font-size: 0.72rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--ink-faint);
  margin-bottom: 0.35rem;
}

/* tables */
table {
  border-collapse: collapse;
  width: 100%;
  margin: 0 0 1.5rem;
  font-size: 0.88rem;
}
th, td {
  text-align: left;
  padding: 0.5rem 0.7rem;
  border: 1px solid var(--rule);
  vertical-align: top;
}
th {
  font-family: var(--font-mono);
  font-size: 0.75rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--ink-soft);
  background: var(--bg-panel);
}
td code { white-space: nowrap; }

/* source excerpt captions */
.src-cap {
  font-family: var(--font-mono);
  font-size: 0.76rem;
  color: var(--ink-faint);
  margin: 0 0 0.4rem;
}

/* diagrams */
.diagram {
  border: 1px solid var(--rule);
  background: var(--bg-panel);
  padding: 1rem;
  margin: 1.5rem 0;
  overflow-x: auto;
  border-radius: 2px;
}
.diagram svg { display: block; min-width: 640px; }
.diagram-caption {
  font-family: var(--font-mono);
  font-size: 0.76rem;
  color: var(--ink-faint);
  margin-top: 0.6rem;
}

/* layout */
.topbar {
  border-bottom: 1px solid var(--rule);
  background: var(--bg);
}
.topbar-inner {
  max-width: 1180px;
  margin: 0 auto;
  padding: 0.9rem 1.5rem;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 1rem;
  flex-wrap: wrap;
}
.brand {
  font-family: var(--font-mono);
  font-weight: 600;
  font-size: 0.95rem;
  color: var(--ink);
  text-decoration: none;
}
.brand-mark { color: var(--amber); }
.topbar-links { display: flex; gap: 1.2rem; font-family: var(--font-mono); font-size: 0.82rem; }
.topbar-links a { text-decoration: none; color: var(--ink-soft); }
.topbar-links a:hover { color: var(--accent); }

.layout {
  max-width: 1180px;
  margin: 0 auto;
  display: grid;
  grid-template-columns: var(--sidebar-w) minmax(0, 1fr);
}

.sidebar {
  border-right: 1px solid var(--rule);
  padding: 2rem 1.25rem 2rem 1.5rem;
}
.nav-group { margin-bottom: 1.6rem; }
.nav-group-title {
  font-family: var(--font-mono);
  font-size: 0.7rem;
  text-transform: uppercase;
  letter-spacing: 0.07em;
  color: var(--ink-faint);
  margin-bottom: 0.5rem;
}
.nav-group ul { list-style: none; padding: 0; margin: 0; }
.nav-group li { margin: 0 0 0.15rem; }
.nav-group a {
  display: block;
  font-family: var(--font-mono);
  font-size: 0.85rem;
  color: var(--ink-soft);
  text-decoration: none;
  padding: 0.25rem 0.5rem;
  margin-left: -0.5rem;
  border-radius: 2px;
  border-left: 2px solid transparent;
}
.nav-group a:hover { color: var(--ink); background: var(--bg-panel); }
.nav-group a[aria-current="page"] {
  color: var(--ink);
  font-weight: 600;
  border-left-color: var(--amber);
  background: var(--bg-panel);
}

main {
  padding: 2.6rem 3rem 5rem;
  max-width: var(--maxw);
}

.page-head { margin-bottom: 1.8rem; }

.site-footer {
  border-top: 1px solid var(--rule);
  margin-top: 2rem;
}
.footer-inner {
  max-width: 1180px;
  margin: 0 auto;
  padding: 1.6rem 1.5rem 2.4rem;
  font-size: 0.82rem;
  color: var(--ink-soft);
}
.footer-inner p { margin: 0 0 0.4rem; max-width: none; }
.footer-links a { color: var(--ink-soft); }
.footer-dedication { color: var(--ink-faint); font-size: 0.78rem; }

/* toc-style index list (Documentation page) */
.doc-index { list-style: none; padding: 0; margin: 0 0 1.5rem; }
.doc-index li {
  border: 1px solid var(--rule);
  border-radius: 2px;
  padding: 0.85rem 1rem;
  margin-bottom: 0.6rem;
  background: var(--bg);
}
.doc-index a {
  font-family: var(--font-mono);
  font-weight: 600;
  text-decoration: none;
  font-size: 0.95rem;
}
.doc-index p { margin: 0.3rem 0 0; font-size: 0.88rem; color: var(--ink-soft); }

dl.faq dt {
  font-family: var(--font-mono);
  font-weight: 600;
  margin-top: 1.6rem;
  padding-top: 1.2rem;
  border-top: 1px solid var(--rule);
}
dl.faq dt:first-of-type { border-top: none; padding-top: 0; margin-top: 0; }
dl.faq dd { margin: 0.5rem 0 0; max-width: 66ch; }

/* responsive */
@media (max-width: 860px) {
  .layout { grid-template-columns: 1fr; }
  .sidebar {
    border-right: none;
    border-bottom: 1px solid var(--rule);
    padding: 1.4rem 1.5rem;
  }
  .nav-group { margin-bottom: 1.1rem; }
  main { padding: 2rem 1.5rem 4rem; }
}