/* ===========================
   Utility Classes — Premium
   =========================== */

/* --- Text colors --- */
.text-primary { color: var(--color-primary); }
.text-success { color: var(--color-success); }
.text-error { color: var(--color-error); }
.text-warning { color: var(--color-warning); }
.text-secondary { color: var(--color-text-secondary); }
.text-muted { color: var(--color-text-secondary); }

/* --- Background colors --- */
.bg-surface { background: var(--color-surface); }
.bg-muted { background: var(--color-bg); }
.bg-error { background: var(--color-error-bg); }
.bg-warning { background: var(--color-warning-bg); }
.bg-success { background: var(--color-success-bg); }
.bg-info { background: var(--color-info-bg); }

/* --- Layout utilities --- */
.flex { display: flex; }
.flex-col { flex-direction: column; }
.flex-wrap { flex-wrap: wrap; }
.items-center { align-items: center; }
.justify-center { justify-content: center; }
.justify-between { justify-content: space-between; }
.grid { display: grid; }
.grid-cols-3 { grid-template-columns: repeat(3, 1fr); }
.text-center { text-align: center; }

/* --- Spacing utilities --- */
.gap-xs { gap: var(--space-xs); }
.gap-sm { gap: var(--space-sm); }
.gap-md { gap: var(--space-md); }
.gap-lg { gap: var(--space-lg); }
.gap-xl { gap: var(--space-xl); }

.p-sm { padding: var(--space-sm); }
.p-md { padding: var(--space-md); }
.p-lg { padding: var(--space-lg); }

.mt-xs { margin-top: var(--space-xs); }
.mt-sm { margin-top: var(--space-sm); }
.mt-md { margin-top: var(--space-md); }
.mt-lg { margin-top: var(--space-lg); }
.mt-xl { margin-top: var(--space-xl); }

.mb-sm { margin-bottom: var(--space-sm); }
.mb-md { margin-bottom: var(--space-md); }
.mb-lg { margin-bottom: var(--space-lg); }
.mb-xl { margin-bottom: var(--space-xl); }

/* --- Text styling utilities --- */
.font-medium { font-weight: var(--font-medium); }
.font-semibold { font-weight: var(--font-semibold); }
.font-bold { font-weight: var(--font-bold); }
.text-xs { font-size: var(--text-xs); }
.text-sm { font-size: var(--text-sm); }
.text-base { font-size: var(--text-base); }
.text-md { font-size: var(--text-md); }
.text-lg { font-size: var(--text-lg); }
.text-xl { font-size: var(--text-xl); }
.text-2xl { font-size: var(--text-2xl); }
.leading-tight { line-height: var(--line-height-tight); }
.leading-normal { line-height: var(--line-height-normal); }
.leading-relaxed { line-height: var(--line-height-relaxed); }

/* --- Heading hierarchy --- */
.heading-page { font-size: var(--text-2xl); font-weight: var(--font-bold); letter-spacing: -0.02em; line-height: 1.3; }
.heading-section { font-size: var(--text-lg); font-weight: var(--font-semibold); letter-spacing: 0; line-height: 1.4; }
.heading-label { font-size: var(--text-sm); font-weight: var(--font-bold); text-transform: uppercase; letter-spacing: 0.06em; line-height: 1.5; }

/* --- Layout utilities (inline style purge) --- */
.justify-end { justify-content: flex-end; }
.mb-0 { margin-bottom: 0; }
.ml-auto { margin-left: auto; }
.w-full { width: 100%; }
.min-h-touch { min-height: 2.75rem; }
.link-inherit { color: inherit; text-decoration: underline; }

/* --- Focus glow utility --- */
.focus-glow:focus-visible {
  outline: var(--focus-outline-width) solid var(--color-primary);
  outline-offset: var(--focus-outline-offset);
  box-shadow: 0 0 0 4px var(--focus-ring-color), var(--shadow-glow);
}

/* --- Step transition utilities --- */
.transition-fade {
  transition: opacity var(--transition-base), transform var(--transition-base);
}
.transition-fade--enter {
  opacity: 0;
  transform: translateY(12px);
}
.transition-fade--enter-active {
  opacity: 1;
  transform: translateY(0);
}
@media (prefers-reduced-motion: reduce) {
  .transition-fade {
    transition: none;
  }
  .transition-fade--enter {
    opacity: 1;
    transform: none;
  }
}

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