/* ══════════════════════════════════════════════════════
   SYLPHY DOCS — docs.css
   Professional agent documentation stylesheet.
   Standalone — no dependency on styles.css.
   Inspired by: HYRE (docs.hyreagent.fun) + Xona Agent
   ══════════════════════════════════════════════════════ */

/* ── Google Fonts fallback (loaded in HTML) ── */
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;700&family=Orbitron:wght@500;600;700;800&family=Share+Tech+Mono&display=swap');

/* ── Design tokens ── */
:root {
  color-scheme: dark;

  /* Backgrounds */
  --bg:          #050807;
  --surface:     #0a0f0c;
  --surface-2:   #0f1610;
  --surface-3:   #141c15;
  --glass:       rgba(10,15,12,0.7);

  /* Brand */
  --acid:        #b6ff00;
  --acid-glow:   rgba(182,255,0,0.15);
  --acid-dim:    rgba(182,255,0,0.09);
  --acid-border: rgba(182,255,0,0.16);
  --acid-strong: rgba(182,255,0,0.28);

  /* Text */
  --ink:         #edf0e4;
  --ink-2:       rgba(237,240,228,0.72);
  --ink-3:       rgba(237,240,228,0.45);
  --ink-4:       rgba(237,240,228,0.28);

  /* Status */
  --ok:          #5cffa0;
  --warn:        #f0b429;
  --info:        #7ab8ff;
  --bad:         #ff6b6b;

  /* Typography */
  --font-sans:   'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
  --font-mono:   'Share Tech Mono', 'JetBrains Mono', 'Courier New', monospace;
  --font-display:'Orbitron', 'Share Tech Mono', 'JetBrains Mono', monospace;

  /* Layout */
  --sidebar-w:   260px;
  --toc-w:       210px;
  --header-h:    58px;
  --radius:      8px;
  --radius-sm:   5px;
  --radius-lg:   12px;

  /* Motion */
  --ease:        cubic-bezier(0.22, 1, 0.36, 1);
  --t:           0.15s ease;
  --t-med:       0.25s ease;
}

/* ── Reset ── */
*, *::before, *::after {
  box-sizing: border-box;
  margin: 0;
  padding: 0;
}
html {
  scroll-behavior: smooth;
  font-size: 15px;
}
body {
  background: var(--bg);
  color: var(--ink);
  font-family: var(--font-sans);
  line-height: 1.65;
  overflow-x: hidden;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}
a {
  color: inherit;
  text-decoration: none;
}
button {
  cursor: pointer;
  font-family: inherit;
}
code {
  font-family: var(--font-mono);
  font-size: 0.82em;
  background: var(--surface-2);
  border: 1px solid var(--acid-border);
  border-radius: var(--radius-sm);
  padding: 1px 6px;
  color: var(--acid);
}
strong {
  color: var(--ink);
  font-weight: 600;
}

/* ── Reading progress bar ── */
.docs-progress {
  background: linear-gradient(90deg, var(--acid), rgba(182,255,0,0.6));
  box-shadow: 0 0 16px rgba(182,255,0,0.4);
  height: 2px;
  left: 0;
  position: fixed;
  top: 0;
  transform-origin: left;
  transform: scaleX(0);
  width: 100%;
  z-index: 300;
  transition: transform 0.1s linear;
}

/* ══════════════════════════
   TOPBAR
   ══════════════════════════ */
.docs-topbar {
  align-items: center;
  background: rgba(5,8,7,0.85);
  backdrop-filter: blur(20px) saturate(160%);
  -webkit-backdrop-filter: blur(20px) saturate(160%);
  border-bottom: 1px solid rgba(182,255,0,0.1);
  display: flex;
  gap: 1rem;
  height: var(--header-h);
  left: 0;
  padding: 0 1.5rem;
  position: fixed;
  right: 0;
  top: 0;
  z-index: 100;
  transition: border-color var(--t), background var(--t-med);
}
.docs-topbar.scrolled {
  border-bottom-color: rgba(182,255,0,0.18);
  box-shadow: 0 1px 40px rgba(0,0,0,0.4);
}

.docs-logo {
  align-items: center;
  color: var(--ink);
  display: flex;
  font-family: var(--font-mono);
  font-size: 0.88rem;
  font-weight: 400;
  gap: 0.5rem;
  letter-spacing: 0.04em;
  text-decoration: none;
  white-space: nowrap;
  flex-shrink: 0;
}
.docs-logo img {
  border-radius: var(--radius-sm);
  height: 28px;
  object-fit: cover;
  width: 28px;
}
.docs-logo-name {
  color: var(--acid);
  letter-spacing: 0.12em;
}
/* Search bar */
.docs-topbar-search {
  align-items: center;
  background: var(--surface);
  border: 1px solid rgba(182,255,0,0.12);
  border-radius: var(--radius);
  display: flex;
  flex: 0 0 clamp(160px, 26vw, 300px);
  gap: 0.5rem;
  margin-left: auto;
  padding: 0.42rem 0.75rem;
  transition: border-color var(--t), box-shadow var(--t);
}
.docs-topbar-search:focus-within {
  border-color: var(--acid);
  box-shadow: 0 0 0 3px var(--acid-glow);
}
.docs-search-icon {
  color: var(--ink-3);
  display: flex;
  flex-shrink: 0;
}
.docs-topbar-search input {
  background: none;
  border: none;
  color: var(--ink);
  font-family: var(--font-mono);
  font-size: 0.78rem;
  letter-spacing: 0.03em;
  outline: none;
  width: 100%;
}
.docs-topbar-search input::placeholder {
  color: var(--ink-4);
}

/* Topbar actions */
.docs-topbar-actions {
  align-items: center;
  display: flex;
  gap: 0.6rem;
}
.docs-topbar-link {
  color: var(--ink-3);
  font-family: var(--font-mono);
  font-size: 0.78rem;
  font-weight: 400;
  letter-spacing: 0.1em;
  padding: 0.3rem 0.6rem;
  transition: color var(--t);
}
.docs-topbar-link:hover {
  color: var(--ink);
}
.docs-topbar-cta {
  align-items: center;
  background: var(--acid);
  border-radius: var(--radius);
  color: #050807;
  display: flex;
  font-family: var(--font-mono);
  font-size: 0.75rem;
  font-weight: 400;
  gap: 0.4rem;
  letter-spacing: 0.1em;
  padding: 0.38rem 0.85rem;
  transition: opacity var(--t), box-shadow var(--t), transform var(--t);
  white-space: nowrap;
}
.docs-topbar-cta:hover {
  box-shadow: 0 0 20px rgba(182,255,0,0.35);
  opacity: 0.9;
  transform: translateY(-1px);
}

/* Mobile menu toggle */
.docs-menu-toggle {
  align-items: center;
  background: none;
  border: 1px solid var(--acid-border);
  border-radius: var(--radius-sm);
  color: var(--ink-2);
  display: none;
  justify-content: center;
  padding: 0.38rem;
}

/* Kbd badge */
.docs-kbd {
  background: var(--surface-2);
  border: 1px solid var(--acid-border);
  border-radius: var(--radius-sm);
  color: var(--ink-4);
  font-family: var(--font-mono);
  font-size: 0.6rem;
  letter-spacing: 0.04em;
  padding: 2px 6px;
  white-space: nowrap;
}

/* ══════════════════════════
   PAGE LAYOUT
   ══════════════════════════ */
.docs-page {
  display: grid;
  grid-template-columns: var(--sidebar-w) 1fr var(--toc-w);
  margin-top: var(--header-h);
  min-height: calc(100vh - var(--header-h));
}

/* ══════════════════════════
   SIDEBAR
   ══════════════════════════ */
.docs-sidebar {
  background: var(--surface);
  border-right: 1px solid rgba(182,255,0,0.1);
  display: flex;
  flex-direction: column;
  grid-column: 1;
  grid-row: 1 / span 2;
  height: calc(100vh - var(--header-h));
  left: 0;
  overflow-y: auto;
  padding: 1.5rem 0 0;
  position: sticky;
  top: var(--header-h);
  scrollbar-width: thin;
  scrollbar-color: var(--acid-border) transparent;
}
.docs-sidebar nav {
  flex: 1 0 auto;
  padding-bottom: 1rem;
}
.docs-sidebar::-webkit-scrollbar { width: 3px; }
.docs-sidebar::-webkit-scrollbar-thumb { background: var(--acid-border); border-radius: 2px; }

.docs-nav-group {
  margin-bottom: 0.1rem;
}
.docs-nav-group-title {
  color: rgba(237,240,228,0.38);
  font-family: var(--font-mono);
  font-size: 0.67rem;
  font-weight: 400;
  letter-spacing: 0.16em;
  padding: 1.1rem 1.25rem 0.4rem;
  text-transform: uppercase;
}
.docs-nav-item {
  align-items: center;
  border-left: 2px solid transparent;
  color: var(--ink-3);
  display: flex;
  font-family: var(--font-mono);
  font-size: 0.8rem;
  font-weight: 400;
  gap: 0.55rem;
  padding: 0.5rem 1.25rem;
  transition: color var(--t), border-color var(--t), background var(--t);
}
.docs-nav-item:focus-visible {
  outline: 2px solid var(--acid);
  outline-offset: -2px;
}
.docs-nav-item .nav-icon {
  color: var(--ink-4);
  flex-shrink: 0;
  transition: color var(--t);
}
.docs-nav-item:hover {
  background: var(--acid-dim);
  color: var(--ink);
}
.docs-nav-item:hover .nav-icon {
  color: var(--acid);
}
.docs-nav-item.active {
  border-left-color: var(--acid);
  color: var(--acid);
  font-weight: 400;
}
.docs-nav-item.active .nav-icon {
  color: var(--acid);
}
/* Mobile overlay */
.docs-sidebar-overlay {
  background: rgba(5,8,7,0.75);
  display: none;
  inset: 0;
  position: fixed;
  z-index: 89;
}
.docs-sidebar-overlay.open { display: block; }

/* ══════════════════════════
   MAIN CONTENT
   ══════════════════════════ */
.docs-main {
  grid-column: 2;
  grid-row: 1;
  min-width: 0;
  padding: 3rem 3rem 6rem;
}

/* Section */
.docs-section {
  margin-bottom: 5rem;
  max-width: 960px;
  /* Default: visible. JS adds .js-anim-ready to body to opt into animations */
  opacity: 1;
  transform: none;
  scroll-margin-top: calc(var(--header-h) + 1.5rem);
}
.docs-section[hidden] {
  display: none;
}
/* Only animate when JS is active and confirmed ready */
.js-anim-ready .docs-section {
  opacity: 0;
  transform: translateY(20px);
  transition: opacity 0.55s var(--ease), transform 0.55s var(--ease);
}
.js-anim-ready .docs-section.revealed {
  opacity: 1;
  transform: translateY(0);
}

/* Category label */
.docs-category {
  color: var(--acid);
  font-family: var(--font-mono);
  font-size: 0.65rem;
  font-weight: 400;
  letter-spacing: 0.2em;
  margin-bottom: 0.6rem;
  text-transform: uppercase;
}

/* Headings */
.docs-h1 {
  color: var(--ink);
  font-family: var(--font-display);
  font-size: clamp(1.65rem, 3.5vw, 2.25rem);
  font-weight: 600;
  letter-spacing: 0.03em;
  line-height: 1.15;
  margin-bottom: 0.85rem;
}
.docs-h1 .hl {
  color: var(--acid);
}

.docs-lead {
  color: var(--ink-2);
  font-size: 0.97rem;
  line-height: 1.8;
  margin-bottom: 2rem;
  max-width: 640px;
}

.docs-h2 {
  color: var(--ink);
  font-family: var(--font-mono);
  font-size: 1.1rem;
  font-weight: 400;
  letter-spacing: 0.04em;
  margin: 2.5rem 0 0.9rem;
  scroll-margin-top: calc(var(--header-h) + 1rem);
}
.docs-h2::before {
  color: var(--acid);
  content: "// ";
  font-family: var(--font-mono);
  font-size: 0.85em;
  font-weight: 400;
  opacity: 0.6;
}

.docs-p {
  color: var(--ink-2);
  font-size: 0.9rem;
  line-height: 1.85;
  margin-bottom: 1rem;
  max-width: 680px;
}

.docs-h3 {
  color: var(--ink);
  font-family: var(--font-mono);
  font-size: 0.84rem;
  font-weight: 400;
  letter-spacing: 0.04em;
  margin: 1.35rem 0 0.65rem;
}

/* Divider */
.docs-divider {
  border: none;
  border-top: 1px solid rgba(182,255,0,0.08);
  margin: 2rem 0;
}
.docs-page.single-section .docs-divider {
  display: none;
}

/* Heading anchor */
.docs-anchor {
  color: var(--acid);
  font-size: 0.65em;
  margin-left: 0.4rem;
  opacity: 0;
  text-decoration: none;
  transition: opacity var(--t);
  vertical-align: middle;
}
.docs-h1:hover .docs-anchor,
.docs-h2:hover .docs-anchor { opacity: 0.6; }
.docs-anchor:hover { opacity: 1 !important; }

/* ══════════════════════════
   CALLOUTS
   ══════════════════════════ */
.docs-callout {
  align-items: flex-start;
  background: var(--acid-dim);
  border: 1px solid var(--acid-border);
  border-left: 3px solid var(--acid);
  border-radius: 0 var(--radius) var(--radius) 0;
  display: flex;
  gap: 0.85rem;
  margin: 1.5rem 0;
  padding: 1.1rem 1.25rem;
}
.docs-callout-lower {
  margin-top: 2rem;
}
.docs-callout.warn {
  background: rgba(240,180,41,0.07);
  border-color: rgba(240,180,41,0.2);
  border-left-color: var(--warn);
}
.docs-callout.info {
  background: rgba(122,184,255,0.06);
  border-color: rgba(122,184,255,0.15);
  border-left-color: var(--info);
}
.docs-callout-icon {
  color: var(--acid);
  flex-shrink: 0;
  margin-top: 2px;
}
.docs-callout.warn .docs-callout-icon { color: var(--warn); }
.docs-callout.info .docs-callout-icon { color: var(--info); }
.docs-callout-body {
  flex: 1;
  min-width: 0;
}
.docs-callout-title {
  color: var(--acid);
  font-family: var(--font-mono);
  font-size: 0.66rem;
  font-weight: 400;
  letter-spacing: 0.12em;
  margin-bottom: 0.35rem;
  text-transform: uppercase;
}
.docs-callout.warn .docs-callout-title { color: var(--warn); }
.docs-callout.info .docs-callout-title { color: var(--info); }
.docs-callout p {
  color: var(--ink-2);
  font-size: 0.84rem;
  line-height: 1.7;
  margin: 0;
}

/* ══════════════════════════
   STEPS
   ══════════════════════════ */
.docs-steps {
  display: flex;
  flex-direction: column;
  gap: 0;
  margin: 1.5rem 0;
}
.docs-step {
  align-items: flex-start;
  border-left: 1px solid var(--acid-border);
  display: flex;
  gap: 1.1rem;
  margin-left: 1rem;
  padding: 0 0 1.75rem 1.5rem;
  position: relative;
}
.docs-step.last {
  border-left-color: transparent;
  padding-bottom: 0;
}
.docs-step-num {
  align-items: center;
  background: var(--acid);
  border-radius: 50%;
  color: #050807;
  display: flex;
  flex-shrink: 0;
  font-family: var(--font-mono);
  font-size: 0.65rem;
  font-weight: 800;
  height: 26px;
  justify-content: center;
  margin-left: -1.88rem;
  width: 26px;
  box-shadow: 0 0 12px rgba(182,255,0,0.3);
}
.docs-step-content h4 {
  color: var(--ink);
  font-family: var(--font-mono);
  font-size: 0.88rem;
  font-weight: 400;
  letter-spacing: 0.04em;
  margin-bottom: 0.3rem;
  margin-top: 2px;
}
.docs-step-content p {
  color: var(--ink-3);
  font-size: 0.82rem;
  line-height: 1.7;
  margin: 0;
  max-width: 560px;
}

/* ══════════════════════════
   CARDS
   ══════════════════════════ */
.docs-cards {
  display: grid;
  gap: 0.85rem;
  grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
  margin: 1.5rem 0;
}
.docs-card {
  background: var(--surface);
  border: 1px solid rgba(182,255,0,0.1);
  border-radius: var(--radius-lg);
  overflow: hidden;
  padding: 1.2rem 1.3rem;
  position: relative;
  transition: border-color var(--t), background var(--t), transform var(--t);
}
.docs-card:hover {
  background: var(--surface-2);
  border-color: rgba(182,255,0,0.25);
  transform: translateY(-2px);
}
.docs-card::after {
  border-radius: var(--radius-lg);
  content: "";
  inset: 0;
  opacity: 0;
  pointer-events: none;
  position: absolute;
  transition: opacity 0.3s;
}
.docs-card:hover::after {
  background: radial-gradient(280px circle at var(--mx, 50%) var(--my, 50%), rgba(182,255,0,0.05), transparent 60%);
  opacity: 1;
}
.docs-card-icon {
  color: var(--acid);
  margin-bottom: 0.7rem;
}
.docs-card-title {
  color: var(--ink);
  font-family: var(--font-mono);
  font-size: 0.82rem;
  font-weight: 400;
  letter-spacing: 0.05em;
  margin-bottom: 0.4rem;
}
.docs-card-desc {
  color: var(--ink-3);
  font-size: 0.78rem;
  line-height: 1.65;
}

/* ══════════════════════════
   VISIBILITY TABLE
   ══════════════════════════ */
.docs-visibility {
  border: 1px solid rgba(182,255,0,0.1);
  border-radius: var(--radius-lg);
  display: grid;
  gap: 0;
  grid-template-columns: 1fr 1fr;
  margin: 1.5rem 0;
  overflow: hidden;
}
.docs-vis-col { padding: 1.1rem 1.3rem 1.3rem; }
.docs-vis-col + .docs-vis-col {
  border-left: 1px solid rgba(182,255,0,0.1);
}
.docs-vis-col.public { background: rgba(92,255,160,0.03); }
.docs-vis-col.protected { background: rgba(182,255,0,0.03); }
.docs-vis-header {
  border-bottom: 1px solid rgba(182,255,0,0.1);
  font-family: var(--font-mono);
  font-size: 0.67rem;
  font-weight: 400;
  letter-spacing: 0.14em;
  margin-bottom: 0.85rem;
  padding-bottom: 0.65rem;
  text-transform: uppercase;
}
.docs-vis-col.public .docs-vis-header { color: var(--ok); }
.docs-vis-col.protected .docs-vis-header { color: var(--acid); }
.docs-vis-item {
  align-items: center;
  color: var(--ink-2);
  display: flex;
  font-size: 0.82rem;
  gap: 0.55rem;
  margin-bottom: 0.55rem;
  line-height: 1.4;
}
.docs-vis-item::before { flex-shrink: 0; font-family: var(--font-mono); }
.docs-vis-col.public   .docs-vis-item::before { color: var(--ok);  content: "✓"; }
.docs-vis-col.protected .docs-vis-item::before { color: var(--acid); content: "◆"; font-size: 0.7em; }

/* ══════════════════════════
   ARCHITECTURE FLOW
   ══════════════════════════ */
.docs-arch-flow {
  display: flex;
  flex-direction: column;
  gap: 0;
  margin: 1.5rem 0;
}
.docs-arch-step {
  align-items: flex-start;
  display: grid;
  gap: 1rem;
  grid-template-columns: 32px 1fr;
  position: relative;
}
.docs-arch-line-wrap {
  align-items: center;
  display: flex;
  flex-direction: column;
}
.docs-arch-node {
  align-items: center;
  background: var(--surface-2);
  border: 1px solid var(--acid-border);
  border-radius: 50%;
  color: var(--acid);
  display: flex;
  flex-shrink: 0;
  font-family: var(--font-mono);
  font-size: 0.62rem;
  font-weight: 400;
  height: 32px;
  justify-content: center;
  width: 32px;
  z-index: 1;
}
.docs-arch-connector {
  background: linear-gradient(180deg, var(--acid-border), rgba(182,255,0,0.06));
  flex: 1;
  margin: 2px 0;
  min-height: 20px;
  width: 1px;
}
.docs-arch-content {
  background: var(--surface);
  border: 1px solid rgba(182,255,0,0.1);
  border-radius: var(--radius);
  margin-bottom: 0.75rem;
  padding: 0.85rem 1.1rem;
  transition: border-color var(--t);
}
.docs-arch-content:hover {
  border-color: rgba(182,255,0,0.22);
}
.docs-arch-content h4 {
  color: var(--ink);
  font-family: var(--font-mono);
  font-size: 0.83rem;
  font-weight: 400;
  letter-spacing: 0.04em;
  margin-bottom: 0.25rem;
}
.docs-arch-content p {
  color: var(--ink-3);
  font-size: 0.78rem;
  line-height: 1.65;
  margin: 0;
}

/* ══════════════════════════
   PRICING GRID
   ══════════════════════════ */
.docs-pricing-grid {
  display: grid;
  gap: 0.85rem;
  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
  margin: 1.5rem 0;
}
.docs-pricing-card {
  background: var(--surface);
  border: 1px solid rgba(182,255,0,0.1);
  border-radius: var(--radius-lg);
  padding: 1.4rem;
  position: relative;
  transition: border-color var(--t), transform var(--t);
}
.docs-pricing-card:hover {
  border-color: rgba(182,255,0,0.25);
  transform: translateY(-2px);
}
.docs-pricing-card.featured {
  background: rgba(182,255,0,0.04);
  border-color: var(--acid-strong);
}
.docs-pricing-badge {
  background: var(--acid);
  border-radius: var(--radius-sm);
  color: #050807;
  font-size: 0.58rem;
  font-family: var(--font-mono);
  font-weight: 400;
  letter-spacing: 0.08em;
  margin-bottom: 0.85rem;
  padding: 2px 8px;
  text-transform: uppercase;
  width: fit-content;
}
.docs-pricing-label {
  color: var(--ink-3);
  font-family: var(--font-mono);
  font-size: 0.72rem;
  font-weight: 400;
  letter-spacing: 0.08em;
  margin-bottom: 0.5rem;
  text-transform: uppercase;
}
.docs-pricing-amount {
  color: var(--ink);
  font-family: var(--font-mono);
  font-size: 1.6rem;
  font-weight: 400;
  letter-spacing: 0.02em;
  line-height: 1;
  margin-bottom: 0.2rem;
}
.docs-pricing-card.featured .docs-pricing-amount {
  color: var(--acid);
}
.docs-pricing-unit {
  color: var(--ink-4);
  font-size: 0.72rem;
  margin-bottom: 0.85rem;
}
.docs-pricing-desc {
  color: var(--ink-3);
  font-size: 0.78rem;
  line-height: 1.6;
}

/* ══════════════════════════
   TABLE
   ══════════════════════════ */
.docs-table-wrap {
  border: 1px solid rgba(182,255,0,0.1);
  border-radius: var(--radius-lg);
  margin: 1.5rem 0;
  overflow: hidden;
}
.docs-table {
  border-collapse: collapse;
  width: 100%;
}
.docs-table th {
  background: var(--surface-2);
  color: var(--ink-4);
  font-family: var(--font-mono);
  font-size: 0.63rem;
  font-weight: 400;
  letter-spacing: 0.12em;
  padding: 0.75rem 1.1rem;
  text-align: left;
  text-transform: uppercase;
}
.docs-table td {
  border-top: 1px solid rgba(182,255,0,0.07);
  color: var(--ink-2);
  font-size: 0.84rem;
  padding: 0.75rem 1.1rem;
}
.docs-table tr:hover td {
  background: rgba(182,255,0,0.025);
}
.token-badge {
  background: var(--surface-2);
  border: 1px solid var(--acid-border);
  border-radius: var(--radius-sm);
  font-family: var(--font-mono);
  font-size: 0.72rem;
  font-weight: 400;
  padding: 2px 7px;
}
.token-badge.usdc { color: #2775ca; border-color: rgba(39,117,202,0.3); background: rgba(39,117,202,0.1); }
.token-badge.eth  { color: #8a92b2; border-color: rgba(138,146,178,0.3); background: rgba(138,146,178,0.08); }
.status-live {
  color: var(--ok);
  font-family: var(--font-mono);
  font-size: 0.75rem;
  font-weight: 400;
}
.status-soon {
  color: var(--ink-4);
  font-family: var(--font-mono);
  font-size: 0.75rem;
}

/* ══════════════════════════
   API ENDPOINTS
   ══════════════════════════ */
.docs-api-group {
  margin-bottom: 1.4rem;
}
.docs-api-endpoint {
  align-items: center;
  background: var(--surface);
  border: 1px solid rgba(182,255,0,0.1);
  border-radius: var(--radius);
  display: flex;
  flex-wrap: wrap;
  gap: 0.85rem;
  margin-bottom: 0.6rem;
  padding: 0.85rem 1.1rem;
  transition: border-color var(--t);
}
.docs-api-endpoint:hover {
  border-color: rgba(182,255,0,0.22);
}
.docs-api-method {
  border-radius: var(--radius-sm);
  display: inline-block;
  font-family: var(--font-mono);
  font-size: 0.65rem;
  font-weight: 400;
  letter-spacing: 0.06em;
  padding: 3px 9px;
  text-transform: uppercase;
}
.docs-api-method.post {
  background: rgba(182,255,0,0.12);
  border: 1px solid var(--acid-border);
  color: var(--acid);
}
.docs-api-method.get {
  background: rgba(122,184,255,0.1);
  border: 1px solid rgba(122,184,255,0.2);
  color: var(--info);
}
.docs-api-path {
  color: var(--ink);
  font-family: var(--font-mono);
  font-size: 0.82rem;
  font-weight: 400;
  flex: 1;
}
.docs-api-desc {
  color: var(--ink-3);
  font-size: 0.78rem;
  flex-basis: 100%;
  margin-top: -0.2rem;
}

/* ══════════════════════════
   CODE BLOCKS
   ══════════════════════════ */
.docs-code-wrap {
  background: var(--surface);
  border: 1px solid rgba(182,255,0,0.1);
  border-radius: var(--radius-lg);
  margin: 1.25rem 0;
  overflow: hidden;
  position: relative;
}
.docs-code-header {
  align-items: center;
  background: var(--surface-2);
  border-bottom: 1px solid rgba(182,255,0,0.08);
  color: var(--ink-4);
  display: flex;
  font-family: var(--font-mono);
  font-size: 0.65rem;
  font-weight: 400;
  gap: 0.5rem;
  justify-content: space-between;
  letter-spacing: 0.06em;
  padding: 0.5rem 1rem;
  text-transform: uppercase;
}
.docs-code-copy {
  background: none;
  border: 1px solid rgba(182,255,0,0.15);
  border-radius: var(--radius-sm);
  color: var(--ink-4);
  cursor: pointer;
  font-family: var(--font-mono);
  font-size: 0.58rem;
  letter-spacing: 0.06em;
  padding: 2px 8px;
  transition: color var(--t), border-color var(--t);
}
.docs-code-copy:hover { border-color: var(--acid); color: var(--acid); }
.docs-code-copy.copied { border-color: var(--ok); color: var(--ok); }
.docs-code-block {
  color: rgba(237,240,228,0.82);
  font-family: var(--font-mono);
  font-size: 0.78rem;
  line-height: 1.75;
  margin: 0;
  overflow-x: auto;
  padding: 1.1rem 1.2rem;
  white-space: pre;
  /* Subtle right-fade hint when content overflows */
  -webkit-mask-image: linear-gradient(to right, black calc(100% - 2rem), transparent 100%);
  mask-image: linear-gradient(to right, black calc(100% - 2rem), transparent 100%);
}
.docs-code-block .ck { color: var(--ink-4); }  /* comment */
.docs-code-block .cs { color: var(--acid); }   /* key/string */
.docs-code-block .cv { color: var(--ok); }     /* value/green */
.docs-code-block .cf { color: var(--warn); }   /* field/orange */

/* ══════════════════════════
   FAQ
   ══════════════════════════ */
.docs-faq { margin: 1.5rem 0; }
.docs-faq-item {
  border-bottom: 1px solid rgba(182,255,0,0.08);
  padding: 1.1rem 0;
}
.docs-faq-item:first-child {
  border-top: 1px solid rgba(182,255,0,0.08);
}
.docs-faq-q {
  align-items: flex-start;
  cursor: pointer;
  display: flex;
  font-size: 0.88rem;
  font-family: var(--font-mono);
  font-weight: 400;
  letter-spacing: 0.03em;
  gap: 0.75rem;
  justify-content: space-between;
  color: var(--ink);
  list-style: none;
  padding: 0;
}
.docs-faq-q::before {
  color: var(--acid);
  content: "Q.";
  flex-shrink: 0;
  font-family: var(--font-mono);
  font-size: 0.7em;
  font-weight: 400;
  letter-spacing: 0.06em;
  margin-top: 2px;
}
.docs-faq-q::-webkit-details-marker { display: none; }
.docs-faq-toggle {
  color: var(--ink-3);
  flex-shrink: 0;
  font-size: 1rem;
  transition: transform var(--t);
  line-height: 1;
}
details[open] .docs-faq-toggle { transform: rotate(45deg); color: var(--acid); }
.docs-faq-a {
  border-left: 2px solid var(--acid-border);
  color: var(--ink-3);
  font-size: 0.85rem;
  line-height: 1.8;
  margin-top: 0.85rem;
  padding-left: 1rem;
}
.docs-faq-a strong { color: var(--ink); }

/* ══════════════════════════
   RIGHT TOC
   ══════════════════════════ */
.docs-toc {
  grid-column: 3;
  grid-row: 1;
  height: calc(100vh - var(--header-h));
  overflow-y: auto;
  padding: 2rem 1rem 3rem 1.25rem;
  position: sticky;
  top: var(--header-h);
  scrollbar-width: none;
}
.docs-toc::-webkit-scrollbar { display: none; }
.docs-toc-title {
  color: var(--ink-4);
  font-family: var(--font-mono);
  font-size: 0.62rem;
  font-weight: 400;
  letter-spacing: 0.16em;
  margin-bottom: 0.75rem;
  text-transform: uppercase;
}
.docs-toc-nav {
  display: flex;
  flex-direction: column;
  gap: 0;
}
.docs-toc-item {
  border-left: 1px solid rgba(182,255,0,0.1);
  color: var(--ink-4);
  font-family: var(--font-mono);
  font-size: 0.73rem;
  line-height: 1.4;
  padding: 0.38rem 0 0.38rem 0.9rem;
  transition: color var(--t), border-color var(--t);
}
.docs-toc-item:hover { color: var(--ink-2); }
.docs-toc-item.active {
  border-left-color: var(--acid);
  color: var(--acid);
  font-weight: 400;
}

/* ══════════════════════════
   FOOTER
   ══════════════════════════ */
.docs-footer {
  align-items: center;
  border-top: 1px solid rgba(182,255,0,0.08);
  display: flex;
  gap: 1rem;
  grid-column: 2;
  grid-row: 2;
  justify-content: space-between;
  margin-top: 4.5rem;
  max-width: 960px;
  padding: 1.65rem 0 1.4rem;
}
.docs-footer-links {
  align-items: center;
  display: flex;
  gap: 1rem;
  margin-left: 3rem;
}

.docs-footer-icon {
  align-items: center;
  color: var(--ink-4);
  display: inline-flex;
  height: 22px;
  justify-content: center;
  opacity: 0.72;
  transition: color var(--t), opacity var(--t), transform var(--t);
  width: 22px;
}

.docs-footer-icon:hover {
  color: var(--acid);
  opacity: 1;
  transform: translateY(-1px);
}

.docs-footer-icon svg {
  display: block;
  fill: currentColor;
  height: 18px;
  width: 18px;
}

.docs-footer-powered {
  color: var(--ink-4);
  font-size: 0.78rem;
}
.docs-footer-powered strong {
  color: var(--ink-2);
  font-weight: 600;
}

/* ══════════════════════════
   BACK TO TOP BUTTON
   ══════════════════════════ */
.docs-btt {
  align-items: center;
  background: var(--surface-2);
  border: 1px solid var(--acid-border);
  border-radius: 50%;
  bottom: 2rem;
  color: var(--acid);
  cursor: pointer;
  display: flex;
  height: 42px;
  justify-content: center;
  opacity: 0;
  pointer-events: none;
  position: fixed;
  right: 2rem;
  transform: translateY(10px);
  transition: opacity 0.3s, transform 0.3s, border-color 0.15s, box-shadow 0.15s;
  width: 42px;
  z-index: 80;
}
.docs-btt.visible {
  opacity: 1;
  pointer-events: auto;
  transform: translateY(0);
}
.docs-btt:hover {
  border-color: var(--acid);
  box-shadow: 0 0 18px rgba(182,255,0,0.2);
}

/* ══════════════════════════
   RESPONSIVE
   ══════════════════════════ */
@media (max-width: 1200px) {
  .docs-page { grid-template-columns: var(--sidebar-w) 1fr; }
  .docs-toc { display: none; }
  .docs-main { padding: 2.5rem 2rem 5rem; }
}

@media (max-width: 840px) {
  :root { --sidebar-w: 0px; }
  .docs-page { grid-template-columns: 1fr; }
  .docs-sidebar {
    background: var(--surface);
    border-right: 1px solid rgba(182,255,0,0.12);
    height: 100vh;
    left: -284px;
    overflow-y: auto;
    padding: 4.5rem 0 3rem;
    position: fixed;
    top: 0;
    transition: left var(--t-med);
    width: 284px;
    z-index: 90;
  }
  .docs-sidebar.open { left: 0; }
  .docs-topbar-search { display: none; }
  .docs-menu-toggle { display: flex; }
  .docs-main { padding: 2rem 1.25rem 4rem; }
  .docs-visibility { grid-template-columns: 1fr; }
  .docs-vis-col + .docs-vis-col {
    border-left: none;
    border-top: 1px solid rgba(182,255,0,0.08);
  }
  .docs-cards { grid-template-columns: 1fr; }
  .docs-pricing-grid { grid-template-columns: 1fr; }
}

@media (max-width: 540px) {
  .docs-topbar-link { display: none; }
  .docs-h1 { font-size: 1.5rem; }
  .docs-btt { right: 1rem; bottom: 1rem; }
  .docs-api-endpoint { flex-wrap: wrap; }
}

/* ── Prefers reduced motion ── */
@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after {
    transition: none !important;
    animation: none !important;
  }
  html { scroll-behavior: auto; }
  .docs-section {
    opacity: 1;
    transform: none;
  }
}