/**
 * docs.css — DIX help center / documentation
 *
 * Loaded AFTER dix.css so it reuses its design tokens (CSS vars) and gets
 * dark/light theming for free. Theme is driven by data-theme on <html>
 * (see the inline init in the "doc_head" partial; default is dark, persisted
 * under localStorage['dix-theme'] shared with the app).
 *
 * Layout: [ sidebar | article | toc ] on desktop, single column on mobile.
 * Readability targets (research-backed): ~68ch measure, ~18px body, lh 1.7.
 */

/* ─── Base ──────────────────────────────────────────────────────────────── */
body.docs-body {
    font-family: var(--font-ui);
    background: var(--bg);
    color: var(--text-secondary);
    -webkit-font-smoothing: antialiased;
    min-height: 100vh;
}

.docs-skip-link {
    position: absolute;
    left: -9999px;
    top: 0;
    background: var(--dix-primary);
    color: #fff;
    padding: 10px 16px;
    border-radius: 0 0 var(--radius-md) 0;
    z-index: 200;
}
.docs-skip-link:focus { left: 0; }

/* Visible focus in both themes */
.docs-body a:focus-visible,
.docs-body button:focus-visible,
.docs-body summary:focus-visible {
    outline: 2px solid var(--border-focus);
    outline-offset: 2px;
    border-radius: 4px;
}

/* ─── Top nav ───────────────────────────────────────────────────────────── */
.docs-nav {
    position: sticky;
    top: 0;
    z-index: 100;
    display: flex;
    align-items: center;
    gap: 16px;
    height: 60px;
    padding: 0 20px;
    background: var(--bg-overlay);
    backdrop-filter: blur(14px);
    -webkit-backdrop-filter: blur(14px);
    border-bottom: 1px solid var(--border);
}
.docs-nav-brand {
    display: inline-flex;
    align-items: center;
    gap: 9px;
    text-decoration: none;
    color: var(--text-primary);
    font-family: var(--font-brand);
    font-weight: 700;
    font-size: 17px;
}
.docs-nav-brand img { height: 26px; width: auto; border-radius: 7px; }
.docs-nav-badge {
    font-family: var(--font-ui);
    font-size: 11px;
    font-weight: 600;
    color: var(--text-muted);
    border: 1px solid var(--border);
    border-radius: 999px;
    padding: 2px 9px;
    margin-left: 2px;
}
.docs-nav-spacer { flex: 1; }
.docs-nav-link {
    color: var(--text-secondary);
    text-decoration: none;
    font-size: 14px;
    font-weight: 500;
    padding: 7px 12px;
    border-radius: var(--radius-sm);
    transition: color var(--transition-fast), background var(--transition-fast);
}
.docs-nav-link:hover { color: var(--text-primary); background: var(--bg-subtle); }
.docs-nav-cta {
    background: var(--dix-gradient);
    color: #fff !important;
    box-shadow: 0 2px 10px rgba(99, 102, 241, 0.3);
}
.docs-icon-btn {
    width: 36px; height: 36px;
    display: grid; place-items: center;
    border-radius: var(--radius-sm);
    border: 1px solid var(--border);
    background: var(--bg-subtle);
    color: var(--text-secondary);
    cursor: pointer;
    transition: color var(--transition-fast), border-color var(--transition-fast);
}
.docs-icon-btn:hover { color: var(--text-primary); border-color: var(--border-focus); }
.docs-icon-btn svg { width: 18px; height: 18px; }
.docs-menu-btn { display: none; }

/* ─── Shell / grid ──────────────────────────────────────────────────────── */
.docs-shell {
    display: grid;
    grid-template-columns: 264px minmax(0, 1fr) 220px;
    gap: 40px;
    max-width: 1320px;
    margin: 0 auto;
    padding: 0 28px;
    align-items: start;
}
@media (max-width: 1100px) {
    .docs-shell { grid-template-columns: 240px minmax(0, 1fr); }
    .docs-toc { display: none; }
}
@media (max-width: 860px) {
    .docs-shell { grid-template-columns: minmax(0, 1fr); padding: 0 18px; }
}

/* ─── Sidebar ───────────────────────────────────────────────────────────── */
.docs-sidebar {
    position: sticky;
    top: 60px;
    align-self: start;
    max-height: calc(100vh - 60px);
    overflow-y: auto;
    padding: 28px 8px 40px 0;
}
.docs-sidebar-title {
    font-size: 11px;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--text-muted);
    padding: 0 12px;
    margin-bottom: 10px;
}
.docs-sidebar-list { list-style: none; display: flex; flex-direction: column; gap: 2px; }
.docs-sidebar-list a {
    display: block;
    padding: 8px 12px;
    border-radius: var(--radius-sm);
    color: var(--text-secondary);
    text-decoration: none;
    font-size: 14px;
    line-height: 1.4;
    border-left: 2px solid transparent;
    transition: color var(--transition-fast), background var(--transition-fast);
}
.docs-sidebar-list a:hover { color: var(--text-primary); background: var(--bg-subtle); }
.docs-sidebar-list a[aria-current="page"] {
    color: var(--text-primary);
    background: var(--dix-primary-light);
    border-left-color: var(--dix-primary);
    font-weight: 600;
}

@media (max-width: 860px) {
    .docs-sidebar {
        position: fixed;
        inset: 60px auto 0 0;
        width: 280px;
        max-width: 84vw;
        background: var(--bg-elevated);
        border-right: 1px solid var(--border);
        padding: 20px 12px 40px;
        transform: translateX(-100%);
        transition: transform var(--transition-base);
        z-index: 90;
        box-shadow: var(--shadow-lg);
    }
    .docs-sidebar.is-open { transform: translateX(0); }
    .docs-menu-btn { display: grid; }
}
.docs-sidebar-backdrop {
    display: none;
    position: fixed; inset: 0;
    background: rgba(2, 6, 23, 0.5);
    z-index: 80;
}
.docs-sidebar-backdrop.is-open { display: block; }

/* ─── Article ───────────────────────────────────────────────────────────── */
.docs-article { padding: 32px 0 80px; min-width: 0; }
.docs-prose { max-width: 68ch; }

.docs-breadcrumb {
    font-size: 13px;
    color: var(--text-muted);
    margin-bottom: 18px;
}
.docs-breadcrumb a { color: var(--text-muted); text-decoration: none; }
.docs-breadcrumb a:hover { color: var(--text-secondary); text-decoration: underline; }
.docs-breadcrumb span[aria-current] { color: var(--text-secondary); }

.docs-prose h1 {
    font-family: var(--font-brand);
    font-size: clamp(28px, 4vw, 40px);
    font-weight: 800;
    line-height: 1.12;
    letter-spacing: -0.03em;
    color: var(--text-primary);
    margin-bottom: 8px;
}
.docs-meta {
    font-size: 13px;
    color: var(--text-muted);
    margin-bottom: 20px;
}

/* Lead = the 40–60 word direct answer (featured-snippet bait) */
.docs-lead {
    font-size: 19px;
    line-height: 1.6;
    color: var(--text-primary);
    padding: 16px 20px;
    border-left: 3px solid var(--dix-primary);
    background: var(--dix-primary-light);
    border-radius: 0 var(--radius-md) var(--radius-md) 0;
    margin-bottom: 32px;
}

.docs-prose h2 {
    font-family: var(--font-brand);
    font-size: 24px;
    font-weight: 700;
    line-height: 1.25;
    letter-spacing: -0.02em;
    color: var(--text-primary);
    margin: 44px 0 14px;
    scroll-margin-top: 76px;
}
.docs-prose h3 {
    font-size: 18px;
    font-weight: 700;
    color: var(--text-primary);
    margin: 28px 0 10px;
    scroll-margin-top: 76px;
}
.docs-prose p { font-size: 18px; line-height: 1.7; margin: 0 0 18px; }
.docs-prose ul, .docs-prose ol { margin: 0 0 18px; padding-left: 24px; }
.docs-prose li { font-size: 18px; line-height: 1.7; margin-bottom: 8px; }
.docs-prose a {
    color: var(--dix-primary);
    text-decoration: underline;
    text-underline-offset: 2px;
    text-decoration-thickness: 1px;
}
[data-theme="dark"] .docs-prose a { color: #a5b4fc; }
.docs-prose strong { color: var(--text-primary); font-weight: 700; }
.docs-prose code {
    font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
    font-size: 0.88em;
    background: var(--bg-subtle);
    border: 1px solid var(--border);
    border-radius: 6px;
    padding: 1px 6px;
}

/* Code block */
.docs-code {
    font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
    font-size: 14px;
    line-height: 1.6;
    background: #0b1220;
    color: #e2e8f0;
    border: 1px solid var(--border);
    border-radius: var(--radius-md);
    padding: 16px 18px;
    overflow-x: auto;
    margin: 0 0 24px;
}
.docs-code .tok-tag { color: #c084fc; }
.docs-code .tok-attr { color: #67e8f9; }
.docs-code .tok-str { color: #6ee7b7; }

/* Tables */
.docs-table-wrap { overflow-x: auto; margin: 0 0 24px; }
.docs-table {
    width: 100%;
    border-collapse: collapse;
    font-size: 15px;
}
.docs-table th, .docs-table td {
    text-align: left;
    padding: 11px 14px;
    border-bottom: 1px solid var(--border);
    vertical-align: top;
}
.docs-table th {
    color: var(--text-primary);
    font-weight: 700;
    background: var(--bg-subtle);
}
.docs-table td { color: var(--text-secondary); }

/* Callout */
.docs-callout {
    display: flex;
    gap: 12px;
    padding: 14px 16px;
    border: 1px solid var(--border);
    border-radius: var(--radius-md);
    background: var(--bg-subtle);
    margin: 0 0 24px;
    font-size: 15px;
    line-height: 1.6;
}
.docs-callout svg { width: 20px; height: 20px; flex-shrink: 0; color: var(--dix-primary); margin-top: 1px; }
.docs-callout.tip svg { color: var(--dix-success); }
.docs-callout.warn svg { color: var(--dix-warning); }

/* Numbered steps */
.docs-steps { list-style: none; counter-reset: step; padding-left: 0; margin: 0 0 28px; }
.docs-steps > li {
    position: relative;
    padding-left: 48px;
    margin-bottom: 18px;
    min-height: 32px;
}
.docs-steps > li::before {
    counter-increment: step;
    content: counter(step);
    position: absolute;
    left: 0; top: -2px;
    width: 32px; height: 32px;
    display: grid; place-items: center;
    border-radius: 9px;
    background: var(--dix-gradient);
    color: #fff;
    font-family: var(--font-brand);
    font-weight: 700;
    font-size: 14px;
    box-shadow: 0 2px 8px rgba(99, 102, 241, 0.3);
}

/* Mockup card (CSS/SVG illustration, no real screenshots) */
.docs-mockup {
    border: 1px solid var(--border);
    border-radius: var(--radius-lg);
    background: linear-gradient(180deg, var(--bg-elevated), var(--bg-subtle));
    padding: 20px;
    margin: 0 0 28px;
    box-shadow: var(--shadow-md);
}
.docs-mockup-caption { font-size: 13px; color: var(--text-muted); margin-top: 10px; text-align: center; }

/* Mini chat mockup */
.docs-chat { display: flex; flex-direction: column; gap: 10px; }
.docs-chat-row { display: flex; }
.docs-chat-row.user { justify-content: flex-end; }
.docs-bubble {
    max-width: 80%;
    padding: 9px 13px;
    font-size: 14px;
    line-height: 1.45;
    border-radius: 14px;
}
.docs-bubble.user { background: var(--dix-gradient); color: #fff; border-bottom-right-radius: 4px; }
.docs-bubble.bot { background: var(--bg-subtle); border: 1px solid var(--border); color: var(--text-secondary); border-bottom-left-radius: 4px; }

/* FAQ accordion */
.docs-faq { margin: 16px 0 8px; }
.docs-faq details {
    border: 1px solid var(--border);
    border-radius: var(--radius-md);
    background: var(--bg-elevated);
    margin-bottom: 10px;
    overflow: hidden;
}
.docs-faq summary {
    cursor: pointer;
    list-style: none;
    padding: 15px 18px;
    font-size: 16px;
    font-weight: 600;
    color: var(--text-primary);
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 12px;
}
.docs-faq summary::-webkit-details-marker { display: none; }
.docs-faq summary::after {
    content: '';
    width: 9px; height: 9px;
    border-right: 2px solid var(--text-muted);
    border-bottom: 2px solid var(--text-muted);
    transform: rotate(45deg);
    transition: transform var(--transition-fast);
    flex-shrink: 0;
}
.docs-faq details[open] summary::after { transform: rotate(-135deg); }
.docs-faq .docs-faq-body { padding: 0 18px 16px; font-size: 16px; line-height: 1.65; color: var(--text-secondary); }
.docs-faq .docs-faq-body :last-child { margin-bottom: 0; }

/* ─── On-page TOC ───────────────────────────────────────────────────────── */
.docs-toc {
    position: sticky;
    top: 60px;
    align-self: start;
    padding: 36px 0;
    font-size: 13px;
}
.docs-toc-title {
    font-size: 11px;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--text-muted);
    margin-bottom: 12px;
}
.docs-toc ul { list-style: none; display: flex; flex-direction: column; gap: 7px; }
.docs-toc a {
    color: var(--text-muted);
    text-decoration: none;
    line-height: 1.4;
    display: block;
    transition: color var(--transition-fast);
}
.docs-toc a:hover { color: var(--text-primary); }

/* ─── "Seguir leyendo" + CTA ────────────────────────────────────────────── */
.docs-related { margin: 48px 0 0; border-top: 1px solid var(--border); padding-top: 28px; }
.docs-related-title { font-family: var(--font-brand); font-size: 18px; font-weight: 700; color: var(--text-primary); margin-bottom: 16px; }
.docs-related-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); gap: 12px; }
.docs-card {
    display: block;
    text-decoration: none;
    border: 1px solid var(--border);
    border-radius: var(--radius-md);
    background: var(--bg-elevated);
    padding: 16px 18px;
    transition: border-color var(--transition-base), transform var(--transition-base);
}
.docs-card:hover { border-color: var(--border-focus); transform: translateY(-2px); }
.docs-card-title { font-size: 15px; font-weight: 700; color: var(--text-primary); margin-bottom: 4px; }
.docs-card-desc { font-size: 13px; color: var(--text-muted); line-height: 1.5; }

.docs-cta {
    margin: 40px 0 0;
    padding: 28px;
    text-align: center;
    border: 1px solid var(--border);
    border-radius: var(--radius-lg);
    background: linear-gradient(180deg, var(--dix-primary-light), transparent);
}
.docs-cta h2 { font-family: var(--font-brand); font-size: 22px; font-weight: 800; color: var(--text-primary); margin: 0 0 6px; }
.docs-cta p { font-size: 15px; color: var(--text-secondary); margin: 0 0 18px; }
.docs-btn {
    display: inline-flex; align-items: center; gap: 8px;
    background: var(--dix-gradient);
    color: #fff;
    font-weight: 600;
    font-size: 15px;
    text-decoration: none;
    padding: 12px 24px;
    border-radius: var(--radius-md);
    box-shadow: 0 8px 24px rgba(99, 102, 241, 0.35);
    transition: transform var(--transition-fast), filter var(--transition-fast);
}
.docs-btn:hover { transform: translateY(-1px); filter: brightness(1.06); }

/* ─── Pillar / index ────────────────────────────────────────────────────── */
.docs-hero { max-width: 760px; margin: 8px 0 36px; }
.docs-hero h1 {
    font-family: var(--font-brand);
    font-size: clamp(30px, 5vw, 46px);
    font-weight: 800;
    letter-spacing: -0.035em;
    line-height: 1.08;
    color: var(--text-primary);
    margin-bottom: 14px;
}
.docs-hero p { font-size: 18px; line-height: 1.6; color: var(--text-secondary); }
.docs-index-grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
    gap: 16px;
    padding-bottom: 64px;
}
.docs-index-card {
    display: flex;
    flex-direction: column;
    gap: 8px;
    text-decoration: none;
    border: 1px solid var(--border);
    border-radius: var(--radius-lg);
    background: var(--bg-elevated);
    padding: 22px;
    transition: border-color var(--transition-base), transform var(--transition-base), box-shadow var(--transition-base);
}
.docs-index-card:hover { border-color: var(--border-focus); transform: translateY(-3px); box-shadow: var(--shadow-md); }
.docs-index-card h2 { font-family: var(--font-brand); font-size: 18px; font-weight: 700; color: var(--text-primary); line-height: 1.3; letter-spacing: -0.01em; }
.docs-index-card p { font-size: 14px; line-height: 1.55; color: var(--text-muted); }
.docs-index-card .arrow { margin-top: auto; color: var(--dix-primary); font-size: 14px; font-weight: 600; }
