/* ==========================================================================
   MSEMAX Docs — shared stylesheet
   Dark Mode (OLED) / slate + run-green. Tokens mirror the /admin dashboard so
   the docs and the console feel like one product.
   ========================================================================== */
:root {
  --bg:            #0F172A;
  --surface:       #1E293B;
  --surface-2:     #172033;
  --muted:         #272F42;
  --border:        #334155;
  --border-strong: #475569;

  --fg:            #F8FAFC;
  --fg-muted:      #94A3B8;
  --fg-subtle:     #64748B;

  --accent:        #22C55E;
  --accent-dim:    #16A34A;
  --warn:          #F59E0B;
  --danger:        #EF4444;

  --radius-sm: 6px;
  --radius:    10px;
  --radius-lg: 14px;

  --space-1: 4px;  --space-2: 8px;  --space-3: 12px;
  --space-4: 16px; --space-5: 24px; --space-6: 32px; --space-7: 48px;

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

  --dur: 180ms;
  --ease: cubic-bezier(0.4, 0, 0.2, 1);

  --sidebar-w: 264px;
  --z-sidebar: 40;
  --z-topbar: 30;
  --z-overlay: 35;
  --z-toast: 1000;
}

*, *::before, *::after { box-sizing: border-box; }
[hidden] { display: none !important; }
html { -webkit-text-size-adjust: 100%; scroll-behavior: smooth; }

body {
  margin: 0;
  background: var(--bg);
  color: var(--fg);
  font-family: var(--font-sans);
  font-size: 16px;
  line-height: 1.6;
  min-height: 100dvh;
}

.tabular { font-variant-numeric: tabular-nums; font-family: var(--font-mono); }

:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
  border-radius: var(--radius-sm);
}

@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    transition-duration: 0.01ms !important;
  }
}

/* Skip link for keyboard users */
.skip-link {
  position: fixed; top: -60px; left: var(--space-3);
  background: var(--accent); color: #04240f; font-weight: 600;
  padding: var(--space-2) var(--space-4); border-radius: var(--radius);
  z-index: var(--z-toast); transition: top var(--dur) var(--ease);
}
.skip-link:focus { top: var(--space-3); }

/* ==========================================================================
   Layout — sidebar + content
   ========================================================================== */
.doc-layout { display: block; }

.doc-sidebar {
  position: fixed; top: 0; left: 0; bottom: 0;
  width: var(--sidebar-w);
  background: var(--surface-2);
  border-right: 1px solid var(--border);
  z-index: var(--z-sidebar);
  display: flex; flex-direction: column;
  transform: translateX(-100%);
  transition: transform var(--dur) var(--ease);
  overflow: hidden;
}
.doc-sidebar.open { transform: translateX(0); }

.doc-brand {
  display: flex; align-items: center; gap: var(--space-3);
  padding: var(--space-4) var(--space-4);
  border-bottom: 1px solid var(--border);
  text-decoration: none; color: var(--fg); flex: none;
}
.doc-brand-mark {
  width: 38px; height: 38px; flex: none;
  display: grid; place-items: center;
  background: var(--surface); border: 1px solid var(--border);
  border-radius: var(--radius); color: var(--accent);
}
.doc-brand-txt h1 { margin: 0; font-size: 1rem; font-weight: 600; letter-spacing: 0.02em; }
.doc-brand-txt p { margin: 0; font-size: 0.75rem; color: var(--fg-muted); }

.doc-nav {
  flex: 1 1 auto; overflow-y: auto;
  padding: var(--space-4) var(--space-3) var(--space-6);
}
.doc-nav-group { margin-bottom: var(--space-5); }
.doc-nav-group h3 {
  margin: 0 0 var(--space-2); padding: 0 var(--space-3);
  font-size: 0.6875rem; font-weight: 600; letter-spacing: 0.08em;
  text-transform: uppercase; color: var(--fg-subtle);
}
.doc-nav a {
  display: flex; align-items: center; gap: var(--space-2);
  padding: var(--space-2) var(--space-3);
  min-height: 40px;
  color: var(--fg-muted); text-decoration: none;
  border-radius: var(--radius-sm); font-size: 0.9rem;
  transition: background var(--dur) var(--ease), color var(--dur) var(--ease);
}
.doc-nav a:hover { background: var(--muted); color: var(--fg); }
.doc-nav a.active {
  background: rgba(34,197,94,0.12); color: var(--accent);
  box-shadow: inset 2px 0 0 var(--accent);
}
.doc-nav a svg { flex: none; opacity: 0.9; }

.doc-sidebar-foot {
  flex: none; padding: var(--space-3) var(--space-4);
  border-top: 1px solid var(--border);
}
.doc-back {
  display: inline-flex; align-items: center; gap: var(--space-2);
  color: var(--fg-muted); text-decoration: none; font-size: 0.85rem;
  min-height: 40px;
}
.doc-back:hover { color: var(--accent); }

/* Content column */
.doc-content-wrap { min-height: 100dvh; }

.doc-topbar {
  position: sticky; top: 0; z-index: var(--z-topbar);
  display: flex; align-items: center; gap: var(--space-3);
  padding: var(--space-3) var(--space-4);
  background: rgba(15,23,42,0.85);
  backdrop-filter: blur(10px);
  border-bottom: 1px solid var(--border);
}
.hamburger {
  display: inline-grid; place-items: center;
  width: 44px; height: 44px; flex: none;
  background: var(--surface); border: 1px solid var(--border);
  border-radius: var(--radius); color: var(--fg); cursor: pointer;
}
.hamburger:hover { background: var(--muted); border-color: var(--border-strong); }
.doc-topbar-title { font-size: 0.9rem; font-weight: 600; color: var(--fg-muted); }
.doc-topbar-spacer { flex: 1; }
.doc-topbar .doc-back { display: inline-flex; }

.doc-main {
  max-width: 860px; margin: 0 auto;
  padding: var(--space-6) var(--space-4) var(--space-7);
}

/* Off-canvas overlay (mobile) */
.doc-overlay {
  position: fixed; inset: 0; background: rgba(2,6,23,0.6);
  z-index: var(--z-overlay); opacity: 0; pointer-events: none;
  transition: opacity var(--dur) var(--ease);
}
.doc-overlay.show { opacity: 1; pointer-events: auto; }

/* Desktop: pin the sidebar open, inset the content */
@media (min-width: 1024px) {
  .doc-sidebar { transform: none; }
  .doc-content-wrap { margin-left: var(--sidebar-w); }
  .hamburger { display: none; }
  .doc-overlay { display: none; }
  .doc-topbar { background: rgba(15,23,42,0.7); }
}

/* ==========================================================================
   Prose
   ========================================================================== */
.prose { color: var(--fg); }
.prose > *:first-child { margin-top: 0; }

.eyebrow {
  display: inline-block; margin-bottom: var(--space-2);
  font-size: 0.72rem; font-weight: 600; letter-spacing: 0.1em;
  text-transform: uppercase; color: var(--accent);
}
.prose h1 {
  margin: 0 0 var(--space-3); font-size: clamp(1.75rem, 4vw, 2.25rem);
  font-weight: 700; line-height: 1.15; letter-spacing: -0.01em;
}
.prose .lead {
  margin: 0 0 var(--space-6); font-size: 1.075rem;
  color: var(--fg-muted); max-width: 68ch; line-height: 1.6;
}
.prose h2 {
  margin: var(--space-7) 0 var(--space-3); padding-top: var(--space-3);
  font-size: 1.35rem; font-weight: 650; line-height: 1.25;
  border-top: 1px solid var(--border);
}
.prose h2:first-of-type { border-top: 0; padding-top: 0; margin-top: var(--space-5); }
.prose h3 { margin: var(--space-5) 0 var(--space-2); font-size: 1.075rem; font-weight: 600; }
.prose p { margin: 0 0 var(--space-4); max-width: 72ch; }
.prose ul, .prose ol { margin: 0 0 var(--space-4); padding-left: var(--space-5); max-width: 72ch; }
.prose li { margin-bottom: var(--space-2); }
.prose li::marker { color: var(--fg-subtle); }
.prose a { color: var(--accent); text-decoration: none; border-bottom: 1px solid rgba(34,197,94,0.3); }
.prose a:hover { border-bottom-color: var(--accent); }
.prose strong { color: var(--fg); font-weight: 650; }
.prose hr { border: 0; border-top: 1px solid var(--border); margin: var(--space-6) 0; }

/* Inline code */
.prose :not(pre) > code {
  font-family: var(--font-mono); font-size: 0.85em;
  background: var(--muted); color: #E2E8F0;
  padding: 0.15em 0.4em; border-radius: var(--radius-sm);
  border: 1px solid var(--border);
  word-break: break-word;
}

kbd {
  font-family: var(--font-mono); font-size: 0.8em;
  background: var(--surface); border: 1px solid var(--border-strong);
  border-bottom-width: 2px; border-radius: var(--radius-sm);
  padding: 0.1em 0.45em; color: var(--fg);
}

/* ==========================================================================
   Code blocks with copy button
   ========================================================================== */
.code {
  position: relative; margin: 0 0 var(--space-4);
  background: var(--surface-2); border: 1px solid var(--border);
  border-radius: var(--radius); overflow: hidden;
}
.code-head {
  display: flex; align-items: center; justify-content: space-between;
  padding: var(--space-2) var(--space-2) var(--space-2) var(--space-4);
  border-bottom: 1px solid var(--border);
  background: var(--surface);
}
.code-lang {
  font-size: 0.72rem; font-weight: 600; letter-spacing: 0.06em;
  text-transform: uppercase; color: var(--fg-subtle);
}
.code pre {
  margin: 0; padding: var(--space-4);
  overflow-x: auto; font-family: var(--font-mono);
  font-size: 0.85rem; line-height: 1.6; color: #E2E8F0;
}
.code pre code { font-family: inherit; }

.copy-btn {
  display: inline-flex; align-items: center; justify-content: center; gap: 6px;
  min-height: 32px; padding: 0 var(--space-2);
  font-family: inherit; font-size: 0.75rem; font-weight: 500;
  color: var(--fg-muted); background: transparent;
  border: 1px solid var(--border); border-radius: var(--radius-sm);
  cursor: pointer;
  transition: color var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
.copy-btn:hover { color: var(--fg); border-color: var(--border-strong); }
.copy-btn.copied { color: var(--accent); border-color: rgba(34,197,94,0.4); }

/* ==========================================================================
   Callouts
   ========================================================================== */
.callout {
  display: flex; gap: var(--space-3);
  padding: var(--space-4);
  margin: 0 0 var(--space-4);
  border: 1px solid var(--border); border-left-width: 3px;
  border-radius: var(--radius); background: var(--surface);
}
.callout .callout-icon { flex: none; margin-top: 2px; }
.callout p { margin: 0; max-width: none; }
.callout p + p { margin-top: var(--space-2); }
.callout.note { border-left-color: var(--accent); }
.callout.note .callout-icon { color: var(--accent); }
.callout.warn { border-left-color: var(--warn); }
.callout.warn .callout-icon { color: var(--warn); }
.callout.danger { border-left-color: var(--danger); }
.callout.danger .callout-icon { color: var(--danger); }

/* ==========================================================================
   Cards (overview grid)
   ========================================================================== */
.cards {
  display: grid; gap: var(--space-4);
  grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
  margin: 0 0 var(--space-5);
}
.card {
  display: flex; flex-direction: column; gap: var(--space-2);
  padding: var(--space-4);
  background: var(--surface); border: 1px solid var(--border);
  border-radius: var(--radius); text-decoration: none; color: var(--fg);
  transition: border-color var(--dur) var(--ease), transform var(--dur) var(--ease), background var(--dur) var(--ease);
}
.card:hover { border-color: var(--border-strong); background: var(--muted); transform: translateY(-2px); }
.card-icon {
  width: 40px; height: 40px; display: grid; place-items: center;
  background: var(--surface-2); border: 1px solid var(--border);
  border-radius: var(--radius); color: var(--accent); margin-bottom: var(--space-1);
}
.card h3 { margin: 0; font-size: 1rem; font-weight: 600; }
.card p { margin: 0; font-size: 0.875rem; color: var(--fg-muted); max-width: none; }

/* ==========================================================================
   Steps (numbered)
   ========================================================================== */
.steps { list-style: none; margin: 0 0 var(--space-5); padding: 0; counter-reset: step; }
.steps > li {
  position: relative; padding-left: 46px; margin-bottom: var(--space-5);
  max-width: 72ch;
}
.steps > li::before {
  counter-increment: step; content: counter(step);
  position: absolute; left: 0; top: -2px;
  width: 30px; height: 30px; display: grid; place-items: center;
  background: var(--surface); border: 1px solid var(--accent-dim);
  color: var(--accent); border-radius: 50%;
  font-family: var(--font-mono); font-size: 0.85rem; font-weight: 600;
}
.steps > li h3 { margin: 4px 0 var(--space-2); }
.steps > li p { margin-bottom: var(--space-3); }

/* ==========================================================================
   Tables
   ========================================================================== */
.table-wrap { overflow-x: auto; margin: 0 0 var(--space-4); border: 1px solid var(--border); border-radius: var(--radius); }
table { width: 100%; border-collapse: collapse; font-size: 0.875rem; min-width: 460px; }
thead th {
  text-align: left; padding: var(--space-3) var(--space-4);
  background: var(--surface); color: var(--fg-muted);
  font-weight: 600; font-size: 0.78rem; text-transform: uppercase; letter-spacing: 0.04em;
  border-bottom: 1px solid var(--border);
}
tbody td { padding: var(--space-3) var(--space-4); border-bottom: 1px solid var(--border); vertical-align: top; }
tbody tr:last-child td { border-bottom: 0; }
tbody td code { white-space: nowrap; }

/* ==========================================================================
   Method / endpoint pill
   ========================================================================== */
.endpoint {
  display: flex; flex-wrap: wrap; align-items: center; gap: var(--space-3);
  padding: var(--space-3) var(--space-4);
  background: var(--surface-2); border: 1px solid var(--border);
  border-radius: var(--radius); margin: 0 0 var(--space-4);
  font-family: var(--font-mono);
}
.method {
  font-size: 0.72rem; font-weight: 700; letter-spacing: 0.05em;
  padding: 4px 10px; border-radius: var(--radius-sm); color: #04240f;
}
.method.post { background: var(--accent); }
.method.get { background: #38BDF8; }
.method.put { background: var(--warn); }
.method.delete { background: var(--danger); color: #fff; }
.endpoint .path { font-size: 0.9rem; color: var(--fg); word-break: break-all; }

/* Page footer nav (prev/next) */
.page-nav {
  display: flex; flex-wrap: wrap; gap: var(--space-3);
  justify-content: space-between; margin-top: var(--space-7);
  padding-top: var(--space-5); border-top: 1px solid var(--border);
}
.page-nav a {
  display: flex; flex-direction: column; gap: 2px;
  padding: var(--space-3) var(--space-4); min-width: 160px;
  background: var(--surface); border: 1px solid var(--border);
  border-radius: var(--radius); text-decoration: none; color: var(--fg);
  transition: border-color var(--dur) var(--ease);
}
.page-nav a:hover { border-color: var(--border-strong); }
.page-nav a.next { text-align: right; margin-left: auto; }
.page-nav span { font-size: 0.72rem; color: var(--fg-subtle); text-transform: uppercase; letter-spacing: 0.05em; }
.page-nav strong { font-size: 0.95rem; font-weight: 600; }

/* ==========================================================================
   Toast
   ========================================================================== */
.toast {
  position: fixed; bottom: var(--space-5); left: 50%; transform: translateX(-50%) translateY(20px);
  background: var(--surface); border: 1px solid var(--border-strong);
  color: var(--fg); padding: var(--space-3) var(--space-4);
  border-radius: var(--radius); font-size: 0.875rem;
  box-shadow: 0 10px 30px rgba(0,0,0,0.4);
  opacity: 0; pointer-events: none; z-index: var(--z-toast);
  transition: opacity var(--dur) var(--ease), transform var(--dur) var(--ease);
}
.toast.show { opacity: 1; transform: translateX(-50%) translateY(0); }
.toast.error { border-color: rgba(239,68,68,0.5); }

.sr-only {
  position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px;
  overflow: hidden; clip: rect(0,0,0,0); white-space: nowrap; border: 0;
}