/**
 * Documentation Styles
 * Lead Marketing Strategies - Premium Documentation System
 *
 * A stunning, modern documentation design with beautiful light/dark modes
 */

/* ============================================
   CSS Custom Properties - Light Mode (Default)
   ============================================ */
:root {
    /* Page Backgrounds */
    --docs-bg: #f8fafc;
    --docs-bg-gradient: linear-gradient(180deg, #f0f9ff 0%, #f8fafc 100%);
    --docs-bg-secondary: #ffffff;
    --docs-bg-tertiary: #f1f5f9;

    /* Surface (Cards, Modals) */
    --docs-surface: #ffffff;
    --docs-surface-hover: #f8fafc;
    --docs-surface-elevated: #ffffff;

    /* Text Colors */
    --docs-text: #0f172a;
    --docs-text-secondary: #475569;
    --docs-text-muted: #64748b;
    --docs-text-light: #94a3b8;

    /* Borders */
    --docs-border: #e2e8f0;
    --docs-border-light: #f1f5f9;
    --docs-border-hover: #cbd5e1;

    /* Primary Brand - Teal */
    --docs-primary: #0d9488;
    --docs-primary-light: #14b8a6;
    --docs-primary-dark: #0f766e;
    --docs-primary-bg: rgba(13, 148, 136, 0.08);
    --docs-primary-glow: rgba(13, 148, 136, 0.25);

    /* Secondary - Deep Blue */
    --docs-secondary: #1e293b;
    --docs-secondary-light: #334155;

    /* Accent - Warm Orange */
    --docs-accent: #f97316;
    --docs-accent-light: #fb923c;
    --docs-accent-bg: rgba(249, 115, 22, 0.1);

    /* Status Colors */
    --docs-info: #0ea5e9;
    --docs-info-bg: linear-gradient(135deg, rgba(14, 165, 233, 0.08) 0%, rgba(56, 189, 248, 0.08) 100%);
    --docs-info-border: rgba(14, 165, 233, 0.3);
    --docs-info-glow: rgba(14, 165, 233, 0.15);

    --docs-success: #10b981;
    --docs-success-bg: linear-gradient(135deg, rgba(16, 185, 129, 0.08) 0%, rgba(52, 211, 153, 0.08) 100%);
    --docs-success-border: rgba(16, 185, 129, 0.3);
    --docs-success-glow: rgba(16, 185, 129, 0.15);

    --docs-warning: #f59e0b;
    --docs-warning-bg: linear-gradient(135deg, rgba(245, 158, 11, 0.08) 0%, rgba(251, 191, 36, 0.08) 100%);
    --docs-warning-border: rgba(245, 158, 11, 0.3);
    --docs-warning-glow: rgba(245, 158, 11, 0.15);

    --docs-danger: #ef4444;
    --docs-danger-bg: linear-gradient(135deg, rgba(239, 68, 68, 0.08) 0%, rgba(248, 113, 113, 0.08) 100%);
    --docs-danger-border: rgba(239, 68, 68, 0.3);
    --docs-danger-glow: rgba(239, 68, 68, 0.15);

    /* Code */
    --docs-code-bg: #f1f5f9;
    --docs-code-text: #0f172a;
    --docs-code-border: #e2e8f0;
    --docs-code-inline-bg: rgba(13, 148, 136, 0.1);
    --docs-code-inline-text: #0f766e;

    /* Shadows */
    --docs-shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
    --docs-shadow: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
    --docs-shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
    --docs-shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
    --docs-shadow-xl: 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);
    --docs-shadow-glow: 0 0 40px -10px var(--docs-primary-glow);

    /* Layout */
    --docs-sidebar-width: 280px;
    --docs-sidebar-bg: #ffffff;
    --docs-toc-width: 240px;

    /* Hero Gradient */
    --docs-hero-gradient: linear-gradient(135deg, #0f766e 0%, #0d9488 25%, #14b8a6 50%, #0ea5e9 100%);
    --docs-hero-pattern-opacity: 0.05;

    /* Transitions */
    --docs-transition: 200ms cubic-bezier(0.4, 0, 0.2, 1);
    --docs-transition-slow: 300ms cubic-bezier(0.4, 0, 0.2, 1);
}

/* ============================================
   Dark Mode - Stunning Night Theme
   ============================================ */
:root.dark,
html.dark,
[data-theme="dark"] {
    /* Page Backgrounds - Rich dark with subtle blue tint */
    --docs-bg: #0a0a0f;
    --docs-bg-gradient: linear-gradient(180deg, #0f1419 0%, #0a0a0f 100%);
    --docs-bg-secondary: #111118;
    --docs-bg-tertiary: #18181f;

    /* Surface - Elevated cards with subtle glow */
    --docs-surface: #16161d;
    --docs-surface-hover: #1e1e28;
    --docs-surface-elevated: #1a1a24;

    /* Text Colors - High contrast */
    --docs-text: #f1f5f9;
    --docs-text-secondary: #cbd5e1;
    --docs-text-muted: #94a3b8;
    --docs-text-light: #64748b;

    /* Borders - Subtle with glow potential */
    --docs-border: #2a2a3a;
    --docs-border-light: #1f1f2e;
    --docs-border-hover: #3a3a4f;

    /* Primary Brand - Vibrant teal for dark */
    --docs-primary: #2dd4bf;
    --docs-primary-light: #5eead4;
    --docs-primary-dark: #14b8a6;
    --docs-primary-bg: rgba(45, 212, 191, 0.1);
    --docs-primary-glow: rgba(45, 212, 191, 0.4);

    /* Accent - Glowing orange */
    --docs-accent: #fb923c;
    --docs-accent-light: #fdba74;
    --docs-accent-bg: rgba(251, 146, 60, 0.15);

    /* Status Colors - Vibrant for dark mode */
    --docs-info: #38bdf8;
    --docs-info-bg: linear-gradient(135deg, rgba(56, 189, 248, 0.12) 0%, rgba(14, 165, 233, 0.08) 100%);
    --docs-info-border: rgba(56, 189, 248, 0.35);
    --docs-info-glow: rgba(56, 189, 248, 0.25);

    --docs-success: #34d399;
    --docs-success-bg: linear-gradient(135deg, rgba(52, 211, 153, 0.12) 0%, rgba(16, 185, 129, 0.08) 100%);
    --docs-success-border: rgba(52, 211, 153, 0.35);
    --docs-success-glow: rgba(52, 211, 153, 0.25);

    --docs-warning: #fbbf24;
    --docs-warning-bg: linear-gradient(135deg, rgba(251, 191, 36, 0.12) 0%, rgba(245, 158, 11, 0.08) 100%);
    --docs-warning-border: rgba(251, 191, 36, 0.35);
    --docs-warning-glow: rgba(251, 191, 36, 0.25);

    --docs-danger: #f87171;
    --docs-danger-bg: linear-gradient(135deg, rgba(248, 113, 113, 0.12) 0%, rgba(239, 68, 68, 0.08) 100%);
    --docs-danger-border: rgba(248, 113, 113, 0.35);
    --docs-danger-glow: rgba(248, 113, 113, 0.25);

    /* Code - Dark mode syntax highlighting ready */
    --docs-code-bg: #1a1a24;
    --docs-code-text: #e2e8f0;
    --docs-code-border: #2a2a3a;
    --docs-code-inline-bg: rgba(45, 212, 191, 0.15);
    --docs-code-inline-text: #5eead4;

    /* Shadows - Subtle glows */
    --docs-shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.4);
    --docs-shadow: 0 1px 3px 0 rgb(0 0 0 / 0.5), 0 1px 2px -1px rgb(0 0 0 / 0.5);
    --docs-shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.5), 0 2px 4px -2px rgb(0 0 0 / 0.5);
    --docs-shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.5), 0 4px 6px -4px rgb(0 0 0 / 0.5);
    --docs-shadow-xl: 0 20px 25px -5px rgb(0 0 0 / 0.6), 0 8px 10px -6px rgb(0 0 0 / 0.5);
    --docs-shadow-glow: 0 0 60px -15px var(--docs-primary-glow);

    /* Sidebar */
    --docs-sidebar-bg: #111118;

    /* Hero Gradient - Vibrant for dark */
    --docs-hero-gradient: linear-gradient(135deg, #0f172a 0%, #1e1b4b 25%, #312e81 50%, #1e40af 75%, #0f766e 100%);
    --docs-hero-pattern-opacity: 0.08;
}

/*
 * Note: System preference dark mode is handled by the Alpine.js theme store
 * which adds/removes the .dark class on <html>. No CSS media query needed.
 */

/* ============================================
   Explicit Light Mode (when dark class is NOT present)
   ============================================ */
html:not(.dark) .docs-page {
    --docs-bg: #f8fafc;
    --docs-bg-gradient: linear-gradient(180deg, #f0f9ff 0%, #f8fafc 100%);
    --docs-surface: #ffffff;
    --docs-text: #0f172a;
    --docs-text-secondary: #475569;
    --docs-text-muted: #64748b;
    --docs-border: #e2e8f0;
    --docs-border-light: #f1f5f9;
    --docs-primary: #0d9488;
    --docs-hero-gradient: linear-gradient(135deg, #0f766e 0%, #0d9488 25%, #14b8a6 50%, #0ea5e9 100%);
}

/* ============================================
   Base Layout
   ============================================ */
.docs-page {
    background: var(--docs-bg-gradient);
    background-color: var(--docs-bg);
    color: var(--docs-text);
    min-height: 100vh;
    transition: background-color var(--docs-transition), color var(--docs-transition);
}

.docs-container {
    max-width: 1440px;
    margin: 0 auto;
    padding: 0 1.5rem;
}

.docs-layout {
    display: grid;
    grid-template-columns: var(--docs-sidebar-width) 1fr;
    gap: 2.5rem;
    padding-top: 2rem;
    padding-bottom: 4rem;
}

@media (min-width: 1280px) {
    .docs-layout {
        grid-template-columns: var(--docs-sidebar-width) 1fr var(--docs-toc-width);
    }
}

@media (max-width: 1024px) {
    .docs-layout {
        grid-template-columns: 1fr;
    }
}

/* ============================================
   Hero Section - Eye-catching gradient
   ============================================ */
.docs-hero {
    background: var(--docs-hero-gradient);
    padding: 3rem 0 2.5rem;
    position: relative;
    overflow: hidden;
}

.docs-hero::before {
    content: '';
    position: absolute;
    top: 0;
    left: 0;
    right: 0;
    bottom: 0;
    background: url("data:image/svg+xml,%3Csvg width='60' height='60' viewBox='0 0 60 60' xmlns='http://www.w3.org/2000/svg'%3E%3Cg fill='none' fill-rule='evenodd'%3E%3Cg fill='%23ffffff' fill-opacity='0.06'%3E%3Cpath d='M36 34v-4h-2v4h-4v2h4v4h2v-4h4v-2h-4zm0-30V0h-2v4h-4v2h4v4h2V6h4V4h-4zM6 34v-4H4v4H0v2h4v4h2v-4h4v-2H6zM6 4V0H4v4H0v2h4v4h2V6h4V4H6z'/%3E%3C/g%3E%3C/g%3E%3C/svg%3E");
    opacity: var(--docs-hero-pattern-opacity);
}

/* Animated gradient orbs */
.docs-hero::after {
    content: '';
    position: absolute;
    top: -50%;
    right: -20%;
    width: 60%;
    height: 200%;
    background: radial-gradient(ellipse, rgba(255,255,255,0.1) 0%, transparent 70%);
    animation: float 15s ease-in-out infinite;
}

@keyframes float {
    0%, 100% { transform: translateY(0) rotate(0deg); }
    50% { transform: translateY(-5%) rotate(3deg); }
}

.docs-hero-content {
    position: relative;
    z-index: 1;
    text-align: center;
}

.docs-hero h1 {
    color: #ffffff;
    font-size: 3rem;
    font-weight: 800;
    margin-bottom: 1rem;
    line-height: 1.1;
    text-shadow: 0 2px 20px rgba(0,0,0,0.2);
}

.docs-hero p {
    color: rgba(255, 255, 255, 0.9);
    font-size: 1.25rem;
    max-width: 600px;
    margin: 0 auto 2.5rem;
    line-height: 1.6;
}

/* ============================================
   Search Box - Modern glass effect
   ============================================ */
.docs-search {
    max-width: 580px;
    margin: 0 auto;
    position: relative;
}

.docs-search-input {
    width: 100%;
    padding: 1.125rem 1.25rem 1.125rem 3.25rem;
    background: rgba(255, 255, 255, 0.95);
    backdrop-filter: blur(20px);
    -webkit-backdrop-filter: blur(20px);
    border: 2px solid rgba(255, 255, 255, 0.3);
    border-radius: 1rem;
    font-size: 1rem;
    color: var(--docs-text);
    transition: all var(--docs-transition);
    box-shadow: 0 20px 40px -10px rgba(0,0,0,0.2);
}

.dark .docs-search-input,
[data-theme="dark"] .docs-search-input {
    background: rgba(22, 22, 29, 0.9);
    border-color: rgba(255, 255, 255, 0.1);
    color: var(--docs-text);
}

.docs-search-input::placeholder {
    color: var(--docs-text-muted);
}

.docs-search-input:focus {
    outline: none;
    border-color: var(--docs-primary);
    box-shadow: 0 20px 40px -10px rgba(0,0,0,0.2), 0 0 0 4px var(--docs-primary-bg);
}

.docs-search-icon {
    position: absolute;
    left: 1.125rem;
    top: 50%;
    transform: translateY(-50%);
    width: 1.25rem;
    height: 1.25rem;
    color: var(--docs-text-muted);
}

.docs-search-shortcut {
    position: absolute;
    right: 1rem;
    top: 50%;
    transform: translateY(-50%);
    padding: 0.375rem 0.625rem;
    background: var(--docs-bg-tertiary);
    border: 1px solid var(--docs-border);
    border-radius: 0.5rem;
    font-size: 0.75rem;
    font-weight: 600;
    color: var(--docs-text-muted);
    font-family: inherit;
}

/* ============================================
   Breadcrumbs
   ============================================ */
.docs-breadcrumbs {
    display: flex;
    align-items: center;
    flex-wrap: wrap;
    gap: 0.5rem;
    padding: 1.25rem 0;
    font-size: 0.875rem;
    color: var(--docs-text-secondary);
}

.docs-breadcrumbs a {
    color: var(--docs-text-muted);
    text-decoration: none;
    transition: color var(--docs-transition);
}

.docs-breadcrumbs a:hover {
    color: var(--docs-primary);
}

.docs-breadcrumbs-separator {
    color: var(--docs-text-light);
}

.docs-breadcrumbs-current {
    color: var(--docs-text);
    font-weight: 600;
}

/* ============================================
   Sidebar Navigation
   ============================================ */
.docs-sidebar {
    position: sticky;
    top: 6rem;
    max-height: calc(100vh - 7rem);
    overflow-y: auto;
    padding-right: 1rem;
    scrollbar-width: thin;
    scrollbar-color: var(--docs-border) transparent;
}

.docs-sidebar::-webkit-scrollbar {
    width: 5px;
}

.docs-sidebar::-webkit-scrollbar-track {
    background: transparent;
}

.docs-sidebar::-webkit-scrollbar-thumb {
    background: var(--docs-border);
    border-radius: 3px;
}

.docs-sidebar::-webkit-scrollbar-thumb:hover {
    background: var(--docs-border-hover);
}

@media (max-width: 1024px) {
    .docs-sidebar {
        display: none;
    }

    .docs-sidebar.is-open {
        display: block;
        position: fixed;
        top: 0;
        left: 0;
        right: 0;
        bottom: 0;
        z-index: 50;
        background: var(--docs-sidebar-bg);
        max-height: 100vh;
        padding: 1.5rem;
        overflow-y: auto;
    }
}

.docs-sidebar-section {
    margin-bottom: 2rem;
}

.docs-sidebar-title {
    font-size: 0.6875rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.1em;
    color: var(--docs-primary);
    padding: 0.5rem 0;
    margin-bottom: 0.5rem;
}

.docs-sidebar-list {
    list-style: none;
    padding: 0;
    margin: 0;
}

.docs-sidebar-link {
    display: flex;
    align-items: center;
    padding: 0.625rem 0.875rem;
    margin: 0.125rem 0;
    color: var(--docs-text-secondary);
    text-decoration: none;
    font-size: 0.875rem;
    border-radius: 0.625rem;
    transition: all var(--docs-transition);
    border-left: 3px solid transparent;
}

.docs-sidebar-link:hover {
    color: var(--docs-text);
    background: var(--docs-surface-hover);
    border-left-color: var(--docs-border);
}

.docs-sidebar-link.is-active {
    color: var(--docs-primary);
    background: var(--docs-primary-bg);
    font-weight: 600;
    border-left-color: var(--docs-primary);
}

/* Sidebar Filter Controls */
.docs-sidebar-filter {
    margin-bottom: 1.25rem;
}

.docs-sidebar-label {
    display: block;
    font-size: 0.6875rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.1em;
    color: var(--docs-primary);
    margin-bottom: 0.5rem;
}

.docs-sidebar-select-wrapper {
    position: relative;
}

.docs-sidebar-select {
    width: 100%;
    padding: 0.75rem 2.5rem 0.75rem 1rem;
    font-size: 0.875rem;
    font-weight: 500;
    color: var(--docs-text);
    background-color: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: 0.75rem;
    appearance: none;
    cursor: pointer;
    transition: all var(--docs-transition);
}

.docs-sidebar-select:hover {
    border-color: var(--docs-border-hover);
}

.docs-sidebar-select:focus {
    outline: none;
    border-color: var(--docs-primary);
    box-shadow: 0 0 0 3px var(--docs-primary-bg);
}

.docs-sidebar-select-icon {
    position: absolute;
    right: 0.875rem;
    top: 50%;
    transform: translateY(-50%);
    width: 1rem;
    height: 1rem;
    color: var(--docs-text-muted);
    pointer-events: none;
}

.docs-sidebar-search {
    position: relative;
    display: flex;
    align-items: center;
}

.docs-sidebar-search-icon {
    position: absolute;
    left: 0.875rem;
    width: 1rem;
    height: 1rem;
    color: var(--docs-text-muted);
    pointer-events: none;
}

.docs-sidebar-search-input {
    width: 100%;
    padding: 0.75rem 1rem 0.75rem 2.5rem;
    font-size: 0.875rem;
    color: var(--docs-text);
    background-color: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: 0.75rem;
    transition: all var(--docs-transition);
}

.docs-sidebar-search-input::placeholder {
    color: var(--docs-text-muted);
}

.docs-sidebar-search-input:hover {
    border-color: var(--docs-border-hover);
}

.docs-sidebar-search-input:focus {
    outline: none;
    border-color: var(--docs-primary);
    box-shadow: 0 0 0 3px var(--docs-primary-bg);
}

/* Mobile sidebar toggle */
.docs-sidebar-toggle {
    display: none;
    position: fixed;
    bottom: 1.5rem;
    right: 1.5rem;
    z-index: 40;
    width: 3.5rem;
    height: 3.5rem;
    background: var(--docs-primary);
    color: #ffffff;
    border: none;
    border-radius: 50%;
    box-shadow: var(--docs-shadow-lg), var(--docs-shadow-glow);
    cursor: pointer;
    transition: all var(--docs-transition);
}

.docs-sidebar-toggle:hover {
    background: var(--docs-primary-dark);
    transform: scale(1.05);
}

@media (max-width: 1024px) {
    .docs-sidebar-toggle {
        display: flex;
        align-items: center;
        justify-content: center;
    }
}

/* ============================================
   Main Content - Article Card
   ============================================ */
.docs-content {
    min-width: 0;
}

.docs-article {
    background: var(--docs-surface);
    border-radius: 1.25rem;
    padding: 2.5rem;
    box-shadow: var(--docs-shadow-lg);
    border: 1px solid var(--docs-border-light);
    transition: box-shadow var(--docs-transition);
}

.docs-article:hover {
    box-shadow: var(--docs-shadow-xl);
}

@media (max-width: 640px) {
    .docs-article {
        padding: 1.5rem;
        border-radius: 1rem;
    }
}

.docs-article-header {
    margin-bottom: 2rem;
    padding-bottom: 1.5rem;
    border-bottom: 1px solid var(--docs-border-light);
}

.docs-article-title {
    font-size: 2.25rem;
    font-weight: 800;
    color: var(--docs-text);
    line-height: 1.2;
    margin-bottom: 1rem;
    background: linear-gradient(135deg, var(--docs-text) 0%, var(--docs-text-secondary) 100%);
    -webkit-background-clip: text;
    -webkit-text-fill-color: transparent;
    background-clip: text;
}

.docs-article-meta {
    display: flex;
    flex-wrap: wrap;
    gap: 1.25rem;
    font-size: 0.875rem;
    color: var(--docs-text-muted);
}

.docs-article-meta-item {
    display: flex;
    align-items: center;
    gap: 0.5rem;
    padding: 0.375rem 0.75rem;
    background: var(--docs-bg-tertiary);
    border-radius: 2rem;
}

/* ============================================
   Article Content Typography
   ============================================ */
.docs-article-body {
    line-height: 1.8;
    color: var(--docs-text-secondary);
}

.docs-article-body h2 {
    font-size: 1.5rem;
    font-weight: 700;
    color: var(--docs-text);
    margin-top: 3rem;
    margin-bottom: 1rem;
    padding-top: 1.5rem;
    border-top: 1px solid var(--docs-border-light);
    scroll-margin-top: 6rem;
}

.docs-article-body h2:first-child {
    margin-top: 0;
    padding-top: 0;
    border-top: none;
}

.docs-article-body h3 {
    font-size: 1.25rem;
    font-weight: 600;
    color: var(--docs-text);
    margin-top: 2rem;
    margin-bottom: 0.75rem;
    scroll-margin-top: 6rem;
}

.docs-article-body h4 {
    font-size: 1.125rem;
    font-weight: 600;
    color: var(--docs-text);
    margin-top: 1.5rem;
    margin-bottom: 0.5rem;
    scroll-margin-top: 6rem;
}

.docs-article-body p {
    margin-bottom: 1.5rem;
}

.docs-article-body a {
    color: var(--docs-primary);
    text-decoration: none;
    font-weight: 500;
    transition: all var(--docs-transition);
    border-bottom: 1px solid transparent;
}

.docs-article-body a:hover {
    color: var(--docs-primary-light);
    border-bottom-color: var(--docs-primary-light);
}

.docs-article-body strong {
    color: var(--docs-text);
    font-weight: 600;
}

.docs-article-body ul,
.docs-article-body ol {
    margin-bottom: 1.5rem;
    padding-left: 1.5rem;
}

.docs-article-body li {
    margin-bottom: 0.625rem;
}

.docs-article-body li::marker {
    color: var(--docs-primary);
}

.docs-article-body img {
    max-width: 100%;
    height: auto;
    border-radius: 1rem;
    margin: 2rem 0;
    box-shadow: var(--docs-shadow-lg);
    border: 1px solid var(--docs-border);
}

.docs-article-body figure {
    margin: 2.5rem 0;
}

.docs-article-body figcaption {
    text-align: center;
    font-size: 0.875rem;
    color: var(--docs-text-muted);
    margin-top: 1rem;
    font-style: italic;
}

/* ============================================
   Code Blocks
   ============================================ */
.docs-article-body code {
    font-family: 'JetBrains Mono', 'Fira Code', 'SF Mono', Consolas, monospace;
    font-size: 0.875em;
}

.docs-article-body :not(pre) > code {
    background: var(--docs-code-inline-bg);
    color: var(--docs-code-inline-text);
    padding: 0.25em 0.5em;
    border-radius: 0.375rem;
    font-weight: 500;
}

.docs-article-body pre {
    background: var(--docs-code-bg);
    border: 1px solid var(--docs-code-border);
    border-radius: 1rem;
    padding: 1.5rem;
    overflow-x: auto;
    margin: 2rem 0;
    position: relative;
}

.docs-article-body pre code {
    background: transparent;
    color: var(--docs-code-text);
    padding: 0;
    font-size: 0.875rem;
    line-height: 1.7;
}

/* ============================================
   Callout Boxes - Stunning gradients
   ============================================ */
.docs-callout {
    border-radius: 1rem;
    padding: 1.5rem;
    margin: 2rem 0;
    border-left: 4px solid;
    position: relative;
    overflow: hidden;
}

.docs-callout::before {
    content: '';
    position: absolute;
    top: 0;
    left: 0;
    right: 0;
    bottom: 0;
    opacity: 0.5;
    z-index: 0;
}

.docs-callout > * {
    position: relative;
    z-index: 1;
}

.docs-callout-title {
    display: flex;
    align-items: center;
    gap: 0.625rem;
    font-weight: 700;
    margin-bottom: 0.625rem;
    font-size: 0.9375rem;
}

.docs-callout-icon {
    width: 1.25rem;
    height: 1.25rem;
    flex-shrink: 0;
}

.docs-callout p {
    margin-bottom: 0;
    color: var(--docs-text-secondary);
}

.docs-callout p:last-child {
    margin-bottom: 0;
}

/* Info Callout */
.docs-callout-info {
    background: var(--docs-info-bg);
    border-color: var(--docs-info);
    box-shadow: 0 4px 20px -4px var(--docs-info-glow);
}

.docs-callout-info .docs-callout-title {
    color: var(--docs-info);
}

/* Success/Tip Callout */
.docs-callout-tip,
.docs-callout-success {
    background: var(--docs-success-bg);
    border-color: var(--docs-success);
    box-shadow: 0 4px 20px -4px var(--docs-success-glow);
}

.docs-callout-tip .docs-callout-title,
.docs-callout-success .docs-callout-title {
    color: var(--docs-success);
}

/* Warning Callout */
.docs-callout-warning {
    background: var(--docs-warning-bg);
    border-color: var(--docs-warning);
    box-shadow: 0 4px 20px -4px var(--docs-warning-glow);
}

.docs-callout-warning .docs-callout-title {
    color: var(--docs-warning);
}

/* Danger Callout */
.docs-callout-danger {
    background: var(--docs-danger-bg);
    border-color: var(--docs-danger);
    box-shadow: 0 4px 20px -4px var(--docs-danger-glow);
}

.docs-callout-danger .docs-callout-title {
    color: var(--docs-danger);
}

/* ============================================
   Step-by-Step Guides
   ============================================ */
.docs-steps {
    counter-reset: step-counter;
    margin: 2rem 0;
}

.docs-step {
    display: flex;
    gap: 1.25rem;
    margin-bottom: 1.5rem;
    padding-bottom: 1.5rem;
    border-bottom: 1px dashed var(--docs-border-light);
}

.docs-step:last-child {
    border-bottom: none;
    padding-bottom: 0;
    margin-bottom: 0;
}

.docs-step-number {
    counter-increment: step-counter;
    flex-shrink: 0;
    width: 2.75rem;
    height: 2.75rem;
    display: flex;
    align-items: center;
    justify-content: center;
    background: linear-gradient(135deg, var(--docs-primary) 0%, var(--docs-primary-dark) 100%);
    color: #ffffff;
    font-weight: 700;
    font-size: 1rem;
    border-radius: 50%;
    box-shadow: 0 4px 12px -2px var(--docs-primary-glow);
}

.docs-step-number::before {
    content: counter(step-counter);
}

.docs-step-content {
    flex: 1;
    min-width: 0;
    padding-top: 0.25rem;
}

.docs-step-title {
    font-weight: 700;
    color: var(--docs-text);
    margin-bottom: 0.5rem;
    font-size: 1.0625rem;
}

.docs-step-content p {
    color: var(--docs-text-secondary);
    margin-bottom: 0.75rem;
}

.docs-step-content p:last-child {
    margin-bottom: 0;
}

/* ============================================
   Table of Contents (Right Sidebar)
   ============================================ */
.docs-toc {
    position: sticky;
    top: 6rem;
    max-height: calc(100vh - 7rem);
    overflow-y: auto;
    padding-left: 1.5rem;
    border-left: 1px solid var(--docs-border-light);
}

@media (max-width: 1279px) {
    .docs-toc {
        display: none;
    }
}

.docs-toc-title {
    font-size: 0.6875rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.1em;
    color: var(--docs-primary);
    margin-bottom: 1rem;
}

.docs-toc-list {
    list-style: none;
    padding: 0;
    margin: 0;
}

.docs-toc-link {
    display: block;
    padding: 0.5rem 0;
    color: var(--docs-text-muted);
    text-decoration: none;
    font-size: 0.8125rem;
    line-height: 1.4;
    transition: all var(--docs-transition);
    border-left: 2px solid transparent;
    padding-left: 0.75rem;
    margin-left: -1px;
}

.docs-toc-link:hover {
    color: var(--docs-primary);
    border-left-color: var(--docs-border);
}

.docs-toc-link.is-active {
    color: var(--docs-primary);
    font-weight: 600;
    border-left-color: var(--docs-primary);
}

.docs-toc-link[data-level="3"] {
    padding-left: 1.5rem;
    font-size: 0.75rem;
}

/* ============================================
   Product Cards (Archive Page)
   ============================================ */
.docs-products {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
    gap: 1.5rem;
    margin-top: 2rem;
}

.docs-product-card {
    background: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: 1.25rem;
    padding: 2rem;
    text-decoration: none;
    transition: all var(--docs-transition);
    position: relative;
    overflow: hidden;
}

.docs-product-card::before {
    content: '';
    position: absolute;
    top: 0;
    left: 0;
    right: 0;
    height: 4px;
    background: linear-gradient(90deg, var(--docs-primary), var(--docs-primary-light));
    opacity: 0;
    transition: opacity var(--docs-transition);
}

.docs-product-card:hover {
    border-color: var(--docs-primary);
    box-shadow: var(--docs-shadow-lg), var(--docs-shadow-glow);
    transform: translateY(-4px);
}

.docs-product-card:hover::before {
    opacity: 1;
}

.docs-product-card-icon {
    width: 3.5rem;
    height: 3.5rem;
    background: var(--docs-primary-bg);
    border-radius: 1rem;
    display: flex;
    align-items: center;
    justify-content: center;
    margin-bottom: 1.25rem;
    color: var(--docs-primary);
    transition: all var(--docs-transition);
}

.docs-product-card:hover .docs-product-card-icon {
    background: var(--docs-primary);
    color: #ffffff;
    transform: scale(1.1);
}

.docs-product-card-title {
    font-size: 1.25rem;
    font-weight: 700;
    color: var(--docs-text);
    margin-bottom: 0.5rem;
}

.docs-product-card-description {
    color: var(--docs-text-secondary);
    font-size: 0.9375rem;
    line-height: 1.6;
    margin-bottom: 1.25rem;
}

.docs-product-card-link {
    display: inline-flex;
    align-items: center;
    gap: 0.5rem;
    color: var(--docs-primary);
    font-weight: 600;
    font-size: 0.875rem;
}

.docs-product-card-link svg {
    width: 1rem;
    height: 1rem;
    transition: transform var(--docs-transition);
}

.docs-product-card:hover .docs-product-card-link svg {
    transform: translateX(4px);
}

/* ============================================
   Category Cards
   ============================================ */
.docs-categories {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
    gap: 1rem;
    margin-top: 2rem;
}

.docs-category-card {
    background: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: 1rem;
    padding: 1.5rem;
    text-decoration: none;
    transition: all var(--docs-transition);
}

.docs-category-card:hover {
    border-color: var(--docs-primary);
    background: var(--docs-surface-hover);
    box-shadow: var(--docs-shadow-md);
    transform: translateY(-2px);
}

.docs-category-card-title {
    font-weight: 600;
    color: var(--docs-text);
    margin-bottom: 0.375rem;
}

.docs-category-card-count {
    font-size: 0.875rem;
    color: var(--docs-text-muted);
}

/* ============================================
   Related Articles
   ============================================ */
.docs-related {
    margin-top: 3rem;
    padding-top: 2rem;
    border-top: 1px solid var(--docs-border-light);
}

.docs-related-title {
    font-size: 1.125rem;
    font-weight: 700;
    color: var(--docs-text);
    margin-bottom: 1.25rem;
}

.docs-related-list {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
    gap: 1rem;
}

.docs-related-card {
    display: block;
    padding: 1.25rem;
    background: var(--docs-bg-secondary);
    border: 1px solid var(--docs-border-light);
    border-radius: 1rem;
    text-decoration: none;
    transition: all var(--docs-transition);
}

.docs-related-card:hover {
    border-color: var(--docs-primary);
    box-shadow: var(--docs-shadow-md);
    transform: translateY(-2px);
}

.docs-related-card-title {
    font-weight: 600;
    color: var(--docs-text);
    margin-bottom: 0.375rem;
}

.docs-related-card-excerpt {
    font-size: 0.875rem;
    color: var(--docs-text-muted);
    line-height: 1.5;
}

/* ============================================
   Theme Toggle Button
   ============================================ */
.docs-theme-toggle {
    display: flex;
    align-items: center;
    gap: 0.625rem;
    padding: 0.625rem 1rem;
    background: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: 2rem;
    cursor: pointer;
    transition: all var(--docs-transition);
    font-size: 0.875rem;
    color: var(--docs-text-secondary);
    font-weight: 500;
}

.docs-theme-toggle:hover {
    border-color: var(--docs-primary);
    color: var(--docs-primary);
    box-shadow: var(--docs-shadow-sm);
}

.docs-theme-toggle-icon {
    width: 1.25rem;
    height: 1.25rem;
}

.docs-theme-toggle-sun {
    display: none;
}

.docs-theme-toggle-moon {
    display: block;
}

.dark .docs-theme-toggle-sun,
[data-theme="dark"] .docs-theme-toggle-sun {
    display: block;
}

.dark .docs-theme-toggle-moon,
[data-theme="dark"] .docs-theme-toggle-moon {
    display: none;
}

/* ============================================
   Screenshots/Images
   ============================================ */
.docs-screenshot {
    margin: 2.5rem 0;
    text-align: center;
}

.docs-screenshot img {
    max-width: 100%;
    height: auto;
    border-radius: 1rem;
    box-shadow: var(--docs-shadow-xl);
    border: 1px solid var(--docs-border);
    cursor: zoom-in;
    transition: all var(--docs-transition);
}

.docs-screenshot img:hover {
    box-shadow: var(--docs-shadow-xl), var(--docs-shadow-glow);
    transform: scale(1.01);
}

.docs-screenshot-caption {
    margin-top: 1rem;
    font-size: 0.875rem;
    color: var(--docs-text-muted);
    font-style: italic;
}

/* Mobile screenshot sizing */
.docs-image-mobile img {
    max-width: 320px;
    margin: 2rem auto;
    display: block;
    border-radius: 1.5rem;
}

/* Screenshot placeholder */
.docs-screenshot-placeholder {
    background: var(--docs-bg-tertiary);
    border: 2px dashed var(--docs-border);
    border-radius: 1rem;
    padding: 4rem;
    text-align: center;
    color: var(--docs-text-muted);
}

/* Lightbox */
.docs-lightbox {
    position: fixed;
    top: 0;
    left: 0;
    right: 0;
    bottom: 0;
    z-index: 100;
    background: rgba(0, 0, 0, 0.95);
    backdrop-filter: blur(10px);
    display: flex;
    align-items: center;
    justify-content: center;
    padding: 2rem;
    opacity: 0;
    visibility: hidden;
    transition: all var(--docs-transition);
}

.docs-lightbox.is-active {
    opacity: 1;
    visibility: visible;
}

.docs-lightbox img {
    max-width: 100%;
    max-height: 90vh;
    object-fit: contain;
    border-radius: 0.75rem;
    box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.5);
}

.docs-lightbox-close {
    position: absolute;
    top: 1.5rem;
    right: 1.5rem;
    width: 3rem;
    height: 3rem;
    background: rgba(255, 255, 255, 0.1);
    border: none;
    border-radius: 50%;
    color: #ffffff;
    cursor: pointer;
    transition: all var(--docs-transition);
    display: flex;
    align-items: center;
    justify-content: center;
}

.docs-lightbox-close:hover {
    background: rgba(255, 255, 255, 0.2);
    transform: scale(1.1);
}

/* ============================================
   Tables
   ============================================ */
.docs-article-body table {
    width: 100%;
    border-collapse: collapse;
    margin: 2rem 0;
    font-size: 0.9375rem;
    border-radius: 1rem;
    overflow: hidden;
    border: 1px solid var(--docs-border);
}

.docs-article-body th,
.docs-article-body td {
    padding: 1rem 1.25rem;
    text-align: left;
    border-bottom: 1px solid var(--docs-border);
}

.docs-article-body th {
    background: var(--docs-bg-tertiary);
    font-weight: 600;
    color: var(--docs-text);
    text-transform: uppercase;
    font-size: 0.75rem;
    letter-spacing: 0.05em;
}

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

.docs-article-body tr:hover td {
    background: var(--docs-surface-hover);
}

/* ============================================
   Download Links
   ============================================ */
.docs-download-links {
    display: flex;
    flex-wrap: wrap;
    gap: 1rem;
    margin: 2rem 0;
}

.docs-download-link {
    display: inline-flex;
    align-items: center;
    gap: 0.875rem;
    padding: 1rem 1.5rem;
    background: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: 1rem;
    text-decoration: none;
    transition: all var(--docs-transition);
}

.docs-download-link:hover {
    border-color: var(--docs-primary);
    box-shadow: var(--docs-shadow-md);
    transform: translateY(-2px);
}

.docs-download-link-icon {
    width: 2.5rem;
    height: 2.5rem;
    color: var(--docs-primary);
}

.docs-download-link-text {
    font-weight: 600;
    color: var(--docs-text);
}

.docs-download-link-subtitle {
    font-size: 0.75rem;
    color: var(--docs-text-muted);
}

/* ============================================
   Print Styles
   ============================================ */
@media print {
    .docs-sidebar,
    .docs-toc,
    .docs-sidebar-toggle,
    .docs-theme-toggle,
    .docs-search,
    .docs-lightbox {
        display: none !important;
    }

    .docs-page {
        background: #ffffff !important;
        color: #000000 !important;
    }

    .docs-layout {
        grid-template-columns: 1fr !important;
    }

    .docs-article {
        box-shadow: none !important;
        border: none !important;
        padding: 0 !important;
    }
}

/* ============================================
   Animations
   ============================================ */
@keyframes docs-fade-in {
    from {
        opacity: 0;
        transform: translateY(16px);
    }
    to {
        opacity: 1;
        transform: translateY(0);
    }
}

.docs-animate-in {
    animation: docs-fade-in 0.4s ease-out;
}

/* Smooth scroll */
html {
    scroll-behavior: smooth;
}

/* ============================================
   Responsive Adjustments
   ============================================ */
@media (max-width: 640px) {
    .docs-hero {
        padding: 2rem 0 1.5rem;
    }

    .docs-hero h1 {
        font-size: 2rem;
    }

    .docs-hero p {
        font-size: 1rem;
    }

    .docs-article-title {
        font-size: 1.75rem;
    }

    .docs-article-body h2 {
        font-size: 1.25rem;
    }

    .docs-article-body h3 {
        font-size: 1.125rem;
    }

    .docs-products {
        grid-template-columns: 1fr;
    }

    .docs-step {
        flex-direction: column;
        gap: 1rem;
    }

    .docs-step-number {
        width: 2.5rem;
        height: 2.5rem;
    }
}