/* ===================================
   DOCUMENTATION OVERVIEW PAGE STYLES
   File: public/documentation/templates/css/styles.css
   Description: Custom styles for the Documentation Overview page using common CSS architecture
   =================================== */

/* ===================================
   DOCUMENTATION HERO SECTION
   =================================== */

.docs-hero {
    background: var(--gradient-primary);
    padding: var(--spacing-16) 0 var(--spacing-12);
    text-align: center;
    position: relative;
    overflow: hidden;
}

.docs-hero::before {
    content: '';
    position: absolute;
    top: 0;
    left: 0;
    right: 0;
    bottom: 0;
    background: radial-gradient(circle at 60% 50%, rgba(255, 255, 255, 0.1), transparent 60%);
    pointer-events: none;
}

.docs-hero__content {
    position: relative;
    z-index: 1;
    max-width: 800px;
    margin: 0 auto;
}

.docs-hero__title {
    font-size: clamp(2.5rem, 5vw, var(--font-size-5xl));
    font-family: var(--font-family-heading);
    font-weight: var(--font-weight-bold);
    color: var(--color-text-inverse);
    margin-bottom: var(--spacing-4);
    line-height: var(--line-height-tight);
}

.docs-hero__subtitle {
    font-size: clamp(1rem, 2vw, var(--font-size-xl));
    color: var(--color-primary-50);
    line-height: var(--line-height-relaxed);
    margin: 0;
}

/* ===================================
   DOCUMENTATION GRID SECTION
   =================================== */

.docs-grid {
    background: var(--color-background);
    padding: var(--section-padding);
    position: relative;
    box-shadow: var(--shadow-header);
}

/* Subtle decorative background */
.docs-grid::before {
    content: '';
    position: absolute;
    top: -10%;
    right: -10%;
    width: 500px;
    height: 500px;
    background: radial-gradient(circle, rgba(59, 130, 246, 0.04) 0%, transparent 70%);
    border-radius: var(--border-radius-full);
    z-index: 0;
    pointer-events: none;
    animation: pulse 8s ease-in-out infinite;
}

.docs-grid::after {
    content: '';
    position: absolute;
    bottom: -10%;
    left: -10%;
    width: 400px;
    height: 400px;
    background: radial-gradient(circle, rgba(59, 130, 246, 0.03) 0%, transparent 70%);
    border-radius: var(--border-radius-full);
    z-index: 0;
    pointer-events: none;
    animation: pulse 10s ease-in-out infinite reverse;
}

.docs-grid__wrapper {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
    gap: var(--spacing-8);
    position: relative;
    z-index: 1;
}

/* ===================================
   DOCUMENTATION CARDS
   =================================== */

.docs-card {
    background: var(--color-surface);
    border-radius: var(--radius-card);
    border: var(--border-width-1) solid rgba(59, 130, 246, 0.1);
    padding: var(--card-padding);
    box-shadow: var(--shadow-card);
    transition: var(--transition-base);
    display: flex;
    flex-direction: column;
    gap: var(--spacing-4);
    position: relative;
    overflow: hidden;
}

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

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

/* Icon Wrapper */
.docs-card__icon-wrapper {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 64px;
    height: 64px;
    border-radius: var(--border-radius-full);
    background: var(--color-primary-50);
    flex-shrink: 0;
    transition: var(--transition-base);
    position: relative;
}

.docs-card:hover .docs-card__icon-wrapper {
    background: var(--color-primary-100);
    box-shadow: var(--shadow-md);
}

.docs-card__icon {
    font-size: var(--font-size-3xl);
    transition: var(--transition-transform);
}

.docs-card:hover .docs-card__icon {
    transform: scale(1.15) rotate(5deg);
}

/* Icon Color Variants */
.docs-card__icon--primary {
    color: var(--color-primary-500);
}

.docs-card__icon--warning {
    color: var(--color-warning-500);
}

.docs-card__icon--success {
    color: var(--color-success-500);
}

.docs-card__icon--info {
    color: var(--color-primary-400);
}

.docs-card__icon--danger {
    color: var(--color-error-500);
}

.docs-card__icon--secondary {
    color: var(--color-slate-600);
}

/* Card Content */
.docs-card__content {
    flex: 1;
    display: flex;
    flex-direction: column;
    gap: var(--spacing-3);
}

.docs-card__title {
    font-size: clamp(1.2rem, 2.5vw, var(--font-size-2xl));
    font-family: var(--font-family-heading);
    font-weight: var(--font-weight-bold);
    color: var(--color-primary-500);
    margin: 0;
    line-height: var(--line-height-tight);
    transition: var(--transition-color);
}

.docs-card:hover .docs-card__title {
    color: var(--color-primary-600);
}

.docs-card__description {
    font-size: var(--font-size-base);
    line-height: var(--line-height-relaxed);
    color: var(--color-text-secondary);
    margin: 0;
    flex: 1;
}

/* Card Link */
.docs-card__link {
    display: inline-flex;
    align-items: center;
    gap: var(--spacing-2);
    font-size: var(--font-size-base);
    font-weight: var(--font-weight-semibold);
    color: var(--color-primary-500);
    text-decoration: none;
    transition: var(--transition-base);
    margin-top: auto;
    padding-top: var(--spacing-2);
}

.docs-card__link:hover,
.docs-card__link:focus {
    color: var(--color-primary-600);
    gap: var(--spacing-3);
}

.docs-card__link i {
    font-size: var(--font-size-sm);
    transition: var(--transition-transform);
}

.docs-card__link:hover i,
.docs-card__link:focus i {
    transform: translateX(4px);
}

/* ===================================
   RESPONSIVE ADJUSTMENTS
   =================================== */

/* Tablet Layout */
@media (max-width: 991px) {
    .docs-hero {
        padding: var(--section-padding-sm);
    }

    .docs-hero::before,
    .docs-hero::after {
        width: 400px;
        height: 400px;
    }

    .docs-grid {
        padding: var(--section-padding-sm);
    }

    .docs-grid__wrapper {
        grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
        gap: var(--spacing-6);
    }

    .docs-card {
        padding: var(--card-padding-sm);
    }
}

/* Mobile Layout */
@media (max-width: 767px) {
    .docs-hero {
        padding: var(--section-padding-xs);
    }

    .docs-grid {
        padding: var(--section-padding-xs);
    }

    .docs-grid__wrapper {
        grid-template-columns: 1fr;
        gap: var(--spacing-6);
    }

    .docs-card {
        padding: var(--card-padding-sm);
    }

    .docs-card__icon-wrapper {
        width: 56px;
        height: 56px;
    }

    .docs-card__icon {
        font-size: var(--font-size-2xl);
    }

    .docs-card__title {
        font-size: var(--font-size-xl);
    }

    .docs-card__description {
        font-size: var(--font-size-sm);
    }
}

/* Small Mobile */
@media (max-width: 575px) {
    .docs-card {
        padding: var(--spacing-6);
    }

    .docs-card__icon-wrapper {
        width: 48px;
        height: 48px;
    }

    .docs-card__icon {
        font-size: var(--font-size-xl);
    }

    .docs-card__title {
        font-size: var(--font-size-lg);
    }

    .docs-card__description {
        font-size: var(--font-size-sm);
    }
}

/* Ensure 3-column layout on larger screens */
@media (min-width: 992px) {
    .docs-grid__wrapper {
        grid-template-columns: repeat(3, 1fr);
    }
}

/* ===================================
   FOCUS VISIBLE (ACCESSIBILITY)
   =================================== */

.docs-card__link:focus-visible {
    outline: 2px solid var(--color-primary-500);
    outline-offset: 3px;
}

/* ===================================
   PRINT STYLES
   =================================== */

@media print {
    .docs-hero {
        background: transparent;
        padding: var(--spacing-6) 0;
        box-shadow: none;
    }

    .docs-hero::before,
    .docs-hero::after {
        display: none;
    }

    .docs-hero__title,
    .docs-hero__subtitle {
        color: var(--color-text-primary);
    }

    .docs-hero__title::after {
        background: var(--color-primary-500);
    }

    .docs-grid {
        padding: var(--spacing-6) 0;
        box-shadow: none;
    }

    .docs-grid::before,
    .docs-grid::after {
        display: none;
    }

    .docs-grid__wrapper {
        grid-template-columns: repeat(2, 1fr);
        gap: var(--spacing-4);
    }

    .docs-card {
        page-break-inside: avoid;
        box-shadow: none;
        border: var(--border-width-1) solid var(--color-border);
    }

    .docs-card::before {
        display: none;
    }

    .docs-card:hover {
        transform: none;
        box-shadow: none;
    }
}