/* =============================================================
   1. Tokens — dark by default, light via [data-theme="light"]
   ============================================================= */
:root{
  --bg:          #0b0912;
  --bg-2:        #120f1c;
  --bg-3:        #191527;
  --ink:         #f1eef8;
  --ink-soft:    #c8c3d6;
  --ink-mute:    #83809a;
  --accent:      #8b5cf6;
  --accent-deep: #6d28d9;
  --accent-soft: rgba(139,92,246,0.14);
  --line:        rgba(238,235,248,0.10);
  --line-strong: rgba(238,235,248,0.20);
  --warn:        #e0574a;
  --warn-soft:   rgba(224,87,74,0.12);

  --serif: 'Fraunces', ui-serif, Georgia, serif;
  --sans:  'Inter', -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;
  --ease-out: cubic-bezier(0.16, 1, 0.3, 1);

  --sidebar-w: 280px;
  --topbar-h: 56px;
}

[data-theme="light"]{
  --bg:          #f6f4fa;
  --bg-2:        #ebe7f3;
  --bg-3:        #ddd6ec;
  --ink:         #120f1c;
  --ink-soft:    #322c42;
  --ink-mute:    #6c6480;
  --accent:      #7c3aed;
  --accent-deep: #5b21b6;
  --accent-soft: rgba(124,58,237,0.09);
  --line:        rgba(18,15,28,0.10);
  --line-strong: rgba(18,15,28,0.20);
}

/* =============================================================
   2. Reset & base
   ============================================================= */
*, *::before, *::after{ box-sizing: border-box; margin: 0; }
html{ scroll-behavior: smooth; }
@media (prefers-reduced-motion: reduce){ html{ scroll-behavior: auto; } }
body{
  background: var(--bg);
  color: var(--ink-soft);
  font-family: var(--sans);
  font-size: 16px;
  line-height: 1.65;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  text-rendering: optimizeLegibility;
  overflow-x: clip;
  transition: background 0.2s var(--ease-out), color 0.2s var(--ease-out);
}
a{ color: var(--accent); text-decoration: none; }
a:hover{ text-decoration: underline; }
button{ font: inherit; color: inherit; cursor: pointer; border: 0; background: none; }
img, svg, video{ display:block; max-width:100%; height:auto; }
p{ margin: 0 0 1rem 0; text-wrap: pretty; }
h1, h2, h3{ text-wrap: balance; color: var(--ink); }
code{
  font-family: ui-monospace, "SF Mono", Consolas, monospace;
  background: var(--accent-soft);
  border: 1px solid var(--line);
  padding: 0.1em 0.4em;
  border-radius: 3px;
  font-size: 0.86em;
  color: var(--ink);
}
::selection{ background: var(--accent); color: var(--bg); }
:focus-visible{ outline: 2px solid var(--accent); outline-offset: 3px; border-radius: 2px; }

.skip-link{
  position: fixed; top:-100px; left:1rem;
  padding:.7rem 1.1rem; background: var(--ink); color: var(--bg);
  z-index: 9999; border-radius: 4px; font-weight:500; font-size: 14px;
}
.skip-link:focus{ top: 1rem; }

[data-reveal]{
  opacity: 0;
  transform: translateY(14px);
  transition: opacity 0.5s var(--ease-out), transform 0.5s var(--ease-out);
}
[data-reveal].is-visible{ opacity: 1; transform: translateY(0); }
@media (prefers-reduced-motion: reduce){
  [data-reveal]{ transition-duration: 0.15s; }
}

/* =============================================================
   3. Top bar
   ============================================================= */
.topbar{
  position: sticky; top:0; z-index: 200;
  height: var(--topbar-h);
  display:flex; align-items:center; justify-content:space-between;
  padding: 0 1.2rem;
  /* solid fallback first — browsers without backdrop-filter still get a readable bar */
  background: rgba(11,9,18,0.92);
  border-bottom: 1px solid rgba(238,235,248,0.08);
  box-shadow: 0 1px 0 rgba(255,255,255,0.05) inset, 0 12px 30px rgba(0,0,0,0.22);
}
@supports (backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px)){
  .topbar{
    background: rgba(11,9,18,0.42);
    backdrop-filter: blur(20px) saturate(180%);
    -webkit-backdrop-filter: blur(20px) saturate(180%);
  }
}
[data-theme="light"] .topbar{
  background: rgba(246,244,250,0.92);
  border-bottom-color: rgba(18,15,28,0.08);
  box-shadow: 0 1px 0 rgba(255,255,255,0.7) inset, 0 12px 30px rgba(0,0,0,0.06);
}
@supports (backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px)){
  [data-theme="light"] .topbar{
    background: rgba(246,244,250,0.55);
    backdrop-filter: blur(20px) saturate(180%);
    -webkit-backdrop-filter: blur(20px) saturate(180%);
  }
}
.topbar__brand-group{ display:flex; align-items:center; gap: 0.5rem; min-width:0; }
.topbar__brand-hub{
  font-family: var(--serif);
  font-style: italic;
  font-size: 0.95rem;
  color: var(--ink-mute);
  transition: color 0.2s var(--ease-out);
  flex-shrink: 0;
}
.topbar__brand-hub:hover{ color: var(--accent); text-decoration:none; }
.topbar__brand-sep{ color: var(--ink-mute); font-size: 0.85rem; flex-shrink: 0; }
.topbar__brand{
  font-family: var(--serif);
  font-style: italic;
  font-weight: 500;
  font-size: 1.05rem;
  color: var(--ink);
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
}
.topbar__meta{
  font-size: 0.78rem;
  color: var(--ink-mute);
  display:none;
}
.topbar__actions{ display:flex; align-items:center; gap: 0.4rem; }
.icon-btn{
  width: 34px; height: 34px;
  border-radius: 6px;
  border: 1px solid var(--line-strong);
  display:flex; align-items:center; justify-content:center;
  font-size: 14px;
  color: var(--ink-soft);
  transition: border-color 0.2s, color 0.2s;
}
.icon-btn:hover{ border-color: var(--accent); color: var(--accent); }
.topbar__hamburger{ display:flex; }

@media (min-width: 720px){
  .topbar__meta{ display:block; }
  .topbar__hamburger{ display:none; }
}

/* =============================================================
   4. Docs layout
   ============================================================= */
.docs{
  max-width: 1240px;
  margin: 0 auto;
  display:grid;
  grid-template-columns: 1fr;
}

.sidebar-scrim{
  position: fixed; inset: var(--topbar-h) 0 0 0;
  background: rgba(0,0,0,0.5);
  z-index: 150;
  opacity: 0; visibility: hidden;
  transition: opacity 0.25s var(--ease-out);
}
.sidebar-scrim.is-open{ opacity:1; visibility: visible; }

.sidebar{
  position: fixed;
  top: var(--topbar-h);
  left: 0; bottom: 0;
  width: min(300px, 84vw);
  background: var(--bg-2);
  border-right: 1px solid var(--line);
  padding: 1.2rem 1rem 3rem 1rem;
  overflow-y: auto;
  z-index: 160;
  transform: translateX(-100%);
  transition: transform 0.28s var(--ease-out);
}
.sidebar.is-open{ transform: translateX(0); }

.sidebar__head{
  display:flex; align-items:center; justify-content:space-between;
  margin-bottom: 1rem;
}
.sidebar__eyebrow{
  font-size: 11px;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--ink-mute);
}
.sidebar__expand-btns{ display:flex; gap: 4px; }
.sidebar__expand-btns button{
  width: 22px; height: 22px;
  border-radius: 3px;
  border: 1px solid var(--line-strong);
  color: var(--ink-mute);
  font-size: 13px; line-height: 1;
}
.sidebar__expand-btns button:hover{ border-color: var(--accent); color: var(--accent); }

.nav-tree ul{ list-style:none; padding:0; margin:0; }
.nav-tree > ul > li{ margin-bottom: 2px; }

.nav-tree__link{
  display:block;
  padding: 0.45rem 0.5rem;
  border-radius: 5px;
  font-size: 0.88rem;
  color: var(--ink-soft);
  font-weight: 500;
}
.nav-tree__link:hover{ background: var(--accent-soft); text-decoration:none; color: var(--accent); }
.nav-tree__link.is-active{ color: var(--accent); background: var(--accent-soft); }

.nav-tree__toggle{
  display:flex; align-items:center; gap: 6px;
  padding: 0.45rem 0.5rem;
  border-radius: 5px;
  font-size: 0.88rem;
  font-weight: 600;
  color: var(--ink);
  cursor:pointer;
  user-select:none;
}
.nav-tree__toggle:hover{ background: var(--accent-soft); }
.nav-tree__arrow{
  font-size: 9px; color: var(--ink-mute);
  display:inline-block;
  transition: transform 0.15s var(--ease-out);
}
.nav-tree__parent.is-open > .nav-tree__toggle .nav-tree__arrow{ transform: rotate(90deg); }

.nav-tree__children{
  padding-left: 1.1rem;
  max-height: 0;
  overflow: hidden;
  transition: max-height 0.25s var(--ease-out);
}
.nav-tree__children.is-open{ max-height: 400px; }
.nav-tree__children .nav-tree__link{ font-weight:400; font-size: 0.85rem; color: var(--ink-mute); }
.nav-tree__children .nav-tree__link:hover,
.nav-tree__children .nav-tree__link.is-active{ color: var(--accent); }

/* =============================================================
   5. Main content
   ============================================================= */
.content{
  padding: 2.4rem 1.25rem 6rem 1.25rem;
  max-width: 760px;
  margin: 0 auto;
}

h1{
  font-family: var(--serif);
  font-style: italic;
  font-weight: 500;
  font-size: clamp(1.9rem, 5vw, 2.6rem);
  margin-bottom: 0.7rem;
}
.lede{ font-size: 1.05rem; color: var(--ink-soft); margin-bottom: 1.6rem; }

h2{
  font-family: var(--serif);
  font-style: italic;
  font-weight: 500;
  font-size: clamp(1.4rem, 3.4vw, 1.8rem);
  margin: 3rem 0 1rem 0;
  padding-top: 1.6rem;
  border-top: 1px solid var(--line);
}
h3{
  font-family: var(--sans);
  font-weight: 600;
  font-size: 1.02rem;
  color: var(--ink);
  margin: 1.8rem 0 0.7rem 0;
}
ul, ol{ padding-left: 1.3rem; margin-bottom: 1rem; }
li{ margin-bottom: 0.4rem; }

.feature-list{ list-style:none; padding-left:0; }
.feature-list li{
  padding-left: 1.4rem;
  position: relative;
}
.feature-list li::before{
  content: "—";
  position: absolute; left:0; color: var(--accent);
}

/* Callout list — real UI reference sequence */
.callout-list{
  counter-reset: callout;
  list-style:none; padding-left:0;
  border: 1px solid var(--line);
  border-radius: 8px;
  overflow:hidden;
  background: var(--bg-2);
}
.callout-list li{
  counter-increment: callout;
  position: relative;
  padding: 0.75rem 1rem 0.75rem 3rem;
  border-bottom: 1px solid var(--line);
  margin:0;
  font-size: 0.92rem;
}
.callout-list li:last-child{ border-bottom:none; }
.callout-list li::before{
  content: counter(callout);
  position: absolute; left: 12px; top: 0.72rem;
  width: 20px; height: 20px;
  border-radius: 50%;
  border: 1.5px solid var(--accent);
  color: var(--accent);
  font-size: 11px; font-weight:700;
  display:flex; align-items:center; justify-content:center;
}

/* Step list — real sequences (install, custom presets) */
.step-list{ list-style:none; padding-left:0; counter-reset: step; }
.step-list li{
  counter-increment: step;
  position: relative;
  padding: 0.55rem 0 0.55rem 2.2rem;
  border-bottom: 1px solid var(--line);
  font-size: 0.95rem;
}
.step-list li:first-child{ border-top: 1px solid var(--line); }
.step-list li::before{
  content: counter(step);
  position: absolute; left: 0; top: 0.55rem;
  font-family: var(--serif);
  font-style: italic;
  color: var(--accent);
  font-size: 0.95rem;
}

/* Chip row (quick jump) */
.chip-row{ display:flex; flex-wrap:wrap; gap: 0.5rem; margin-bottom: 1.6rem; }
.chip{
  padding: 0.4rem 0.85rem;
  border-radius: 999px;
  border: 1px solid var(--line-strong);
  font-size: 0.82rem;
  color: var(--ink-soft);
}
.chip:hover{ border-color: var(--accent); color: var(--accent); text-decoration:none; }

/* Media placeholder */
.media{ margin: 1.2rem 0 1.6rem 0; }
.media-slot{
  border: 1px dashed var(--line-strong);
  border-radius: 8px;
  background:
    repeating-linear-gradient(135deg, var(--accent-soft) 0 2px, transparent 2px 22px),
    var(--bg-2);
  padding: 2rem 1.2rem;
  text-align:center;
  display:flex; flex-direction:column; align-items:center; gap: 0.4rem;
}
.media--video .media-slot{ aspect-ratio: 16/9; justify-content:center; }
.media-slot__icon{ font-size: 20px; color: var(--accent); }
.media-slot__label{
  font-size: 0.78rem;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  font-weight: 600;
  color: var(--ink);
}
.media-slot__note{ font-size: 0.82rem; color: var(--ink-mute); max-width: 42ch; }
.media-slot__img{ width:100%; height:auto; display:block; border-radius: 8px; }

/* Note / warn / stub */
.note{
  border-left: 3px solid var(--accent);
  background: var(--accent-soft);
  padding: 0.9rem 1.1rem;
  margin: 1.2rem 0;
  border-radius: 0 6px 6px 0;
  font-size: 0.92rem;
}
.note b{ color: var(--accent); }
.warn{
  border-left: 3px solid var(--warn);
  background: var(--warn-soft);
  padding: 0.9rem 1.1rem;
  margin: 1.2rem 0;
  border-radius: 0 6px 6px 0;
  font-size: 0.92rem;
}
.warn b{ color: var(--warn); }
.stub{
  border: 1px dashed var(--line-strong);
  border-radius: 8px;
  padding: 1.1rem;
  font-size: 0.9rem;
  color: var(--ink-mute);
  font-style: italic;
}

/* Table */
.table{ width:100%; border-collapse: collapse; margin: 0.5rem 0 1.5rem 0; font-size: 0.9rem; }
.table th, .table td{ text-align:left; padding: 0.6rem 0.7rem; border-bottom: 1px solid var(--line); vertical-align: top; }
.table th{ font-weight:600; color: var(--ink); white-space: nowrap; width: 1%; }

/* CTA */
.cta-row{ display:flex; gap: 0.8rem; flex-wrap:wrap; margin-top: 1rem; }
.btn{
  display:inline-block;
  padding: 0.7rem 1.3rem;
  border-radius: 999px;
  background: var(--ink);
  color: var(--bg);
  font-size: 0.86rem;
  font-weight: 600;
  transition: transform 0.2s var(--ease-out), background 0.2s var(--ease-out);
}
.btn:hover{ transform: translateY(-2px); background: var(--accent); text-decoration:none; }
.btn--ghost{ background: transparent; border: 1px solid var(--line-strong); color: var(--ink); }
.btn--ghost:hover{ background: var(--accent-soft); border-color: var(--accent); color: var(--accent); }

.content-footer{
  margin-top: 4rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--line);
  font-size: 0.82rem;
  color: var(--ink-mute);
  display:flex; justify-content: space-between; flex-wrap:wrap; gap: 0.6rem;
}

/* =============================================================
   6. Desktop layout — sidebar always visible
   ============================================================= */
@media (min-width: 960px){
  .docs{ grid-template-columns: var(--sidebar-w) 1fr; align-items:start; }
  .sidebar-scrim{ display:none; }
  .sidebar{
    position: sticky;
    top: var(--topbar-h);
    left:auto;
    height: calc(100vh - var(--topbar-h));
    transform: none;
    border-right: 1px solid var(--line);
    width: auto;
  }
  .content{ padding: 3.2rem 3rem 7rem 3rem; max-width: 780px; margin:0; }
}