/* Skip Link - Accessibility navigation */
.skip-link {
  position: absolute;
  top: -100%;
  left: 50%;
  transform: translateX(-50%);
  background: var(--color-primary, #000);
  color: var(--color-secondary, #fff);
  padding: 0.75rem 1.5rem;
  border-radius: 0.5rem;
  z-index: 100000;
  text-decoration: none;
  font-weight: 500;
  transition: top 0.3s ease;
}

.skip-link:focus {
  top: 1rem;
  outline: 2px solid var(--color-accent, #0066ff);
  outline-offset: 2px;
}

/**
 * Breakpoints - Standardized Media Query Reference
 *
 * This file documents the standard breakpoints used across the site.
 * Copy the @media queries from here when adding responsive styles.
 *
 * BREAKPOINT SYSTEM:
 * ==================
 *
 * Mobile First Approach (min-width):
 * ----------------------------------
 * @media screen and (min-width: 640px)  { } // sm - Small tablets
 * @media screen and (min-width: 768px)  { } // md - Tablets
 * @media screen and (min-width: 1024px) { } // lg - Small desktops
 * @media screen and (min-width: 1280px) { } // xl - Desktops
 * @media screen and (min-width: 1440px) { } // 2xl - Large desktops
 * @media screen and (min-width: 1920px) { } // 3xl - Extra large screens
 *
 * Desktop First Approach (max-width):
 * -----------------------------------
 * @media screen and (max-width: 1919px) { } // Below 3xl
 * @media screen and (max-width: 1439px) { } // Below 2xl
 * @media screen and (max-width: 1279px) { } // Below xl
 * @media screen and (max-width: 1023px) { } // Below lg (tablets and below)
 * @media screen and (max-width: 767px)  { } // Mobile only
 * @media screen and (max-width: 639px)  { } // Small mobile
 * @media screen and (max-width: 479px)  { } // Extra small mobile
 * @media screen and (max-width: 374px)  { } // iPhone SE and similar
 *
 * Range Queries (for specific ranges):
 * ------------------------------------
 * @media screen and (min-width: 768px) and (max-width: 1023px)  { } // Tablet only
 * @media screen and (min-width: 1024px) and (max-width: 1279px) { } // Small desktop
 * @media screen and (min-width: 1280px) and (max-width: 1439px) { } // Medium desktop
 * @media screen and (min-width: 1440px) and (max-width: 1919px) { } // Large desktop
 *
 * Special Queries:
 * ----------------
 * @media screen and (max-width: 767px) and (orientation: landscape) { } // Mobile landscape
 * @media (hover: none) and (pointer: coarse) { } // Touch devices
 * @media (prefers-reduced-motion: reduce) { } // Accessibility
 * @media (prefers-color-scheme: dark) { } // Dark mode preference
 */

/* Utility classes for responsive hiding/showing */

/* Hide on mobile, show on tablet+ */
@media screen and (max-width: 767px) {
  .hide-mobile {
    display: none;
  }
}

/* Hide on tablet+, show on mobile */
@media screen and (min-width: 768px) {
  .hide-desktop {
    display: none;
  }
}

/* Hide on tablet only */
@media screen and (min-width: 768px) and (max-width: 1023px) {
  .hide-tablet {
    display: none;
  }
}

/* Show only on mobile */
.show-mobile {
  display: none;
}

@media screen and (max-width: 767px) {
  .show-mobile {
    display: block;
  }
}

/* Show only on tablet */
.show-tablet {
  display: none;
}

@media screen and (min-width: 768px) and (max-width: 1023px) {
  .show-tablet {
    display: block;
  }
}

/* Show only on desktop */
.show-desktop {
  display: none;
}

@media screen and (min-width: 1024px) {
  .show-desktop {
    display: block;
  }
}

/**
 * =============================================
 * BEST PRACTICES FOR RESPONSIVE CSS
 * =============================================
 *
 * 1. AVOID !important
 * -------------------
 * Instead of:
 *   .element { display: none !important; }
 *
 * Use higher specificity:
 *   @media (max-width: 767px) {
 *     body .element { display: none; }
 *   }
 *
 * Or use :where() for lower specificity base styles:
 *   :where(.element) { display: block; }
 *   @media (max-width: 767px) {
 *     .element { display: none; }
 *   }
 *
 * 2. MOBILE-FIRST APPROACH
 * ------------------------
 * Write base styles for mobile, then add desktop styles:
 *
 *   .element {
 *     font-size: 14px;  // Mobile default
 *     padding: 1rem;
 *   }
 *
 *   @media (min-width: 768px) {
 *     .element {
 *       font-size: 16px;  // Tablet+
 *       padding: 2rem;
 *     }
 *   }
 *
 * 3. CSS LAYER ORDER
 * ------------------
 * Use @layer to control cascade without !important:
 *
 *   @layer base, components, utilities, overrides;
 *
 *   @layer base { ... }
 *   @layer components { ... }
 *   @layer overrides { // Always wins without !important }
 *
 * 4. CSS VARIABLES FOR RESPONSIVE VALUES
 * --------------------------------------
 * Use CSS custom properties that change at breakpoints:
 *
 *   :root {
 *     --spacing: 1rem;
 *   }
 *
 *   @media (min-width: 768px) {
 *     :root {
 *       --spacing: 2rem;
 *     }
 *   }
 *
 *   .element {
 *     padding: var(--spacing);
 *   }
 */