/* ============================================================
   docs.css — Styles for docs.html (Configuration Documentation)
   All comments in English. Uses variables from main.css.
   ============================================================ */

/* ── Page layout ── */
.docs-page {
    display: flex;
    min-height: 100vh;
}

/* ── Hero ── */
.docs-hero {
    padding: 140px 0 80px;
    border-bottom: 1px solid rgba(0,0,0,0.06);
    /* Ensure hero always paints above the sticky sidebar during scroll overlap */
    position: relative;
    z-index: 2;
    background: var(--bg-color);
}

.docs-hero-eyebrow {
    display: inline-flex;
    align-items: center;
    gap: 8px;
    font-size: 0.7rem;
    font-weight: 500;
    letter-spacing: 0.14em;
    text-transform: uppercase;
    color: var(--text-secondary);
    margin-bottom: 24px;
}

.docs-hero h1 {
    font-size: clamp(2.8rem, 6vw, 5rem);
    font-weight: 300;
    letter-spacing: -0.04em;
    line-height: 1.05;
    margin-bottom: 20px;
    color: var(--text-primary);
}

.docs-hero-desc {
    font-size: 1.05rem;
    color: var(--text-secondary);
    font-weight: 300;
    max-width: 600px;
    line-height: 1.7;
    margin-bottom: 36px;
}

.docs-hero-actions {
    display: flex;
    gap: 12px;
    flex-wrap: wrap;
}

/* ── Quick nav chips ── */
.docs-quick-nav {
    display: flex;
    gap: 10px;
    flex-wrap: wrap;
    margin-top: 40px;
    padding-top: 32px;
    border-top: 1px solid rgba(0,0,0,0.06);
}

.docs-chip {
    display: inline-flex;
    align-items: center;
    gap: 6px;
    padding: 7px 16px;
    border-radius: 999px;
    background: var(--surface-color);
    border: 1px solid rgba(0,0,0,0.06);
    font-size: 0.82rem;
    color: var(--text-secondary);
    cursor: pointer;
    transition: var(--transition);
    text-decoration: none;
}

.docs-chip:hover {
    background: var(--surface-hover);
    color: var(--text-primary);
}

.docs-chip i {
    font-size: 0.75rem;
}

/* ── Main docs body: sidebar + content ── */
/* Use flexbox instead of grid — sticky sidebars have known positional quirks in CSS Grid */
.docs-body {
    display: flex;
    align-items: flex-start;
    max-width: 1280px;
    margin: 0 auto;
    padding: 0 5vw;
    position: relative;
    z-index: 1;
}

/* ── Sidebar ── */
.docs-sidebar {
    position: -webkit-sticky;
    position: sticky;
    top: 80px;           /* nav is 72px; 8px breathing room */
    align-self: flex-start; /* required for sticky inside a flex container */
    width: 240px;
    flex-shrink: 0;
    padding: 32px 32px 48px 0;
    max-height: calc(100vh - 80px);
    overflow-y: auto;
    scrollbar-width: none;
    z-index: 1;
}

.docs-sidebar::-webkit-scrollbar { display: none; }

.docs-sidebar-title {
    font-size: 0.65rem;
    font-weight: 500;
    letter-spacing: 0.14em;
    text-transform: uppercase;
    color: var(--text-secondary);
    margin-bottom: 16px;
}

.docs-nav {
    display: flex;
    flex-direction: column;
    gap: 2px;
}

.docs-nav-group {
    margin-bottom: 20px;
}

.docs-nav-group-label {
    font-size: 0.7rem;
    font-weight: 500;
    letter-spacing: 0.1em;
    text-transform: uppercase;
    color: rgba(0,0,0,0.35);
    padding: 4px 10px;
    margin-bottom: 4px;
}

.docs-nav-link {
    display: flex;
    align-items: center;
    gap: 8px;
    padding: 7px 10px;
    border-radius: 8px;
    font-size: 0.875rem;
    color: var(--text-secondary);
    transition: var(--transition);
    cursor: pointer;
    text-decoration: none;
}

.docs-nav-link:hover {
    background: var(--surface-color);
    color: var(--text-primary);
}

.docs-nav-link.active {
    background: var(--surface-color);
    color: var(--text-primary);
    font-weight: 400;
}

.docs-nav-link i {
    font-size: 0.75rem;
    width: 14px;
    text-align: center;
    color: rgba(0,0,0,0.3);
}

.docs-nav-link.active i {
    color: var(--text-primary);
}

/* ── Content area ── */
.docs-content {
    flex: 1;             /* take all remaining width */
    min-width: 0;        /* allow flex item to shrink below its content size */
    padding: 48px 0 80px 48px;
    border-left: 1px solid rgba(0,0,0,0.06);
}

/* ── Section blocks ── */
.docs-section {
    margin-bottom: 72px;
    scroll-margin-top: 100px;
}

.docs-section-eyebrow {
    font-size: 0.65rem;
    font-weight: 500;
    letter-spacing: 0.14em;
    text-transform: uppercase;
    color: var(--text-secondary);
    margin-bottom: 12px;
}

.docs-section h2 {
    font-size: clamp(1.5rem, 3vw, 2rem);
    font-weight: 300;
    letter-spacing: -0.03em;
    line-height: 1.2;
    margin-bottom: 16px;
}

.docs-section h3 {
    font-size: 1.05rem;
    font-weight: 400;
    letter-spacing: -0.02em;
    margin: 28px 0 12px;
    color: var(--text-primary);
}

.docs-section p {
    font-size: 0.95rem;
    color: var(--text-secondary);
    line-height: 1.75;
    margin-bottom: 16px;
    font-weight: 300;
}

.docs-section p strong {
    color: var(--text-primary);
    font-weight: 400;
}

.docs-section-divider {
    height: 1px;
    background: rgba(0,0,0,0.06);
    margin-bottom: 72px;
}

/* ── Step cards ── */
.docs-steps {
    display: flex;
    flex-direction: column;
    gap: 16px;
    margin: 24px 0;
}

.docs-step {
    display: grid;
    grid-template-columns: 40px 1fr;
    gap: 16px;
    align-items: start;
    padding: 20px;
    background: var(--surface-color);
    border-radius: var(--border-radius-sm);
    border: 1px solid rgba(0,0,0,0.05);
    min-width: 0;
    overflow: hidden;
}

.docs-step-num {
    width: 28px;
    height: 28px;
    border-radius: 50%;
    background: var(--text-primary);
    color: white;
    display: flex;
    align-items: center;
    justify-content: center;
    font-size: 0.75rem;
    font-weight: 500;
    flex-shrink: 0;
    margin-top: 2px;
}

.docs-step-body h4 {
    font-size: 0.95rem;
    font-weight: 400;
    margin-bottom: 6px;
    color: var(--text-primary);
}

.docs-step-body p {
    font-size: 0.875rem;
    margin: 0;
    line-height: 1.65;
    overflow-wrap: break-word;
    word-break: break-word;
}

/* ── Code blocks ── */
.code-block {
    background: #0f1117;
    border-radius: var(--border-radius-sm);
    overflow: hidden;
    margin: 20px 0;
    border: 1px solid rgba(255,255,255,0.04);
}

.code-block-header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    padding: 12px 16px;
    background: rgba(255,255,255,0.04);
    border-bottom: 1px solid rgba(255,255,255,0.06);
}

.code-block-lang {
    font-size: 0.68rem;
    font-weight: 500;
    letter-spacing: 0.1em;
    text-transform: uppercase;
    color: rgba(255,255,255,0.35);
}

.code-block-copy {
    display: inline-flex;
    align-items: center;
    gap: 5px;
    font-size: 0.72rem;
    color: rgba(255,255,255,0.35);
    background: none;
    border: none;
    cursor: pointer;
    padding: 3px 8px;
    border-radius: 5px;
    transition: var(--transition);
}

.code-block-copy:hover {
    background: rgba(255,255,255,0.08);
    color: rgba(255,255,255,0.7);
}

.code-block-copy.copied {
    color: #4ade80;
}

.code-block pre {
    padding: 20px;
    overflow-x: auto;
    margin: 0;
}

.code-block code {
    font-family: 'SF Mono', 'Fira Code', 'Consolas', monospace;
    font-size: 0.82rem;
    line-height: 1.7;
    color: #e2e8f0;
    white-space: pre;
}

/* YAML syntax highlighting */
.yaml-key     { color: #7dd3fc; }
.yaml-value   { color: #86efac; }
.yaml-comment { color: #64748b; }
.yaml-string  { color: #fde68a; }
.yaml-number  { color: #fb923c; }
.yaml-bool    { color: #c084fc; }
.yaml-dash    { color: #94a3b8; }
.yaml-anchor  { color: #f472b6; }

/* ── Info / tip boxes ── */
.docs-tip {
    display: flex;
    gap: 14px;
    align-items: flex-start;
    padding: 16px 20px;
    border-radius: var(--border-radius-sm);
    margin: 20px 0;
    background: var(--surface-color);
    border: 1px solid rgba(0,0,0,0.05);
    border-left: 3px solid rgba(0,0,0,0.15);
}

.docs-tip.tip-info {
    border-left-color: #3b82f6;
}

.docs-tip.tip-warn {
    border-left-color: #f59e0b;
}

.docs-tip.tip-success {
    border-left-color: #22c55e;
}

.docs-tip-icon {
    font-size: 0.9rem;
    margin-top: 2px;
    flex-shrink: 0;
}

.docs-tip.tip-info .docs-tip-icon { color: #3b82f6; }
.docs-tip.tip-warn .docs-tip-icon { color: #f59e0b; }
.docs-tip.tip-success .docs-tip-icon { color: #22c55e; }

.docs-tip p {
    font-size: 0.875rem;
    margin: 0;
    line-height: 1.65;
    overflow-wrap: break-word;
    word-break: break-word;
}

/* ── Option tables ── */
.docs-table-wrap {
    overflow-x: auto;
    margin: 20px 0;
    border-radius: var(--border-radius-sm);
    border: 1px solid rgba(0,0,0,0.06);
}

.docs-table {
    width: 100%;
    border-collapse: collapse;
    font-size: 0.86rem;
}

.docs-table thead tr {
    background: var(--surface-color);
    border-bottom: 1px solid rgba(0,0,0,0.07);
}

.docs-table th {
    padding: 12px 16px;
    text-align: left;
    font-weight: 400;
    font-size: 0.78rem;
    letter-spacing: 0.04em;
    color: var(--text-secondary);
}

.docs-table td {
    padding: 12px 16px;
    border-bottom: 1px solid rgba(0,0,0,0.05);
    color: var(--text-secondary);
    font-weight: 300;
    vertical-align: top;
    line-height: 1.6;
}

.docs-table tr:last-child td {
    border-bottom: none;
}

.docs-table td:first-child {
    font-family: 'SF Mono', 'Fira Code', 'Consolas', monospace;
    font-size: 0.78rem;
    color: var(--text-primary);
    white-space: nowrap;
}

.docs-table td code {
    font-family: 'SF Mono', 'Fira Code', 'Consolas', monospace;
    font-size: 0.78rem;
    background: var(--surface-color);
    padding: 1px 5px;
    border-radius: 4px;
    border: 1px solid rgba(0,0,0,0.06);
    color: var(--text-primary);
}

/* ── Protocol badge grid ── */
.protocol-grid {
    display: flex;
    flex-wrap: wrap;
    gap: 8px;
    margin: 16px 0;
}

.protocol-badge {
    padding: 5px 14px;
    border-radius: 999px;
    background: var(--surface-color);
    border: 1px solid rgba(0,0,0,0.06);
    font-size: 0.8rem;
    color: var(--text-secondary);
    font-weight: 300;
}

/* ── Rule type table row highlights ── */
.rule-type-direct { color: #16a34a; }
.rule-type-proxy  { color: #2563eb; }
.rule-type-reject { color: #dc2626; }

/* ── Inline code (paragraphs only, not inside code blocks) ── */
.docs-section p code,
.docs-section li code,
.docs-section td code,
.docs-section h3 code {
    font-family: 'SF Mono', 'Fira Code', 'Consolas', monospace;
    font-size: 0.82em;
    background: var(--surface-color);
    padding: 2px 6px;
    border-radius: 5px;
    border: 1px solid rgba(0,0,0,0.07);
    color: var(--text-primary);
}

/* ── Download CTA bar at bottom ── */
.docs-cta {
    margin-top: 40px;
    padding: 40px;
    background: var(--surface-color);
    border-radius: var(--border-radius-md);
    border: 1px solid rgba(0,0,0,0.06);
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 24px;
    flex-wrap: wrap;
}

.docs-cta-text h3 {
    font-size: 1.2rem;
    font-weight: 400;
    letter-spacing: -0.02em;
    margin-bottom: 6px;
}

.docs-cta-text p {
    font-size: 0.875rem;
    color: var(--text-secondary);
    margin: 0;
    font-weight: 300;
}

.docs-cta-actions {
    display: flex;
    gap: 10px;
    flex-shrink: 0;
    flex-wrap: wrap;
}

/* ── Back-to-top ── */
#back-to-top {
    position: fixed;
    bottom: 32px;
    right: 32px;
    width: 40px;
    height: 40px;
    border-radius: 50%;
    background: var(--text-primary);
    color: #fff;
    border: none;
    cursor: pointer;
    display: flex;
    align-items: center;
    justify-content: center;
    font-size: 0.85rem;
    opacity: 0;
    transform: translateY(12px);
    transition: opacity 0.3s ease, transform 0.3s ease;
    z-index: 200;
}

#back-to-top.visible {
    opacity: 1;
    transform: translateY(0);
}

#back-to-top:hover {
    background: #333;
}

/* ── Fade-in animation ── */
.fade-in-up {
    opacity: 0;
    transform: translateY(24px);
    transition: opacity 0.6s cubic-bezier(0.16, 1, 0.3, 1), transform 0.6s cubic-bezier(0.16, 1, 0.3, 1);
}

.fade-in-up.visible {
    opacity: 1;
    transform: translateY(0);
}

/* ── Mobile: stack sidebar above content ── */
@media (max-width: 900px) {
    .docs-body {
        flex-direction: column;
        align-items: stretch; /* reset from flex-start so children fill full width */
        padding: 0 5vw;
    }

    .docs-sidebar {
        position: static;
        width: 100%;
        max-height: none;
        overflow: visible;
        padding: 24px 0 0;
        border-bottom: 1px solid rgba(0,0,0,0.06);
    }

    .docs-nav {
        flex-direction: row;
        flex-wrap: wrap;
    }

    .docs-nav-group {
        margin-bottom: 0;
        display: flex;
        flex-wrap: wrap;
        align-items: center;
        gap: 4px;
    }

    .docs-nav-group-label { display: none; }

    .docs-nav-link {
        font-size: 0.78rem;
        padding: 5px 10px;
        white-space: nowrap;
    }

    .docs-content {
        width: 100%;
        min-width: 0;
        padding: 32px 0 60px;
        border-left: none;
        border-top: 1px solid rgba(0,0,0,0.06);
    }

    .docs-hero {
        padding: 100px 0 48px;
    }

    .docs-cta {
        flex-direction: column;
        align-items: flex-start;
    }

    .docs-step {
        grid-template-columns: 32px 1fr;
    }
}

@media (max-width: 600px) {
    .docs-hero h1 {
        font-size: 2.4rem;
    }

    .code-block pre {
        padding: 16px;
    }

    .docs-table td, .docs-table th {
        padding: 10px 12px;
        font-size: 0.82rem;
    }

    .docs-table td:first-child {
        font-size: 0.76rem;
    }
}
