/* ==========================================================================
   2026 Production-Grade Documentation & Legal Pages Design System
   Matches Vercel, Stripe, Linear, Notion, Cloudflare Docs & GitHub Docs standards.
   ========================================================================== */

/* ─── 1. DESIGN TOKENS & THEMING (LIGHT & DARK MODE) ───────── */
:root, :root[data-theme="light"] {
    --doc-font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif;
    --doc-font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
    
    --doc-bg-body: #F8FAFC;
    --doc-bg-card: #FFFFFF;
    --doc-bg-sidebar: #F1F5F9;
    --doc-bg-hover: #E2E8F0;
    
    --doc-text-main: #0F172A;
    --doc-text-muted: #475569;
    --doc-text-light: #64748B;
    
    --doc-border-color: #E2E8F0;
    --doc-border-strong: #CBD5E1;
    
    --doc-primary: #DC2626;      /* Signature Sarkari Result Red */
    --doc-primary-hover: #B91C1C;
    --doc-primary-light: #FEF2F2;
    
    --doc-accent-blue: #0284C7;
    --doc-accent-blue-bg: #F0F9FF;
    --doc-accent-amber: #D97706;
    --doc-accent-amber-bg: #FFFBEB;
    --doc-accent-emerald: #059669;
    --doc-accent-emerald-bg: #ECFDF5;
    --doc-accent-purple: #7C3AED;
    --doc-accent-purple-bg: #F5F3FF;

    --doc-radius-sm: 6px;
    --doc-radius-md: 10px;
    --doc-radius-lg: 16px;

    --doc-shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
    --doc-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
    --doc-shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
}

/* Dark Mode Theme Tokens */
:root[data-theme="dark"] {
    --doc-bg-body: #0F172A;
    --doc-bg-card: #1E293B;
    --doc-bg-sidebar: #0F172A;
    --doc-bg-hover: #334155;
    
    --doc-text-main: #F8FAFC;
    --doc-text-muted: #94A3B8;
    --doc-text-light: #64748B;
    
    --doc-border-color: #334155;
    --doc-border-strong: #475569;
    
    --doc-primary-light: rgba(220, 38, 38, 0.2);
    
    --doc-accent-blue-bg: rgba(2, 132, 199, 0.15);
    --doc-accent-amber-bg: rgba(217, 119, 6, 0.15);
    --doc-accent-emerald-bg: rgba(5, 150, 105, 0.15);
    --doc-accent-purple-bg: rgba(124, 58, 237, 0.15);
}

@media (prefers-color-scheme: dark) {
    :root:not([data-theme="light"]) {
        --doc-bg-body: #0F172A;
        --doc-bg-card: #1E293B;
        --doc-bg-sidebar: #0F172A;
        --doc-bg-hover: #334155;
        
        --doc-text-main: #F8FAFC;
        --doc-text-muted: #94A3B8;
        --doc-text-light: #64748B;
        
        --doc-border-color: #334155;
        --doc-border-strong: #475569;
        
        --doc-primary-light: rgba(220, 38, 38, 0.2);
        
        --doc-accent-blue-bg: rgba(2, 132, 199, 0.15);
        --doc-accent-amber-bg: rgba(217, 119, 6, 0.15);
        --doc-accent-emerald-bg: rgba(5, 150, 105, 0.15);
        --doc-accent-purple-bg: rgba(124, 58, 237, 0.15);
    }
}

/* ─── 2. SKIP NAVIGATION FOR ACCESSIBILITY ────────────────── */
.doc-skip-link {
    position: absolute;
    top: -100px;
    left: 20px;
    background: var(--doc-primary);
    color: #FFFFFF;
    padding: 10px 20px;
    border-radius: 0 0 var(--doc-radius-sm) var(--doc-radius-sm);
    font-weight: 700;
    font-size: 0.9rem;
    z-index: 99999;
    transition: top 0.2s ease;
    text-decoration: none;
    box-shadow: var(--doc-shadow-md);
}

.doc-skip-link:focus {
    top: 0;
    outline: 3px solid #F59E0B;
}

/* ─── 3. READING PROGRESS BAR ─────────────────────────────── */
.doc-reading-progress-container {
    position: fixed;
    top: 0;
    left: 0;
    width: 100%;
    height: 3px;
    background: transparent;
    z-index: 9999;
}

.doc-reading-progress-bar {
    height: 100%;
    width: 0%;
    background: linear-gradient(90deg, #DC2626, #EF4444, #F59E0B);
    transition: width 0.1s linear;
}

/* ─── 4. MAIN DOC PAGE WRAPPER ────────────────────────────── */
.doc-page-wrapper {
    background-color: var(--doc-bg-body);
    color: var(--doc-text-main);
    font-family: var(--doc-font-sans);
    line-height: 1.65;
    padding-bottom: 60px;
    min-height: 100vh;
    transition: background-color 0.25s ease, color 0.25s ease;
}

.doc-container {
    max-width: 1380px;
    margin: 0 auto;
    padding: 24px 20px;
}

.doc-hero-section {
    background: var(--doc-bg-card);
    border: 1px solid var(--doc-border-color);
    border-radius: var(--doc-radius-lg);
    padding: 36px 40px;
    margin-bottom: 32px;
    box-shadow: var(--doc-shadow-sm);
    position: relative;
    overflow: hidden;
    transition: background-color 0.25s ease, border-color 0.25s ease;
}

.doc-hero-section::before {
    content: "";
    position: absolute;
    top: 0;
    left: 0;
    width: 6px;
    height: 100%;
    background: linear-gradient(180deg, var(--doc-primary), #F59E0B);
}

.doc-hero-header-row {
    display: flex;
    align-items: flex-start;
    justify-content: space-between;
    gap: 20px;
}

.doc-breadcrumb {
    display: flex;
    align-items: center;
    gap: 8px;
    font-size: 0.85rem;
    font-weight: 500;
    color: var(--doc-text-light);
    margin-bottom: 16px;
    flex-wrap: wrap;
}

.doc-breadcrumb a {
    color: var(--doc-text-muted);
    text-decoration: none;
    transition: color 0.15s ease;
}

.doc-breadcrumb a:hover {
    color: var(--doc-primary);
}

.doc-hero-title {
    font-size: 2.25rem;
    font-weight: 800;
    letter-spacing: -0.025em;
    color: var(--doc-text-main);
    margin: 0 0 12px 0;
    line-height: 1.25;
}

.doc-hero-desc {
    font-size: 1.05rem;
    color: var(--doc-text-muted);
    margin: 0 0 20px 0;
    max-width: 820px;
}

.doc-meta-badge-bar {
    display: flex;
    align-items: center;
    gap: 16px;
    flex-wrap: wrap;
    font-size: 0.825rem;
    color: var(--doc-text-light);
}

.doc-meta-pill {
    display: inline-flex;
    align-items: center;
    gap: 6px;
    background: var(--doc-bg-sidebar);
    border: 1px solid var(--doc-border-color);
    padding: 4px 12px;
    border-radius: 9999px;
    font-weight: 600;
    color: var(--doc-text-muted);
}

.doc-meta-pill i {
    color: var(--doc-primary);
}

/* ─── 5. THEME TOGGLE BUTTON ──────────────────────────────── */
.doc-theme-toggle {
    background: var(--doc-bg-sidebar);
    border: 1px solid var(--doc-border-color);
    color: var(--doc-text-main);
    width: 40px;
    height: 40px;
    border-radius: 50%;
    display: flex;
    align-items: center;
    justify-content: center;
    cursor: pointer;
    font-size: 1.05rem;
    transition: all 0.2s ease;
    flex-shrink: 0;
}

.doc-theme-toggle:hover {
    background: var(--doc-bg-hover);
    color: var(--doc-primary);
    transform: rotate(15deg);
}

.doc-theme-toggle:focus-visible {
    outline: 2px solid var(--doc-primary);
}

/* ─── 6. 3-COLUMN DOCUMENTATION GRID LAYOUT ───────────────── */
.doc-grid-layout {
    display: grid;
    grid-template-columns: 240px minmax(0, 760px) 260px;
    gap: 36px;
    align-items: start;
    justify-content: center;
}

@media (max-width: 1200px) {
    .doc-grid-layout {
        grid-template-columns: 220px minmax(0, 1fr);
    }
    .doc-right-sidebar {
        display: none;
    }
}

@media (max-width: 860px) {
    .doc-grid-layout {
        grid-template-columns: minmax(0, 1fr);
    }
    .doc-left-sidebar {
        display: none;
    }
}

/* ─── 7. LEFT SIDEBAR (STICKY NAVIGATION) ─────────────────── */
.doc-left-sidebar {
    position: sticky;
    top: 90px;
    background: var(--doc-bg-card);
    border: 1px solid var(--doc-border-color);
    border-radius: var(--doc-radius-md);
    padding: 20px;
    box-shadow: var(--doc-shadow-sm);
    transition: background-color 0.25s ease, border-color 0.25s ease;
}

.doc-sidebar-heading {
    font-size: 0.75rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--doc-text-light);
    margin-bottom: 14px;
    padding-bottom: 8px;
    border-bottom: 1px solid var(--doc-border-color);
}

.doc-nav-list {
    list-style: none;
    padding: 0;
    margin: 0;
    display: flex;
    flex-direction: column;
    gap: 4px;
}

.doc-nav-item a {
    display: flex;
    align-items: center;
    gap: 10px;
    padding: 9px 12px;
    border-radius: var(--doc-radius-sm);
    color: var(--doc-text-muted);
    font-size: 0.9rem;
    font-weight: 500;
    text-decoration: none;
    transition: all 0.15s ease;
}

.doc-nav-item a:hover {
    background-color: var(--doc-bg-sidebar);
    color: var(--doc-text-main);
}

.doc-nav-item.active a {
    background-color: var(--doc-primary-light);
    color: var(--doc-primary);
    font-weight: 700;
    border-left: 3px solid var(--doc-primary);
}

/* ─── 8. MAIN CONTENT AREA & HEADING ANCHORS ───────────────── */
.doc-main-content {
    background: var(--doc-bg-card);
    border: 1px solid var(--doc-border-color);
    border-radius: var(--doc-radius-lg);
    padding: 40px;
    box-shadow: var(--doc-shadow-sm);
    transition: background-color 0.25s ease, border-color 0.25s ease;
}

.doc-main-content h2 {
    font-size: 1.5rem;
    font-weight: 700;
    color: var(--doc-text-main);
    margin: 40px 0 16px 0;
    padding-bottom: 10px;
    border-bottom: 1px solid var(--doc-border-color);
    letter-spacing: -0.015em;
    scroll-margin-top: 100px;
    position: relative;
}

.doc-main-content h2:first-of-type {
    margin-top: 0;
}

.doc-main-content h3 {
    font-size: 1.18rem;
    font-weight: 600;
    color: var(--doc-text-main);
    margin: 28px 0 12px 0;
    scroll-margin-top: 100px;
    position: relative;
}

/* Heading Anchor Link */
.heading-anchor {
    margin-left: 8px;
    color: var(--doc-text-light);
    font-size: 0.85em;
    text-decoration: none !important;
    opacity: 0;
    transition: opacity 0.15s ease, color 0.15s ease;
    cursor: pointer;
}

.doc-main-content h2:hover .heading-anchor,
.doc-main-content h3:hover .heading-anchor,
.heading-anchor:focus {
    opacity: 0.7;
}

.heading-anchor:hover {
    opacity: 1 !important;
    color: var(--doc-primary);
}

.doc-main-content p {
    font-size: 0.98rem;
    color: var(--doc-text-muted);
    margin-bottom: 18px;
    line-height: 1.7;
}

.doc-main-content ul, .doc-main-content ol {
    margin: 0 0 20px 0;
    padding-left: 24px;
    color: var(--doc-text-muted);
}

.doc-main-content li {
    margin-bottom: 8px;
    font-size: 0.96rem;
    line-height: 1.65;
}

.doc-main-content strong {
    color: var(--doc-text-main);
    font-weight: 600;
}

.doc-main-content a {
    color: var(--doc-primary);
    text-decoration: underline;
    text-underline-offset: 3px;
    font-weight: 500;
    transition: color 0.15s ease;
}

.doc-main-content a:hover {
    color: var(--doc-primary-hover);
}

/* ─── 9. CALLOUT & NOTICE BOXES ───────────────────────────── */
.doc-callout {
    padding: 20px;
    border-radius: var(--doc-radius-md);
    margin: 24px 0;
    border-left: 4px solid;
    display: flex;
    gap: 16px;
    align-items: flex-start;
}

.doc-callout-icon {
    font-size: 1.25rem;
    flex-shrink: 0;
    margin-top: 2px;
}

.doc-callout-body {
    flex: 1;
}

.doc-callout-title {
    font-weight: 700;
    font-size: 0.95rem;
    margin-bottom: 6px;
    color: var(--doc-text-main);
}

.doc-callout-body p {
    margin-bottom: 0 !important;
    font-size: 0.925rem;
}

/* Callout Variants */
.callout-info {
    background-color: var(--doc-accent-blue-bg);
    border-color: var(--doc-accent-blue);
    color: var(--doc-text-main);
}

.callout-warning {
    background-color: var(--doc-accent-amber-bg);
    border-color: var(--doc-accent-amber);
    color: var(--doc-text-main);
}

.callout-legal {
    background-color: var(--doc-primary-light);
    border-color: var(--doc-primary);
    color: var(--doc-text-main);
}

.callout-success {
    background-color: var(--doc-accent-emerald-bg);
    border-color: var(--doc-accent-emerald);
    color: var(--doc-text-main);
}

/* ─── 10. ICON CARDS GRID ─────────────────────────────────── */
.icon-card-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
    gap: 20px;
    margin: 28px 0;
}

.icon-card {
    background: var(--doc-bg-body);
    border: 1px solid var(--doc-border-color);
    border-radius: var(--doc-radius-md);
    padding: 22px;
    transition: transform 0.2s ease, box-shadow 0.2s ease, background-color 0.25s ease;
}

.icon-card:hover {
    transform: translateY(-2px);
    box-shadow: var(--doc-shadow-md);
    border-color: var(--doc-border-strong);
}

.icon-card-header {
    display: flex;
    align-items: center;
    gap: 12px;
    margin-bottom: 12px;
}

.icon-card-badge {
    width: 40px;
    height: 40px;
    border-radius: 10px;
    display: flex;
    align-items: center;
    justify-content: center;
    font-size: 1.15rem;
    background: var(--doc-primary-light);
    color: var(--doc-primary);
}

.icon-card-title {
    font-weight: 700;
    font-size: 1.05rem;
    color: var(--doc-text-main);
    margin: 0;
}

.icon-card-desc {
    font-size: 0.9rem;
    color: var(--doc-text-muted);
    margin: 0;
    line-height: 1.6;
}

/* ─── 11. CONTACT CARDS GRID ──────────────────────────────── */
.contact-card-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));
    gap: 20px;
    margin: 28px 0;
}

.contact-card {
    background: var(--doc-bg-body);
    border: 1px solid var(--doc-border-color);
    border-radius: var(--doc-radius-md);
    padding: 24px;
    position: relative;
    transition: background-color 0.25s ease, border-color 0.25s ease;
}

.contact-card-title {
    font-weight: 700;
    font-size: 1.05rem;
    color: var(--doc-text-main);
    margin-bottom: 8px;
    display: flex;
    align-items: center;
    gap: 8px;
}

.contact-card-title i {
    color: var(--doc-primary);
}

.contact-card-desc {
    font-size: 0.9rem;
    color: var(--doc-text-muted);
    margin-bottom: 16px;
}

.contact-card-email {
    display: inline-flex;
    align-items: center;
    gap: 8px;
    font-size: 0.9rem;
    font-weight: 700;
    color: var(--doc-primary) !important;
    background: var(--doc-primary-light);
    padding: 8px 14px;
    border-radius: var(--doc-radius-sm);
    text-decoration: none !important;
    border: 1px solid rgba(220, 38, 38, 0.2);
}

.contact-card-email:hover {
    background: var(--doc-bg-hover);
}

/* ─── 12. FAQ ACCORDION COMPONENT ─────────────────────────── */
.faq-accordion-group {
    display: flex;
    flex-direction: column;
    gap: 12px;
    margin: 28px 0;
}

.faq-accordion-item {
    background: var(--doc-bg-body);
    border: 1px solid var(--doc-border-color);
    border-radius: var(--doc-radius-md);
    overflow: hidden;
    transition: border-color 0.15s ease, background-color 0.25s ease;
}

.faq-accordion-item.open {
    border-color: var(--doc-border-strong);
}

.faq-accordion-header {
    width: 100%;
    background: transparent;
    border: none;
    padding: 18px 22px;
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 16px;
    text-align: left;
    font-size: 0.98rem;
    font-weight: 700;
    color: var(--doc-text-main);
    cursor: pointer;
}

.faq-accordion-header:focus-visible {
    outline: 2px solid var(--doc-primary);
    outline-offset: -2px;
}

.faq-chevron {
    font-size: 0.85rem;
    color: var(--doc-text-light);
    transition: transform 0.25s cubic-bezier(0.4, 0, 0.2, 1);
}

.faq-accordion-item.open .faq-chevron {
    transform: rotate(180deg);
    color: var(--doc-primary);
}

.faq-accordion-body {
    max-height: 0;
    overflow: hidden;
    transition: max-height 0.3s cubic-bezier(0.4, 0, 0.2, 1), padding 0.3s cubic-bezier(0.4, 0, 0.2, 1);
    padding: 0 22px;
}

.faq-accordion-item.open .faq-accordion-body {
    max-height: 400px;
    padding: 0 22px 20px 22px;
}

.faq-accordion-body p {
    margin: 0;
    font-size: 0.94rem;
    color: var(--doc-text-muted);
    line-height: 1.65;
}

/* ─── 13. RIGHT SIDEBAR (STICKY TOC) ─────────────────────── */
.doc-right-sidebar {
    position: sticky;
    top: 90px;
    background: var(--doc-bg-card);
    border: 1px solid var(--doc-border-color);
    border-radius: var(--doc-radius-md);
    padding: 20px;
    box-shadow: var(--doc-shadow-sm);
    max-height: calc(100vh - 120px);
    overflow-y: auto;
    transition: background-color 0.25s ease, border-color 0.25s ease;
}

.doc-toc-title {
    font-size: 0.75rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--doc-text-light);
    margin-bottom: 12px;
    padding-bottom: 8px;
    border-bottom: 1px solid var(--doc-border-color);
}

.doc-toc-list {
    list-style: none;
    padding: 0;
    margin: 0;
    display: flex;
    flex-direction: column;
    gap: 6px;
}

.doc-toc-item a {
    font-size: 0.84rem;
    color: var(--doc-text-muted);
    text-decoration: none;
    display: block;
    line-height: 1.45;
    padding: 4px 8px;
    border-radius: var(--doc-radius-sm);
    transition: all 0.15s ease;
}

.doc-toc-item a:hover {
    color: var(--doc-primary);
    background-color: var(--doc-bg-sidebar);
}

.doc-toc-item.active a {
    color: var(--doc-primary);
    font-weight: 700;
    background-color: var(--doc-primary-light);
}

/* ─── 14. MOBILE COLLAPSIBLE TOC DRAWER ────────────────────── */
.doc-mobile-toc-container {
    display: none;
    margin-bottom: 24px;
    background: var(--doc-bg-card);
    border: 1px solid var(--doc-border-color);
    border-radius: var(--doc-radius-md);
    overflow: hidden;
}

.doc-mobile-toc-toggle {
    width: 100%;
    background: transparent;
    border: none;
    padding: 14px 18px;
    display: flex;
    align-items: center;
    justify-content: space-between;
    font-size: 0.9rem;
    font-weight: 700;
    color: var(--doc-text-main);
    cursor: pointer;
}

.doc-mobile-toc-body {
    max-height: 0;
    overflow: hidden;
    transition: max-height 0.3s ease, padding 0.3s ease;
    padding: 0 18px;
}

.doc-mobile-toc-container.open .doc-mobile-toc-body {
    max-height: 500px;
    padding: 0 18px 16px 18px;
}

.doc-mobile-toc-container.open .faq-chevron {
    transform: rotate(180deg);
}

@media (max-width: 1200px) {
    .doc-mobile-toc-container {
        display: block;
    }
}

/* ─── 15. BACK TO TOP BUTTON & TOAST NOTIFICATION ──────────── */
.doc-back-top-btn {
    position: fixed;
    bottom: 30px;
    right: 30px;
    width: 44px;
    height: 44px;
    border-radius: 50%;
    background: var(--doc-primary);
    color: #FFFFFF;
    border: none;
    box-shadow: var(--doc-shadow-lg);
    cursor: pointer;
    display: flex;
    align-items: center;
    justify-content: center;
    font-size: 1rem;
    opacity: 0;
    visibility: hidden;
    transition: opacity 0.25s ease, visibility 0.25s ease, transform 0.2s ease;
    z-index: 999;
}

.doc-back-top-btn.visible {
    opacity: 1;
    visibility: visible;
}

.doc-back-top-btn:hover {
    transform: translateY(-3px);
    background: var(--doc-primary-hover);
}

.doc-toast {
    position: fixed;
    bottom: 30px;
    left: 50%;
    transform: translateX(-50%) translateY(100px);
    background: var(--doc-text-main);
    color: var(--doc-bg-body);
    padding: 10px 20px;
    border-radius: 9999px;
    font-size: 0.85rem;
    font-weight: 600;
    box-shadow: var(--doc-shadow-lg);
    opacity: 0;
    transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
    z-index: 10000;
}

.doc-toast.show {
    opacity: 1;
    transform: translateX(-50%) translateY(0);
}

/* ─── 16. ACCESSIBILITY: REDUCED MOTION SUPPORT ───────────── */
@media (prefers-reduced-motion: reduce) {
    *, ::before, ::after {
        animation-duration: 0.01ms !important;
        animation-iteration-count: 1 !important;
        transition-duration: 0.01ms !important;
        scroll-behavior: auto !important;
    }
}

/* ─── 17. PRINT STYLESHEET (CLEAN DOCUMENTATION PRINTING) ─── */
@media print {
    .doc-reading-progress-container,
    .doc-skip-link,
    .doc-left-sidebar,
    .doc-right-sidebar,
    .doc-mobile-toc-container,
    .doc-back-top-btn,
    .doc-theme-toggle,
    header,
    footer,
    .notice-marquee-bar {
        display: none !important;
    }

    body, .doc-page-wrapper {
        background: #FFFFFF !important;
        color: #000000 !important;
        padding: 0 !important;
    }

    .doc-container, .doc-grid-layout, .doc-main-content {
        display: block !important;
        max-width: 100% !important;
        width: 100% !important;
        margin: 0 !important;
        padding: 0 !important;
        border: none !important;
        box-shadow: none !important;
        background: #FFFFFF !important;
    }

    .doc-hero-section {
        border: 1px solid #CCCCCC !important;
        box-shadow: none !important;
        padding: 20px !important;
    }

    a {
        text-decoration: underline !important;
        color: #000000 !important;
    }

    .heading-anchor {
        display: none !important;
    }

    .doc-main-content h2, .doc-main-content h3 {
        page-break-after: avoid;
    }
}