/**
 * Accessibility Styles
 *
 * Provides essential accessibility improvements for keyboard navigation,
 * reduced motion preferences, and screen reader support.
 *
 * @package CNXlocal
 * @since 2.0.0
 */

/* ==========================================================================
   Focus States
   ========================================================================== */

/**
 * Focus-visible provides keyboard focus indicators without affecting
 * mouse/touch interactions. Fallback for older browsers included.
 */

/* Default focus state for older browsers */
:focus {
    outline: 2px solid #4a90d9;
    outline-offset: 2px;
}

/* Modern browsers: only show focus for keyboard navigation */
:focus:not(:focus-visible) {
    outline: none;
}

:focus-visible {
    outline: 2px solid #4a90d9;
    outline-offset: 2px;
}

/* High contrast focus for interactive elements */
a:focus-visible,
button:focus-visible,
input:focus-visible,
select:focus-visible,
textarea:focus-visible,
[role="button"]:focus-visible,
[tabindex]:focus-visible {
    outline: 3px solid #4a90d9;
    outline-offset: 2px;
    box-shadow: 0 0 0 4px rgba(74, 144, 217, 0.25);
}

/* Remove default outline on buttons with visible focus styles */
button:focus-visible,
.btn:focus-visible {
    outline: 3px solid #4a90d9;
    outline-offset: 2px;
}

/* ==========================================================================
   Skip Link
   ========================================================================== */

/**
 * Skip link allows keyboard users to bypass navigation and jump to main content.
 * Hidden by default, becomes visible on focus.
 */

.skip-link {
    position: absolute;
    top: -100%;
    left: 50%;
    transform: translateX(-50%);
    z-index: 10000;
    padding: 0.75rem 1.5rem;
    background-color: #1a1a1a;
    color: #ffffff;
    font-weight: 600;
    text-decoration: none;
    border-radius: 0 0 4px 4px;
    transition: top 0.2s ease-in-out;
}

.skip-link:focus {
    top: 0;
    outline: 3px solid #4a90d9;
    outline-offset: 2px;
}

.skip-link:hover {
    background-color: #333333;
    color: #ffffff;
}

/* ==========================================================================
   Screen Reader Only
   ========================================================================== */

/**
 * Hide content visually while keeping it accessible to screen readers.
 * Use for labels, instructions, or context that sighted users don't need.
 */

.sr-only,
.visually-hidden {
    position: absolute;
    width: 1px;
    height: 1px;
    padding: 0;
    margin: -1px;
    overflow: hidden;
    clip: rect(0, 0, 0, 0);
    white-space: nowrap;
    border: 0;
}

/* Allow sr-only content to become visible when focused */
.sr-only-focusable:focus,
.sr-only-focusable:active,
.visually-hidden-focusable:focus,
.visually-hidden-focusable:active {
    position: static;
    width: auto;
    height: auto;
    padding: inherit;
    margin: inherit;
    overflow: visible;
    clip: auto;
    white-space: normal;
}

/* ==========================================================================
   Reduced Motion
   ========================================================================== */

/**
 * Respect user preferences for reduced motion.
 * Disables animations and transitions for users who have enabled this setting.
 */

@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;
    }
}

/* ==========================================================================
   High Contrast Mode Support
   ========================================================================== */

/**
 * Ensure sufficient contrast in Windows High Contrast Mode.
 */

@media (forced-colors: active) {
    :focus-visible {
        outline: 3px solid CanvasText;
    }

    .skip-link {
        background-color: Canvas;
        color: CanvasText;
        border: 2px solid CanvasText;
    }
}

/* ==========================================================================
   Interactive Element Improvements
   ========================================================================== */

/**
 * Ensure touch targets meet minimum size requirements (44x44px).
 */

@media (pointer: coarse) {
    button,
    .btn,
    a.nav-link,
    input[type="checkbox"],
    input[type="radio"] {
        min-height: 44px;
        min-width: 44px;
    }
}
