body.docs-light {
    background-color: var(--surface);
    color: var(--ink);
    min-height: 100vh;
    display: flex;
    flex-direction: column;
}

/* ── Navbar (clar) ─────────────────────────────────────────────────── */
.docs-navbar {
    backdrop-filter: blur(14px);
    -webkit-backdrop-filter: blur(14px);
    background: rgba(255,255,255,0.82);
    border-bottom: 1px solid var(--hairline);
}
.docs-navbar .navbar-brand {
    font-weight: 800; letter-spacing: -.02em;
    display: flex; align-items: center; gap: .55rem; color: var(--ink);
}
.docs-navbar .navbar-brand img { filter: drop-shadow(0 2px 6px rgba(99,102,241,.6)); }
.docs-navbar .navbar-brand span {
    background: linear-gradient(120deg, var(--ink) 30%, var(--brand-500));
    -webkit-background-clip: text; background-clip: text;
    -webkit-text-fill-color: transparent;
}
.docs-navbar .nav-link {
    font-weight: 600; font-size: .9rem;
    color: var(--ink-soft);
    transition: color .2s var(--ease);
}
.docs-navbar .nav-link:hover,
.docs-navbar .nav-link.active { color: var(--brand-600); }
.docs-navbar .navbar-toggler { border-color: var(--hairline); }
.docs-navbar .navbar-toggler i { color: var(--ink); }
.docs-sidebar-toggle {
    border: 1px solid var(--hairline);
    background: var(--card-bg-soft);
    color: var(--ink);
    width: 40px; height: 40px;
    border-radius: var(--r-sm);
    display: none;
    align-items: center; justify-content: center;
}

/* ── Shell: sidebar + main ─────────────────────────────────────────── */
.docs-shell {
    display: flex;
    align-items: flex-start;
    max-width: 1400px;
    margin: 0 auto;
    flex: 1;
    width: 100%;
}

/* ── Sidebar ───────────────────────────────────────────────────────── */
.docs-sidebar {
    width: 264px;
    flex-shrink: 0;
    position: sticky;
    top: 62px;
    align-self: flex-start;
    height: calc(100vh - 62px);
    overflow-y: auto;
    padding: 1.5rem 1rem 3rem;
    border-right: 1px solid var(--hairline);
}
.docs-sidebar::-webkit-scrollbar { width: 6px; }
.docs-sidebar::-webkit-scrollbar-thumb { background: var(--hairline); border-radius: 3px; }

.docs-nav-category {
    display: block;
    font-size: .7rem; font-weight: 700; letter-spacing: .12em;
    text-transform: uppercase; color: var(--brand-600);
    padding: 1.35rem .75rem .4rem;
    text-decoration: none;
    transition: color .15s var(--ease);
}
.docs-nav-category:hover { color: var(--brand-700); }
.docs-nav-category.is-active { color: var(--brand-700); }
.docs-nav-category:first-of-type { padding-top: .25rem; }
.docs-nav-category:not(:first-of-type) {
    border-top: 1px solid var(--hairline);
    margin-top: .4rem;
}
.docs-nav-link {
    display: block;
    padding: .42rem .75rem;
    color: var(--ink-soft);
    font-size: .87rem; font-weight: 500;
    border-radius: var(--r-sm);
    text-decoration: none;
    transition: color .15s var(--ease), background .15s var(--ease);
}
.docs-nav-link:hover { background: var(--card-bg-soft); color: var(--ink); }
.docs-nav-link.active {
    background: var(--grad-brand-soft);
    color: var(--brand-700);
    font-weight: 600;
    box-shadow: inset 0 0 0 1px rgba(99,102,241,.18);
}
.docs-nav-anchors {
    list-style: none;
    padding: .15rem 0 .5rem 1.5rem;
    margin: 0;
    border-left: 2px solid var(--hairline);
}
.docs-nav-anchors a {
    display: block;
    padding: .25rem .75rem;
    font-size: .8rem; font-weight: 500;
    color: var(--ink-muted);
    text-decoration: none;
    transition: color .15s var(--ease);
}
.docs-nav-anchors a:hover { color: var(--brand-600); }
.docs-nav-anchors a.active { color: var(--brand-600); font-weight: 600; }

/* ── Main ──────────────────────────────────────────────────────────── */
.docs-main {
    flex: 1;
    min-width: 0;
    padding: 1.75rem;
    max-width: 980px;
}

/* ── Index cards grid (auto-fit so all indexes share one look) ─────── */
.docs-index-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(230px, 1fr));
    gap: 1.25rem;
}
.docs-index-card { display: block; }
.docs-index-card .card { height: 100%; }

/* ── Anchored sections ─────────────────────────────────────────────── */
.docs-section { margin-top: 2.75rem; scroll-margin-top: 5.5rem; }
.docs-section:first-child { margin-top: 0; }
.docs-section > h2 {
    font-size: 1.45rem; font-weight: 800; letter-spacing: -.02em;
    color: var(--ink); margin: 0 0 .35rem;
}
.docs-section > .docs-section-sub {
    color: var(--ink-muted); font-size: .95rem;
    margin: 0 0 1.25rem; max-width: 70ch;
}

/* ── Steps (how it works) ──────────────────────────────────────────── */
.docs-steps { display: grid; gap: 1rem; }
@media (min-width: 768px) {
    .docs-steps { grid-template-columns: repeat(3, 1fr); }
}
.docs-step {
    background: var(--card-bg);
    border: 1px solid var(--hairline);
    border-radius: var(--r);
    padding: 1.25rem 1.35rem;
    transition: border-color .2s var(--ease), transform .2s var(--ease), box-shadow .2s var(--ease);
}
.docs-step:hover { border-color: var(--card-border-hover); transform: translateY(-2px); box-shadow: var(--shadow); }
.docs-step-num {
    font-family: 'JetBrains Mono', monospace;
    font-size: .72rem; font-weight: 700; letter-spacing: .12em;
    color: var(--brand-500); margin-bottom: .6rem;
}
.docs-step h6 { font-size: 1rem; font-weight: 700; color: var(--ink); margin: 0 0 .4rem; }
.docs-step p { font-size: .85rem; color: var(--ink-muted); margin: 0; }

/* ── Formula block ─────────────────────────────────────────────────── */
.docs-formula {
    background:
        radial-gradient(420px 220px at 100% 0%, rgba(139,92,246,.10), transparent 60%),
        linear-gradient(135deg, rgba(99,102,241,.06), rgba(139,92,246,.05));
    border: 1px solid var(--card-border);
    border-radius: var(--r);
    padding: 1.5rem 1.75rem;
}
.docs-formula pre {
    font-family: 'JetBrains Mono', monospace;
    font-size: .9rem; line-height: 1.75;
    color: var(--brand-700); margin: 0; white-space: pre-wrap; word-break: break-word;
}
.docs-formula-note { color: var(--ink-muted); font-size: .85rem; margin: 1rem 0 0; }

/* ── Mobile sidebar drawer ─────────────────────────────────────────── */
.docs-sidebar-backdrop {
    position: fixed; inset: 0;
    background: rgba(15,23,42,.4);
    z-index: 1040;
    display: none;
}
.docs-sidebar-backdrop.show { display: block; }

/* ── Back-to-top button ───────────────────────────────────────────── */
.docs-top-btn {
    position: fixed;
    bottom: 1.5rem;
    right: 1.5rem;
    z-index: 1000;
    width: 44px; height: 44px;
    border-radius: var(--r-sm);
    background: var(--grad-brand);
    color: #fff;
    border: none;
    box-shadow: var(--shadow);
    display: flex; align-items: center; justify-content: center;
    cursor: pointer;
    font-size: 1.1rem;
    opacity: 0;
    visibility: hidden;
    transform: translateY(8px);
    transition: opacity .2s var(--ease), transform .2s var(--ease), visibility .2s, box-shadow .2s var(--ease);
}
.docs-top-btn.show {
    opacity: 1;
    visibility: visible;
    transform: translateY(0);
}
.docs-top-btn:hover { box-shadow: var(--shadow-lg); filter: brightness(1.05); }
.docs-top-btn:focus-visible { outline: 3px solid rgba(99,102,241,.35); outline-offset: 2px; }

@media (max-width: 991.98px) {
    .docs-sidebar-toggle { display: flex; }
    .docs-shell { flex-direction: column; }
    .docs-sidebar {
        position: fixed;
        top: 0; left: 0; bottom: 0;
        height: 100vh;
        width: min(84vw, 280px);
        background: var(--card-bg);
        z-index: 1050;
        transform: translateX(-100%);
        transition: transform .3s var(--ease);
        box-shadow: var(--shadow-lg);
        padding-top: 1.25rem;
    }
    .docs-sidebar.open { transform: translateX(0); }
    .docs-main { padding: 1.25rem 1rem; max-width: 100%; }
}

@media (prefers-reduced-motion: reduce) {
    .docs-step { transition-duration: .01ms !important; }
    .docs-sidebar { transition-duration: .01ms !important; }
}