/**
  * Enhanced metric card component with modern design, smooth animations,
 * and improved visual hierarchy for displaying KPIs and metrics.
 *
 * FEATURES:
 * - Gradient backgrounds with subtle color tints
 * - Animated gradient top border on hover
 * - Icon with glow effect and rotation animation
 * - Gradient text on metric values
 * - Shimmer effect on change badges
 * - Loading state with skeleton screens
 * - 6 color variants (primary, secondary, success, warning, danger, info)
 * - Size variants (sm, default, lg)
 * - Fully accessible (ARIA labels, keyboard navigation, screen reader support)
 * - Responsive design for mobile, tablet, and desktop
 * - Reduced motion and high contrast mode support
 * - Print-friendly styles
 * - Smooth hover animations with lift effect
 *
 * USAGE:
 * Use the MetricCardViewComponent with MetricCardViewModel to display metrics.
 * Supports clickable cards (with ActionUrl) and static display cards.
 *
 * @author PBW Web Architects, LLC
 * @license Copyright © PBW Web Architects, LLC
 */

/* ============================================
   Base Metric Card
   ============================================ */

.metric-card {
    position: relative;
    display: flex;
    flex-direction: column;
    width: 100%;
    height: 100%;
    padding: var(--space-4);
    background: var(--color-white);
    border: 1px solid var(--card-border-color);
    border-radius: var(--radius-lg);
    box-shadow: var(--shadow-sm);
    transition: all var(--transition-base);
    overflow: hidden;
    cursor: pointer;
    min-height: 120px;
    text-decoration: none;
}

/* Decorative gradient overlay */
.metric-card::before {
    content: '';
    position: absolute;
    top: 0;
    left: 0;
    right: 0;
    height: 4px;
    background: linear-gradient(90deg, transparent 0%, var(--color-primary) 100%);
    opacity: 0;
    transition: opacity var(--transition-base);
}

.metric-card:hover {
    box-shadow: var(--shadow-xl);
    transform: translateY(-4px);
    border-color: var(--color-primary-light);
}

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

/* Active/Focus state for accessibility */
.metric-card:focus-visible {
    outline: 2px solid var(--color-primary);
    outline-offset: 2px;
}

.metric-card:active {
    transform: translateY(-2px);
}

/* ============================================
   Card Header
   ============================================ */

.metric-card__header {
    display: flex;
    align-items: flex-start;
    justify-content: space-between;
    margin-bottom: var(--space-3);
    gap: var(--space-2);
}

.metric-card__title {
    font-size: var(--font-size-xs);
    font-weight: var(--font-weight-semibold);
    letter-spacing: var(--letter-spacing-wide);
    text-transform: uppercase;
    color: var(--color-gray-600);
    margin: 0 0 var(--space-1) 0;
    line-height: var(--line-height-snug);
    flex: 1;
}

.metric-card__icon {
    position: relative;
    display: flex;
    align-items: center;
    justify-content: center;
    width: 44px;
    height: 44px;
    border-radius: var(--radius-lg);
    font-size: var(--font-size-xl);
    transition: all var(--transition-base);
    flex-shrink: 0;
    box-shadow: var(--shadow-sm);
    color: var(--color-white);
}

/* Icon glow effect on hover */
.metric-card__icon::after {
    content: '';
    position: absolute;
    inset: -2px;
    border-radius: var(--radius-xl);
    opacity: 0;
    transition: opacity var(--transition-base);
    z-index: -1;
    filter: blur(8px);
}

.metric-card:hover .metric-card__icon {
    transform: scale(1.05) rotate(5deg);
    box-shadow: var(--shadow-md);
}

.metric-card:hover .metric-card__icon::after {
    opacity: 0.3;
}

/* ============================================
   Card Body
   ============================================ */

.metric-card__body {
    flex: 1;
    display: flex;
    flex-direction: column;
    gap: var(--space-1);
}

.metric-card__value {
    font-size: var(--font-size-3xl);
    font-weight: var(--font-weight-extrabold);
    line-height: var(--line-height-tight);
    color: var(--color-dark);
    margin-bottom: 0;
    letter-spacing: var(--letter-spacing-tight);
    background: linear-gradient(135deg, var(--color-dark) 0%, var(--color-gray-700) 100%);
    -webkit-background-clip: text;
    -webkit-text-fill-color: transparent;
    background-clip: text;
    transition: all var(--transition-base);
}

.metric-card:hover .metric-card__value {
    letter-spacing: -0.03em;
}

.metric-card__description {
    font-size: var(--font-size-xs);
    color: var(--color-gray-700);
    line-height: var(--line-height-base);
    font-weight: var(--font-weight-medium);
}

/* ============================================
   Card Footer
   ============================================ */

.metric-card__footer {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: var(--space-2);
    padding-top: var(--space-3);
    margin-top: var(--space-2);
    border-top: 1px solid rgba(0, 0, 0, 0.06);
}

.metric-card__change {
    display: inline-flex;
    align-items: center;
    gap: var(--space-1);
    font-size: var(--font-size-xs);
    font-weight: var(--font-weight-semibold);
    padding: var(--space-1) var(--space-2);
    border-radius: var(--radius-md);
    transition: all var(--transition-base);
    position: relative;
    overflow: hidden;
}

/* Shimmer effect on change badges */
.metric-card__change::before {
    content: '';
    position: absolute;
    top: 0;
    left: -100%;
    width: 100%;
    height: 100%;
    background: linear-gradient(90deg, transparent, rgba(255, 255, 255, 0.3), transparent);
    transition: left 0.5s ease;
}

.metric-card:hover .metric-card__change::before {
    left: 100%;
}

.metric-card__change-icon {
    font-size: var(--font-size-xs);
    font-weight: var(--font-weight-bold);
}

.metric-card__change--up {
    color: var(--color-success);
    background: linear-gradient(135deg, var(--color-success-light) 0%, rgba(53, 122, 94, 0.15) 100%);
    box-shadow: 0 2px 4px rgba(53, 122, 94, 0.1);
}

.metric-card__change--up:hover {
    box-shadow: 0 4px 8px rgba(53, 122, 94, 0.15);
}

.metric-card__change--down {
    color: var(--color-danger);
    background: linear-gradient(135deg, var(--color-danger-light) 0%, rgba(181, 67, 63, 0.15) 100%);
    box-shadow: 0 2px 4px rgba(181, 67, 63, 0.1);
}

.metric-card__change--down:hover {
    box-shadow: 0 4px 8px rgba(181, 67, 63, 0.15);
}

.metric-card__change--neutral {
    color: var(--color-gray-700);
    background: linear-gradient(135deg, var(--color-gray-100) 0%, var(--color-gray-200) 100%);
    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.05);
}

.metric-card__change--neutral:hover {
    box-shadow: 0 4px 8px rgba(0, 0, 0, 0.08);
}

/* ============================================
   Card Variants
   ============================================ */

/* Primary Variant */
.metric-card--primary {
    background: var(--color-white);
}

.metric-card--primary::before {
    background: linear-gradient(90deg, transparent 0%, var(--color-primary) 100%);
}

.metric-card--primary .metric-card__icon {
    background: linear-gradient(135deg, var(--color-primary) 0%, rgba(37, 71, 106, 0.85) 100%);
    color: var(--color-white);
}

.metric-card--primary .metric-card__icon::after {
    background: var(--color-primary);
}

/* Secondary Variant */
.metric-card--secondary {
    background: var(--color-white);
}

.metric-card--secondary::before {
    background: linear-gradient(90deg, transparent 0%, var(--color-secondary) 100%);
}

.metric-card--secondary .metric-card__icon {
    background: linear-gradient(135deg, var(--color-secondary) 0%, rgba(26, 111, 160, 0.85) 100%);
    color: var(--color-white);
}

.metric-card--secondary .metric-card__icon::after {
    background: var(--color-secondary);
}

/* Success Variant */
.metric-card--success {
    background: var(--color-white);
}

.metric-card--success::before {
    background: linear-gradient(90deg, transparent 0%, var(--color-success) 100%);
}

.metric-card--success .metric-card__icon {
    background: linear-gradient(135deg, var(--color-success) 0%, rgba(53, 122, 94, 0.85) 100%);
    color: var(--color-white);
}

.metric-card--success .metric-card__icon::after {
    background: var(--color-success);
}

/* Warning Variant */
.metric-card--warning {
    background: var(--color-white);
}

.metric-card--warning::before {
    background: linear-gradient(90deg, transparent 0%, var(--color-warning) 100%);
}

.metric-card--warning .metric-card__icon {
    background: linear-gradient(135deg, var(--color-warning) 0%, rgba(134, 106, 34, 0.85) 100%);
    color: var(--color-white);
}

.metric-card--warning .metric-card__icon::after {
    background: var(--color-warning);
}

/* Danger Variant */
.metric-card--danger {
    background: var(--color-white);
}

.metric-card--danger::before {
    background: linear-gradient(90deg, transparent 0%, var(--color-danger) 100%);
}

.metric-card--danger .metric-card__icon {
    background: linear-gradient(135deg, var(--color-danger) 0%, rgba(181, 67, 63, 0.85) 100%);
    color: var(--color-white);
}

.metric-card--danger .metric-card__icon::after {
    background: var(--color-danger);
}

/* Info Variant */
.metric-card--info {
    background: var(--color-white);
}

.metric-card--info::before {
    background: linear-gradient(90deg, transparent 0%, var(--color-info) 100%);
}

.metric-card--info .metric-card__icon {
    background: linear-gradient(135deg, var(--color-info) 0%, rgba(51, 114, 150, 0.85) 100%);
    color: var(--color-white);
}

.metric-card--info .metric-card__icon::after {
    background: var(--color-info);
}

/* ============================================
   Size Variants
   ============================================ */

.metric-card--sm {
    padding: var(--space-4);
}

.metric-card--sm .metric-card__value {
    font-size: var(--font-size-2xl);
}

.metric-card--sm .metric-card__icon {
    width: 36px;
    height: 36px;
    font-size: var(--font-size-lg);
}

.metric-card--lg {
    padding: var(--space-6);
}

.metric-card--lg .metric-card__value {
    font-size: var(--font-size-5xl);
}

.metric-card--lg .metric-card__icon {
    width: 56px;
    height: 56px;
    font-size: var(--font-size-2xl);
}

/* ============================================
   Loading State
   ============================================ */

.metric-card--loading {
    pointer-events: none;
    opacity: 0.7;
}

.metric-card--loading .metric-card__value,
.metric-card--loading .metric-card__description,
.metric-card--loading .metric-card__title {
    background: linear-gradient(
            90deg,
            var(--color-gray-200) 0%,
            var(--color-gray-100) 50%,
            var(--color-gray-200) 100%
    );
    background-size: 200% 100%;
    animation: loading-shimmer 1.8s infinite ease-in-out;
    border-radius: var(--radius-md);
    color: transparent !important;
    -webkit-text-fill-color: transparent !important;
}

.metric-card--loading .metric-card__icon {
    animation: pulse 1.5s infinite ease-in-out;
    opacity: 0.4;
}

@keyframes loading-shimmer {
    0% {
        background-position: 200% 0;
    }
    50% {
        background-position: -200% 0;
    }
    100% {
        background-position: 200% 0;
    }
}

@keyframes pulse {
    0%, 100% {
        opacity: 0.4;
        transform: scale(1);
    }
    50% {
        opacity: 0.6;
        transform: scale(1.05);
    }
}

/* ============================================
   Responsive Adjustments
   ============================================ */

@media (max-width: 768px) {
    .metric-card {
        padding: var(--space-3);
        min-height: 110px;
    }

    .metric-card__header {
        margin-bottom: var(--space-2);
    }

    .metric-card__value {
        font-size: var(--font-size-2xl);
    }

    .metric-card__icon {
        width: 40px;
        height: 40px;
        font-size: var(--font-size-lg);
    }

    .metric-card__title {
        font-size: 0.65rem;
    }

    .metric-card__description {
        font-size: 0.65rem;
    }

    .metric-card__footer {
        padding-top: var(--space-2);
        flex-wrap: wrap;
    }

    .metric-card__change {
        font-size: 0.65rem;
        padding: var(--space-1) var(--space-2);
    }
}

/* ============================================
   Print Styles
   ============================================ */

@media print {
    .metric-card {
        box-shadow: none;
        border: 1px solid var(--color-gray-300);
        break-inside: avoid;
        page-break-inside: avoid;
    }

    .metric-card::before,
    .metric-card__icon::after,
    .metric-card__change::before {
        display: none;
    }

    .metric-card:hover {
        transform: none;
    }
}

/* ============================================
   Accessibility Enhancements
   ============================================ */

/* Reduced motion support */
@media (prefers-reduced-motion: reduce) {
    .metric-card,
    .metric-card__icon,
    .metric-card__value,
    .metric-card__change {
        transition: none;
        animation: none;
    }

    .metric-card:hover {
        transform: none;
    }

    .metric-card:hover .metric-card__icon {
        transform: none;
    }

    .metric-card--loading .metric-card__value,
    .metric-card--loading .metric-card__description,
    .metric-card--loading .metric-card__title {
        animation: none;
        background: var(--color-gray-200);
    }
}

/* High contrast mode support */
@media (prefers-contrast: high) {
    .metric-card {
        border-width: 2px;
    }

    .metric-card__icon {
        border: 2px solid currentColor;
    }
}