/* ════════════════════════════════════════════════════════════════════
   KME Documentation — design system
   Tokens are inherited 1:1 from the Falah-approved direction
   (public/design-direction-2/styles.css) so docs + platform feel like
   one product. Layout below is documentation-specific.
   ════════════════════════════════════════════════════════════════════ */
@import url('https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500;600&display=swap');

:root {
  --o: #F76A1C;
  --o-deep: #D85714;
  --o-soft: #FFF1E6;
  --o-glow: rgba(247,106,28,0.18);
  --ink: #0B0D0F;
  --ink-2: #2A2E33;
  --ink-3: #5A6068;
  --ink-4: #8A8F97;
  --ink-5: #B6BBC2;
  --line: #ECEAE3;
  --line-2: #DFDCD3;
  --surface: #FFFFFF;
  --surface-2: #FAFAF7;
  --cream: #F5F2EC;
  --live: #2BB673;
  --blue: #2F7DD9;
  --violet: #7B5CD9;
  --red: #E5484D;
  --font: 'Plus Jakarta Sans', system-ui, -apple-system, sans-serif;
  --mono: 'JetBrains Mono', ui-monospace, monospace;
  --sidebar-w: 286px;
  --toc-w: 232px;
  --topbar-h: 64px;
}
* { box-sizing: border-box; -webkit-font-smoothing: antialiased; }
html { scroll-behavior: smooth; }
html, body { margin: 0; padding: 0; }
body {
  font-family: var(--font);
  color: var(--ink);
  background: var(--surface);
  font-feature-settings: 'cv11', 'ss01';
}
a { color: inherit; text-decoration: none; }
button { font-family: inherit; cursor: pointer; }
::selection { background: var(--o-soft); color: var(--o-deep); }

/* ── scrollbars ───────────────────────────────────────────────── */
* { scrollbar-width: thin; scrollbar-color: var(--line-2) transparent; }
*::-webkit-scrollbar { width: 9px; height: 9px; }
*::-webkit-scrollbar-thumb { background: var(--line-2); border-radius: 99px; border: 2px solid var(--surface); }
*::-webkit-scrollbar-thumb:hover { background: var(--ink-5); }

/* ════════════════ TOP BAR ════════════════ */
.topbar {
  position: fixed; top: 0; left: 0; right: 0; height: var(--topbar-h); z-index: 60;
  display: flex; align-items: center; gap: 22px; padding: 0 22px;
  background: rgba(255,255,255,0.82);
  backdrop-filter: blur(16px); -webkit-backdrop-filter: blur(16px);
  border-bottom: 1px solid var(--line);
}
.brand { display: flex; align-items: center; gap: 11px; font-weight: 800; letter-spacing: -0.01em; font-size: 18px; flex-shrink: 0; }
.brand-mark {
  width: 30px; height: 30px; border-radius: 9px;
  background: linear-gradient(135deg, var(--o) 0%, var(--o-deep) 100%);
  display: flex; align-items: center; justify-content: center;
  color: #fff; font-weight: 800; font-size: 13px; letter-spacing: -0.02em;
  box-shadow: 0 6px 18px -6px rgba(247,106,28,0.6);
}
.brand-sub {
  font-family: var(--mono); font-size: 11px; font-weight: 600; color: var(--ink-4);
  letter-spacing: 0.12em; text-transform: uppercase; padding-left: 12px; margin-left: 2px;
  border-left: 1px solid var(--line-2);
}
.topbar-spacer { flex: 1; }
.topbar-links { display: flex; gap: 24px; }
.topbar-links a {
  font-size: 13.5px; font-weight: 600; color: var(--ink-3); transition: color 160ms;
}
.topbar-links a:hover { color: var(--ink); }
.searchbtn {
  display: inline-flex; align-items: center; gap: 10px;
  background: var(--surface-2); border: 1px solid var(--line);
  border-radius: 11px; padding: 8px 12px; color: var(--ink-4);
  font-size: 13px; font-weight: 500; min-width: 210px; transition: border-color 160ms;
}
.searchbtn:hover { border-color: var(--line-2); }
.searchbtn svg { color: var(--ink-4); }
.searchbtn .kbd { margin-left: auto; }
.kbd {
  font-family: var(--mono); font-size: 10.5px; font-weight: 600; color: var(--ink-4);
  background: #fff; border: 1px solid var(--line); border-bottom-width: 2px;
  border-radius: 6px; padding: 2px 6px; line-height: 1;
}
.btn {
  font-size: 13.5px; font-weight: 700; padding: 9px 16px; border-radius: 999px;
  border: none; transition: all 160ms; white-space: nowrap;
}
.btn-primary { background: var(--ink); color: #fff; }
.btn-primary:hover { background: var(--o); box-shadow: 0 10px 22px -8px rgba(247,106,28,0.5); }
.hamburger {
  display: none; background: none; border: 1px solid var(--line);
  border-radius: 9px; width: 38px; height: 38px; align-items: center; justify-content: center;
}

/* ════════════════ LAYOUT SHELL ════════════════ */
.shell { display: flex; padding-top: var(--topbar-h); min-height: 100vh; }

/* ── Sidebar ── */
.sidebar {
  position: fixed; top: var(--topbar-h); bottom: 0; left: 0; width: var(--sidebar-w);
  border-right: 1px solid var(--line); background: var(--surface-2);
  overflow-y: auto; padding: 26px 0 60px;
}
.side-group { padding: 0 16px; margin-bottom: 26px; }
.side-group-title {
  font-family: var(--mono); font-size: 10.5px; font-weight: 700; letter-spacing: 0.12em;
  text-transform: uppercase; color: var(--ink-4); padding: 0 12px 8px;
}
.side-link {
  display: flex; align-items: center; gap: 11px;
  padding: 8px 12px; border-radius: 10px;
  font-size: 13.5px; font-weight: 600; color: var(--ink-3);
  transition: background 140ms, color 140ms; cursor: pointer;
}
.side-link .si {
  width: 17px; height: 17px; flex-shrink: 0; color: var(--ink-4); transition: color 140ms;
}
.side-link:hover { background: rgba(247,106,28,0.06); color: var(--ink); }
.side-link:hover .si { color: var(--o); }
.side-link.active { background: var(--o-soft); color: var(--o-deep); }
.side-link.active .si { color: var(--o); }
.side-num {
  margin-left: auto; font-family: var(--mono); font-size: 10px; font-weight: 600;
  color: var(--ink-5); font-variant-numeric: tabular-nums;
}

/* ── Main column ── */
.main {
  margin-left: var(--sidebar-w); margin-right: var(--toc-w);
  flex: 1; min-width: 0; padding: 0;
}
.content { max-width: 860px; margin: 0 auto; padding: 50px 56px 120px; position: relative; }

/* subtle IoT grid behind the article header — Falah: "feel alive" */
.content::before {
  content: ''; position: absolute; top: 0; left: 0; right: 0; height: 360px; z-index: -1;
  background-image:
    linear-gradient(rgba(11,13,15,0.04) 1px, transparent 1px),
    linear-gradient(90deg, rgba(11,13,15,0.04) 1px, transparent 1px);
  background-size: 48px 48px;
  mask-image: linear-gradient(180deg, #000 0%, transparent 100%);
  -webkit-mask-image: linear-gradient(180deg, #000 0%, transparent 100%);
  pointer-events: none;
}

/* ── Right TOC ── */
.toc {
  position: fixed; top: var(--topbar-h); right: 0; bottom: 0; width: var(--toc-w);
  padding: 50px 24px; overflow-y: auto;
}
.toc-title {
  font-family: var(--mono); font-size: 10.5px; font-weight: 700; letter-spacing: 0.12em;
  text-transform: uppercase; color: var(--ink-4); margin-bottom: 14px;
}
.toc a {
  display: block; font-size: 12.5px; font-weight: 500; color: var(--ink-4);
  padding: 5px 0 5px 12px; border-left: 2px solid var(--line);
  transition: color 140ms, border-color 140ms; line-height: 1.4;
}
.toc a:hover { color: var(--ink-2); }
.toc a.active { color: var(--o-deep); border-left-color: var(--o); font-weight: 600; }
.toc a.lvl3 { padding-left: 24px; font-size: 12px; }

/* ════════════════ ARTICLE TYPOGRAPHY ════════════════ */
.article { display: none; animation: fade 240ms ease; }
.article.active { display: block; }
@keyframes fade { from { opacity: 0; transform: translateY(6px); } to { opacity: 1; transform: none; } }

.eyebrow {
  display: inline-flex; align-items: center; gap: 8px;
  font-family: var(--mono); font-size: 11.5px; font-weight: 600; letter-spacing: 0.06em;
  color: var(--o-deep); text-transform: uppercase;
  padding: 6px 12px; border-radius: 999px; background: var(--o-soft);
  border: 1px solid rgba(247,106,28,0.18); margin-bottom: 18px;
}
.live-dot { width: 6px; height: 6px; border-radius: 50%; background: var(--o); position: relative; }
.live-dot::after {
  content: ''; position: absolute; inset: -2px; border-radius: 50%;
  background: var(--o); opacity: 0.4; animation: pulseRing 1.6s ease-out infinite;
}
@keyframes pulseRing { 0% { transform: scale(1); opacity: 0.45; } 100% { transform: scale(2.6); opacity: 0; } }

.article h1 {
  font-size: 42px; line-height: 1.08; letter-spacing: -0.03em; font-weight: 800;
  margin: 0 0 16px; color: var(--ink); text-wrap: balance;
}
.article .lede {
  font-size: 18px; line-height: 1.6; color: var(--ink-3); margin: 0 0 14px;
  max-width: 680px; text-wrap: pretty;
}
.article h2 {
  font-size: 27px; line-height: 1.2; letter-spacing: -0.02em; font-weight: 800;
  color: var(--ink); margin: 56px 0 16px; scroll-margin-top: 88px;
  padding-top: 24px; border-top: 1px solid var(--line);
}
.article h2:first-of-type { border-top: none; padding-top: 0; }
.article h3 {
  font-size: 18.5px; font-weight: 700; letter-spacing: -0.01em;
  color: var(--ink); margin: 34px 0 10px; scroll-margin-top: 88px;
}
.article h4 {
  font-family: var(--mono); font-size: 12px; font-weight: 700; letter-spacing: 0.06em;
  text-transform: uppercase; color: var(--ink-4); margin: 24px 0 8px;
}
.article p { font-size: 15.5px; line-height: 1.7; color: var(--ink-2); margin: 12px 0; }
.article a.link { color: var(--o-deep); font-weight: 600; border-bottom: 1px solid rgba(216,87,20,0.3); }
.article a.link:hover { border-bottom-color: var(--o-deep); }
.article ul, .article ol { padding-left: 22px; margin: 12px 0; }
.article li { font-size: 15.5px; line-height: 1.7; color: var(--ink-2); margin: 7px 0; }
.article li strong, .article p strong { color: var(--ink); font-weight: 700; }
.article hr { border: none; border-top: 1px solid var(--line); margin: 40px 0; }
code.inline {
  font-family: var(--mono); font-size: 0.86em; font-weight: 500;
  background: var(--o-soft); color: var(--o-deep);
  padding: 2px 7px; border-radius: 6px; white-space: nowrap;
}

/* ── Anchored heading hover-link ── */
.anchor { color: var(--ink-5); margin-left: 8px; opacity: 0; transition: opacity 140ms; font-weight: 400; }
.article h2:hover .anchor, .article h3:hover .anchor { opacity: 1; }

/* ════════════════ CONTENT BLOCKS ════════════════ */

/* Callout / admonition */
.callout {
  display: flex; gap: 14px; padding: 16px 18px; border-radius: 14px;
  margin: 22px 0; font-size: 14.5px; line-height: 1.6; border: 1px solid;
}
.callout-ic { width: 20px; height: 20px; flex-shrink: 0; margin-top: 1px; }
.callout p { margin: 0; font-size: 14.5px; }
.callout p + p { margin-top: 8px; }
.callout-title { font-weight: 800; display: block; margin-bottom: 3px; }
.callout.note   { background: #F3F7FC; border-color: #D6E4F5; color: #1F4E82; }
.callout.note .callout-ic { color: var(--blue); }
.callout.tip    { background: rgba(43,182,115,0.07); border-color: rgba(43,182,115,0.25); color: #1B7A4E; }
.callout.tip .callout-ic { color: var(--live); }
.callout.warn   { background: var(--o-soft); border-color: rgba(247,106,28,0.25); color: var(--o-deep); }
.callout.warn .callout-ic { color: var(--o); }
.callout.danger { background: rgba(229,72,77,0.06); border-color: rgba(229,72,77,0.25); color: #B4282C; }
.callout.danger .callout-ic { color: var(--red); }

/* Code block */
.code {
  background: #0B0D0F; color: #E2E4E9; border: 1px solid #1A1E24;
  border-radius: 16px; margin: 20px 0; position: relative; overflow: hidden;
}
.code-bar {
  display: flex; align-items: center; gap: 8px;
  font-family: var(--mono); font-size: 11px; color: #6F7682;
  padding: 12px 16px; border-bottom: 1px solid #1F242B;
}
.code-dot { width: 9px; height: 9px; border-radius: 50%; }
.code-file { margin-left: 8px; }
.code-lang {
  margin-left: auto; font-size: 10px; letter-spacing: 0.12em; text-transform: uppercase;
  color: #565D67;
}
.code-copy {
  background: rgba(255,255,255,0.06); border: 1px solid rgba(255,255,255,0.1);
  color: #9AA1AB; border-radius: 7px; padding: 4px 10px; font-size: 11px; font-weight: 600;
  font-family: var(--font); display: inline-flex; align-items: center; gap: 6px;
  transition: all 140ms;
}
.code-copy:hover { background: rgba(247,106,28,0.16); color: #fff; border-color: rgba(247,106,28,0.4); }
.code-copy.ok { color: var(--live); border-color: rgba(43,182,115,0.4); }
.code pre {
  margin: 0; padding: 18px 20px; overflow-x: auto;
  font-family: var(--mono); font-size: 13px; line-height: 1.75; tab-size: 2;
}
.code pre code { font-family: inherit; }
.tok-com { color: #6F7682; font-style: italic; }
.tok-kw  { color: #F8B981; }
.tok-str { color: #C8E5A0; }
.tok-num { color: #FFB47A; }
.tok-fn  { color: #F76A1C; }
.tok-key { color: #8FD0F0; }
.tok-punc{ color: #9AA1AB; }

/* Tables */
.table-wrap { margin: 20px 0; border: 1px solid var(--line); border-radius: 14px; overflow: hidden; overflow-x: auto; }
table { width: 100%; border-collapse: collapse; font-size: 14px; }
thead th {
  background: var(--surface-2); text-align: left; font-weight: 700; color: var(--ink-2);
  padding: 12px 16px; border-bottom: 1px solid var(--line);
  font-size: 12px; letter-spacing: 0.04em; text-transform: uppercase;
}
tbody td { padding: 12px 16px; border-bottom: 1px solid var(--line); color: var(--ink-2); vertical-align: top; }
tbody tr:last-child td { border-bottom: none; }
tbody tr:hover { background: var(--surface-2); }
td code, th code { font-family: var(--mono); font-size: 12.5px; color: var(--o-deep); background: var(--o-soft); padding: 1px 6px; border-radius: 5px; }
.method { font-family: var(--mono); font-weight: 700; font-size: 11px; padding: 3px 8px; border-radius: 6px; letter-spacing: 0.04em; }
.method.get  { background: rgba(43,182,115,0.12); color: #1B7A4E; }
.method.post { background: rgba(47,125,217,0.12); color: #1F4E82; }
.method.put  { background: var(--o-soft); color: var(--o-deep); }
.method.del  { background: rgba(229,72,77,0.1); color: #B4282C; }

/* Card grids */
.cards { display: grid; gap: 14px; margin: 22px 0; }
.cards.c2 { grid-template-columns: repeat(2, 1fr); }
.cards.c3 { grid-template-columns: repeat(3, 1fr); }
.cards.c4 { grid-template-columns: repeat(4, 1fr); }
.card {
  background: #fff; border: 1px solid var(--line); border-radius: 16px; padding: 20px;
  display: flex; flex-direction: column; gap: 8px;
  transition: transform 200ms ease, border-color 200ms, box-shadow 200ms;
}
a.card { cursor: pointer; }
a.card:hover { transform: translateY(-3px); border-color: var(--o); box-shadow: 0 18px 36px -22px rgba(11,13,15,0.22); }
.card-ic {
  width: 40px; height: 40px; border-radius: 11px; background: var(--o-soft); color: var(--o);
  display: flex; align-items: center; justify-content: center; margin-bottom: 4px;
}
.card-title { font-size: 15.5px; font-weight: 800; letter-spacing: -0.01em; color: var(--ink); }
.card-desc { font-size: 13px; line-height: 1.55; color: var(--ink-3); }
.card-more { margin-top: auto; padding-top: 6px; font-size: 12.5px; font-weight: 700; color: var(--o-deep); }

/* Step list */
.steps { counter-reset: step; margin: 24px 0; padding: 0; list-style: none; }
.steps > li {
  position: relative; padding: 0 0 26px 52px; margin: 0;
  border-left: 1.5px solid var(--line);
}
.steps > li:last-child { border-left-color: transparent; padding-bottom: 0; }
.steps > li::before {
  counter-increment: step; content: counter(step);
  position: absolute; left: -17px; top: -3px;
  width: 33px; height: 33px; border-radius: 50%;
  background: #fff; border: 1.5px solid var(--o); color: var(--o-deep);
  font-family: var(--mono); font-weight: 700; font-size: 13px;
  display: flex; align-items: center; justify-content: center;
}
.steps .step-title { font-size: 16px; font-weight: 800; color: var(--ink); margin: -2px 0 6px; }
.steps p { margin: 6px 0; }

/* Spec / pill rows */
.specs { display: flex; flex-wrap: wrap; gap: 9px; margin: 18px 0; }
.spec {
  display: inline-flex; align-items: center; gap: 8px;
  padding: 7px 13px; border-radius: 999px; background: #fff;
  border: 1px solid var(--line); font-size: 13px; font-weight: 600; color: var(--ink-2);
}
.spec .dot { width: 6px; height: 6px; border-radius: 50%; background: var(--o); }
.spec.live .dot { background: var(--live); }

/* Diagram frame */
.diagram {
  background: var(--surface-2); border: 1px solid var(--line); border-radius: 18px;
  padding: 26px; margin: 24px 0; position: relative; overflow: hidden;
}
.diagram::before {
  content: ''; position: absolute; inset: 0; pointer-events: none;
  background-image:
    linear-gradient(rgba(11,13,15,0.035) 1px, transparent 1px),
    linear-gradient(90deg, rgba(11,13,15,0.035) 1px, transparent 1px);
  background-size: 26px 26px;
}
.diagram svg { position: relative; display: block; width: 100%; height: auto; }
.diagram-cap {
  position: relative; margin-top: 14px; text-align: center;
  font-family: var(--mono); font-size: 11.5px; color: var(--ink-4); letter-spacing: 0.03em;
}

/* Big hero stat row */
.statrow { display: grid; grid-template-columns: repeat(4, 1fr); gap: 1px; background: var(--line);
  border: 1px solid var(--line); border-radius: 16px; overflow: hidden; margin: 24px 0; }
.stat { background: #fff; padding: 18px 20px; }
.stat-num { font-family: var(--mono); font-size: 26px; font-weight: 700; color: var(--ink); letter-spacing: -0.02em; }
.stat-num .u { color: var(--o); }
.stat-lbl { font-size: 11.5px; color: var(--ink-4); margin-top: 3px; letter-spacing: 0.06em; text-transform: uppercase; font-weight: 600; }

/* Pager */
.pager { display: flex; gap: 14px; margin-top: 64px; padding-top: 28px; border-top: 1px solid var(--line); }
.pager a {
  flex: 1; border: 1px solid var(--line); border-radius: 14px; padding: 16px 18px;
  transition: border-color 160ms, transform 160ms; background: #fff;
}
.pager a:hover { border-color: var(--o); transform: translateY(-2px); }
.pager .pg-dir { font-family: var(--mono); font-size: 11px; color: var(--ink-4); letter-spacing: 0.06em; text-transform: uppercase; }
.pager .pg-title { font-size: 15px; font-weight: 800; color: var(--ink); margin-top: 4px; }
.pager .next { text-align: right; }

/* FAQ */
.faq { border: 1px solid var(--line); border-radius: 14px; overflow: hidden; margin: 22px 0; }
.faq details { border-bottom: 1px solid var(--line); }
.faq details:last-child { border-bottom: none; }
.faq summary {
  list-style: none; cursor: pointer; padding: 16px 20px;
  font-size: 15px; font-weight: 700; color: var(--ink);
  display: flex; align-items: center; justify-content: space-between; gap: 16px;
}
.faq summary::-webkit-details-marker { display: none; }
.faq summary::after { content: '+'; font-family: var(--mono); font-size: 18px; color: var(--o); transition: transform 200ms; }
.faq details[open] summary::after { transform: rotate(45deg); }
.faq .faq-body { padding: 0 20px 18px; font-size: 14.5px; line-height: 1.65; color: var(--ink-2); }
.faq .faq-body p { margin: 6px 0; font-size: 14.5px; }

/* ════════════════ SEARCH MODAL ════════════════ */
.search-overlay {
  position: fixed; inset: 0; z-index: 100; display: none;
  background: rgba(11,13,15,0.4); backdrop-filter: blur(4px);
  align-items: flex-start; justify-content: center; padding-top: 12vh;
}
.search-overlay.open { display: flex; }
.search-modal {
  width: min(620px, 92vw); background: #fff; border-radius: 18px;
  border: 1px solid var(--line); box-shadow: 0 40px 90px -30px rgba(11,13,15,0.45);
  overflow: hidden; animation: pop 180ms ease;
}
@keyframes pop { from { transform: scale(0.97) translateY(-6px); opacity: 0; } to { transform: none; opacity: 1; } }
.search-head { display: flex; align-items: center; gap: 12px; padding: 16px 20px; border-bottom: 1px solid var(--line); }
.search-head svg { color: var(--ink-4); flex-shrink: 0; }
.search-input {
  flex: 1; border: none; outline: none; font-family: var(--font);
  font-size: 16px; color: var(--ink); background: transparent;
}
.search-input::placeholder { color: var(--ink-5); }
.search-results { max-height: 56vh; overflow-y: auto; padding: 8px; }
.search-empty { padding: 36px 20px; text-align: center; color: var(--ink-4); font-size: 14px; }
.sr {
  display: block; padding: 11px 14px; border-radius: 11px; cursor: pointer;
}
.sr:hover, .sr.sel { background: var(--o-soft); }
.sr-sec { font-family: var(--mono); font-size: 10.5px; font-weight: 600; color: var(--o-deep); letter-spacing: 0.06em; text-transform: uppercase; }
.sr-title { font-size: 14.5px; font-weight: 700; color: var(--ink); margin-top: 2px; }
.sr-snip { font-size: 12.5px; color: var(--ink-4); margin-top: 2px; line-height: 1.45; }
.search-foot {
  display: flex; gap: 18px; padding: 10px 18px; border-top: 1px solid var(--line);
  font-size: 11.5px; color: var(--ink-4);
}
.search-foot span { display: inline-flex; align-items: center; gap: 6px; }

/* ════════════════ MOBILE ════════════════ */
.scrim { display: none; position: fixed; inset: 0; top: var(--topbar-h); background: rgba(11,13,15,0.4); z-index: 45; }
@media (max-width: 1180px) {
  :root { --toc-w: 0px; }
  .toc { display: none; }
}
@media (max-width: 920px) {
  .topbar-links { display: none; }
  .searchbtn { min-width: 0; }
  .searchbtn .stxt, .searchbtn .kbd { display: none; }
  .hamburger { display: inline-flex; }
  .brand-sub { display: none; }
  .sidebar {
    transform: translateX(-100%); transition: transform 240ms ease;
    z-index: 50; box-shadow: 0 20px 60px -20px rgba(0,0,0,0.3);
  }
  .sidebar.open { transform: none; }
  .scrim.open { display: block; }
  .main { margin-left: 0; margin-right: 0; }
  .content { padding: 34px 22px 90px; }
  .article h1 { font-size: 32px; }
  .article h2 { font-size: 23px; }
  .cards.c2, .cards.c3, .cards.c4 { grid-template-columns: 1fr; }
  .statrow { grid-template-columns: 1fr 1fr; }
  .pager { flex-direction: column; }
}