/**
 * Utility Classes
 * Small, single-purpose helpers to align, space, and compose layouts.
 * Prefix `u-` keeps them distinct from components.
 */

/* Accessibility */
.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;
}

/* Text helpers */
.u-text-up { text-transform: uppercase; }
.u-text-center { text-align: center; }
.u-text-left { text-align: left; }
.u-text-right { text-align: right; }
.u-no-select {
  user-select: none;
  -webkit-user-select: none;
}

/* Performance */
.u-gpu {
  transform: translateZ(0);
  will-change: transform;
}

/* Flexbox */
.u-flex { display: flex; }
.u-stack {
  display: flex;
  flex-direction: column;
}

.u-flex-1 { flex: 1 1 auto; }

.u-justify-start { justify-content: flex-start; }
.u-justify-center { justify-content: center; }
.u-justify-end { justify-content: flex-end; }
.u-justify-between { justify-content: space-between; }

.u-align-start { align-items: flex-start; }
.u-align-center { align-items: center; }
.u-align-end { align-items: flex-end; }
.u-align-stretch { align-items: stretch; }

/* Gap scale */
.u-gap-xs { gap: var(--spacing-xs); }
.u-gap-sm { gap: var(--spacing-sm); }
.u-gap-md { gap: var(--spacing-md); }
.u-gap-lg { gap: var(--spacing-lg); }
.u-gap-xl { gap: var(--spacing-xl); }
.u-gap-2xl { gap: var(--spacing-2xl); }

/* Sizing */
.u-w-full { width: 100%; }

/* Positioning */
.u-relative { position: relative; }
.u-absolute-cover {
  position: absolute;
  inset: 0;
}

/* Visibility states - for animated show/hide patterns */
.u-hidden {
  opacity: 0;
  visibility: hidden;
  pointer-events: none;
}

.u-visible {
  opacity: 1;
  visibility: visible;
  pointer-events: auto;
}

/* Flex centering - very common pattern */
.u-flex-center {
  display: flex;
  align-items: center;
  justify-content: center;
}

/* Media object-fit patterns */
.u-media-contain {
  width: 100%;
  height: 100%;
  object-fit: contain;
  object-position: center;
  display: block;
}

.u-media-cover {
  width: 100%;
  height: 100%;
  object-fit: cover;
  object-position: center;
  display: block;
}

/* Transition presets */
.u-transition-fade {
  transition: opacity var(--duration-fast) var(--easing-default),
              visibility var(--duration-fast) var(--easing-default);
}

.u-transition-transform {
  transition: transform var(--duration-fast) var(--easing-default);
}