/* ==========================================================================
   Utility Classes
   ========================================================================== */

.container {
  width: 100%;
  max-width: var(--container-max);
  margin-inline: auto;
  padding-inline: var(--container-padding);
}

.container--narrow {
  max-width: var(--container-narrow);
}

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

.u-skip-link {
  position: absolute;
  top: -48px;
  left: var(--space-sm);
  z-index: var(--z-toast);
  padding: var(--space-2xs) var(--space-sm);
  background: var(--color-secondary);
  color: var(--color-text-inverse);
  border-radius: var(--radius-sm);
  transition: top var(--transition-fast);
}

.u-skip-link:focus {
  top: var(--space-sm);
}

/* Flex helpers */
.u-flex { display: flex; }
.u-flex-col { flex-direction: column; }
.u-flex-wrap { flex-wrap: wrap; }
.u-items-center { align-items: center; }
.u-justify-center { justify-content: center; }
.u-justify-between { justify-content: space-between; }
.u-gap-xs { gap: var(--space-xs); }
.u-gap-sm { gap: var(--space-sm); }
.u-gap-md { gap: var(--space-md); }
.u-gap-lg { gap: var(--space-lg); }

/* Grid helpers */
.u-grid { display: grid; }
.u-grid-2 { grid-template-columns: repeat(auto-fit, minmax(min(100%, 320px), 1fr)); }
.u-grid-3 { grid-template-columns: repeat(auto-fit, minmax(min(100%, 280px), 1fr)); }
.u-grid-4 { grid-template-columns: repeat(auto-fit, minmax(min(100%, 220px), 1fr)); }

/* Text helpers */
.u-text-center { text-align: center; }
.u-text-left { text-align: left; }
.u-text-balance { text-wrap: balance; }
.u-text-primary { color: var(--color-primary); }
.u-text-muted { color: var(--color-text-muted); }
.u-text-inverse { color: var(--color-text-inverse); }
.u-uppercase {
  text-transform: uppercase;
  letter-spacing: var(--ls-wider);
}

/* Spacing helpers */
.u-mt-0 { margin-top: 0; }
.u-mb-0 { margin-bottom: 0; }
.u-mt-sm { margin-top: var(--space-sm); }
.u-mt-md { margin-top: var(--space-md); }
.u-mt-lg { margin-top: var(--space-lg); }
.u-mb-sm { margin-bottom: var(--space-sm); }
.u-mb-md { margin-bottom: var(--space-md); }
.u-mb-lg { margin-bottom: var(--space-lg); }

/* Section spacing */
.u-section {
  padding-block: var(--space-2xl);
}

.u-section--tight {
  padding-block: var(--space-xl);
}

/* Surfaces */
.u-glass {
  background: var(--color-glass-bg);
  border: 1px solid var(--color-glass-border);
  backdrop-filter: blur(16px);
  -webkit-backdrop-filter: blur(16px);
}

.u-rounded-md { border-radius: var(--radius-md); }
.u-rounded-lg { border-radius: var(--radius-lg); }
.u-shadow-md { box-shadow: var(--shadow-md); }
.u-shadow-lg { box-shadow: var(--shadow-lg); }

/* Aspect ratios for media (prevents layout shift) */
.u-aspect-16-9 { aspect-ratio: 16 / 9; }
.u-aspect-4-3 { aspect-ratio: 4 / 3; }
.u-aspect-3-4 { aspect-ratio: 3 / 4; }
.u-aspect-1-1 { aspect-ratio: 1 / 1; }

.u-object-cover {
  width: 100%;
  height: 100%;
  object-fit: cover;
}

/* Responsive display helpers */
.u-hide-mobile { display: none; }
.u-hide-desktop { display: revert; }

@media (min-width: 768px) {
  .u-hide-mobile { display: revert; }
  .u-hide-desktop { display: none; }
}
