/* =============================================================================
   utilities.css — a11y helpers, hidden state, reduced-motion, spacing helpers
   ========================================================================== */

/* ---------- VISUALLY HIDDEN (screen-reader only) ---------- */
.sr-only {
  position: absolute !important;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  clip-path: inset(50%);
  white-space: nowrap;
  border: 0;
}

/* ---------- HIDDEN ATTRIBUTE ---------- */
[hidden] { display: none !important; }

/* ---------- SKIP LINK (hidden until focused, then pinned top w/ glass) ---------- */
.skip-link {
  position: fixed;
  inset-block-start: var(--space-3);
  inset-inline-start: 50%;
  transform: translate(-50%, -160%);
  z-index: var(--z-loader);
  padding: var(--space-3) var(--space-5);
  border-radius: 999px;
  font-weight: 600;
  color: var(--text-primary);
  background: var(--glass-bg);
  -webkit-backdrop-filter: blur(var(--glass-blur)) saturate(140%);
  backdrop-filter: blur(var(--glass-blur)) saturate(140%);
  border: 1px solid var(--glass-border);
  box-shadow: var(--glass-shadow);
  opacity: 0;
  pointer-events: none;
  transition: transform var(--dur) var(--ease-cinematic), opacity var(--dur) var(--ease-out);
}

.skip-link:focus,
.skip-link:focus-visible {
  transform: translate(-50%, 0);
  opacity: 1;
  pointer-events: auto;
  outline: 3px solid var(--ring);
  outline-offset: 3px;
}

/* RTL writes the translate centering identically; logical inset keeps it centered. */

/* ---------- SPACING HELPERS ---------- */
.mt-0 { margin-block-start: 0 !important; }
.mb-0 { margin-block-end: 0 !important; }
.flow > * + * { margin-block-start: var(--space-4); }
.flow-lg > * + * { margin-block-start: var(--space-6); }

.text-muted { color: var(--text-muted); }
.text-center { text-align: center; }

/* ---------- REDUCED MOTION ----------
   Global safety net: collapse animations/transitions for users who opt out.
   Components also gate their own motion, but this guarantees coverage. */
@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.001ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.001ms !important;
    scroll-behavior: auto !important;
  }
}