/* ============================================================
   CHEDDERS PAY — utilities.css
   Reusable Helpers · Layout Utilities · Spacing · Animation
   V3 DNA Compliant
   ============================================================ */

/* ══════════════════════════════════════════════════════════
   SECTION PADDING — V3 Tier System
   Desktop 96px · Tablet 64px · Mobile 52px · 320px 40px
   ══════════════════════════════════════════════════════════ */

.section-padding {
  padding-top: var(--space-2xl);   /* 96px */
  padding-bottom: var(--space-2xl);
}

.section-padding--sm {
  padding-top: var(--space-xl);    /* 64px */
  padding-bottom: var(--space-xl);
}

/* Tablet */
@media (max-width: 991px) {
  .section-padding     { padding-top: 64px; padding-bottom: 64px; }
  .section-padding--sm { padding-top: 48px; padding-bottom: 48px; }
}

/* Mobile */
@media (max-width: 575px) {
  .section-padding     { padding-top: 52px; padding-bottom: 52px; }
  .section-padding--sm { padding-top: 36px; padding-bottom: 36px; }
}

/* Smallest Mobile */
@media (max-width: 320px) {
  .section-padding     { padding-top: 40px; padding-bottom: 40px; }
  .section-padding--sm { padding-top: 28px; padding-bottom: 28px; }
}

/* ══════════════════════════════════════════════════════════
   CONTENT WIDTH
   ══════════════════════════════════════════════════════════ */

.content-width {
  max-width: 1320px;
  width: 100%;
  padding-left: 24px;
  padding-right: 24px;
  overflow: hidden;
  margin-left: auto;
  margin-right: auto;
}

.content-width--sm {
  max-width: 540px;
  margin-left: auto;
  margin-right: auto;
}

.content-width--md {
  max-width: 720px;
  margin-left: auto;
  margin-right: auto;
}

.content-width--lg {
  max-width: 900px;
  margin-left: auto;
  margin-right: auto;
}

/* ══════════════════════════════════════════════════════════
   FLEX UTILITIES
   ══════════════════════════════════════════════════════════ */

.flex-center {
  display: flex;
  align-items: center;
  justify-content: center;
}

.flex-between {
  display: flex;
  align-items: center;
  justify-content: space-between;
}

.flex-start {
  display: flex;
  align-items: center;
  justify-content: flex-start;
}

.flex-column-center {
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
}

/* ══════════════════════════════════════════════════════════
   GRID SYSTEM
   ══════════════════════════════════════════════════════════ */

.grid-2 {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: 24px;
}

.grid-3 {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 24px;
}

.grid-4 {
  display: grid;
  grid-template-columns: repeat(4, 1fr);
  gap: 24px;
}

@media (max-width: 991px) {
  .grid-3 { grid-template-columns: repeat(2, 1fr); gap: 16px; }
  .grid-4 { grid-template-columns: repeat(2, 1fr); gap: 16px; }
}

@media (max-width: 575px) {
  .grid-2,
  .grid-3,
  .grid-4 { grid-template-columns: 1fr; gap: 12px; }
}

@media (max-width: 320px) {
  .grid-2,
  .grid-3,
  .grid-4 { grid-template-columns: 1fr; gap: 10px; }
}

/* ══════════════════════════════════════════════════════════
   SECTION HEADER
   ══════════════════════════════════════════════════════════ */

.section-header {
  text-align: center;
  margin-bottom: 48px;
}

.section-header--left {
  text-align: left;
  margin-bottom: 40px;
}

.section-label {
  display: inline-block;
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--accent);
  background-color: var(--accent-subtle);
  padding: 4px 12px;
  border-radius: var(--radius-sm);
  margin-bottom: 12px;
  border: 1px solid var(--accent-border);
  transition: background-color var(--transition-base),
              border-color var(--transition-base);
}

/* Light mode label */
[data-theme="light"] .section-label {
  color: var(--primary);
  background-color: var(--surface-2);
  border-color: var(--border);
}

.section-header .section-title {
  margin-bottom: 12px;
}

.section-header .section-desc {
  color: var(--muted);
  font-size: 16px;
  line-height: 1.7;
  max-width: 560px;
  margin: 0 auto;
}

/* ══════════════════════════════════════════════════════════
   ICON BOX — V3 §7.6 canonical
   ══════════════════════════════════════════════════════════ */

.icon-box {
  width: 44px;
  height: 44px;
  flex-shrink: 0;
  display: flex;
  align-items: center;
  justify-content: center;
  background-color: var(--accent-subtle);
  border: 1px solid var(--accent-border);
  border-radius: var(--radius-lg);
  color: var(--accent);
  transition: background-color var(--transition-base),
              border-color var(--transition-base);
}

.icon-box svg {
  width: 20px;
  height: 20px;
  stroke: currentColor;
}

/* ══════════════════════════════════════════════════════════
   DIVIDER
   ══════════════════════════════════════════════════════════ */

.divider {
  width: 48px;
  height: 3px;
  background-color: var(--accent);
  border-radius: 2px;
  margin-bottom: 20px;
  transition: background-color var(--transition-base);
}

.divider--center {
  margin-left: auto;
  margin-right: auto;
}

/* ══════════════════════════════════════════════════════════
   STATUS & ACCENT BADGES
   ══════════════════════════════════════════════════════════ */

.status-badge {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  font-size: 12px;
  font-weight: 600;
  letter-spacing: 0.04em;
  padding: 4px 10px;
  border-radius: var(--radius-sm);
}

.status-badge--active {
  color: var(--success);
  background-color: var(--live-dim);
  border: 1px solid rgba(0, 229, 160, 0.25);
}

.status-badge--active::before {
  content: '';
  width: 6px;
  height: 6px;
  border-radius: 50%;
  background-color: var(--success);
  animation: pulse-dot 2s ease-in-out infinite;
}

.accent-badge {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  font-size: 12px;
  font-weight: 600;
  letter-spacing: 0.04em;
  padding: 4px 10px;
  border-radius: var(--radius-sm);
  color: var(--accent);
  background-color: var(--accent-subtle);
  border: 1px solid var(--accent-border);
}

@keyframes pulse-dot {
  0%, 100% { opacity: 1; transform: scale(1); }
  50%       { opacity: 0.45; transform: scale(0.75); }
}

/* ══════════════════════════════════════════════════════════
   SURFACE BACKGROUNDS
   ══════════════════════════════════════════════════════════ */

.bg-surface {
  background-color: var(--surface);
  transition: background-color var(--transition-base);
}

.bg-surface-2 {
  background-color: var(--surface-2);
  transition: background-color var(--transition-base);
}

.bg-surface-3 {
  background-color: var(--surface-3);
  transition: background-color var(--transition-base);
}

/* ══════════════════════════════════════════════════════════
   TEXT UTILITIES
   ══════════════════════════════════════════════════════════ */

.text-muted    { color: var(--muted); }
.text-accent   { color: var(--accent); }
.text-success  { color: var(--success); }
.text-danger   { color: var(--danger); }
.text-warning  { color: var(--warning); }

/* ══════════════════════════════════════════════════════════
   SPACING HELPERS
   ══════════════════════════════════════════════════════════ */

.gap-xs  { gap: var(--space-xs); }
.gap-sm  { gap: var(--space-sm); }
.gap-md  { gap: var(--space-md); }
.gap-lg  { gap: var(--space-lg); }

.mb-xs  { margin-bottom: var(--space-xs); }
.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); }

.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); }

/* ══════════════════════════════════════════════════════════
   VISIBILITY HELPERS
   ══════════════════════════════════════════════════════════ */

.hide-mobile  { display: block; }
.show-mobile  { display: none; }

@media (max-width: 575px) {
  .hide-mobile { display: none; }
  .show-mobile { display: block; }
}

/* ══════════════════════════════════════════════════════════
   ANIMATION — V3 §9 Canonical Pattern
   .fade-in-up + .is-visible + .stagger-group
   ══════════════════════════════════════════════════════════ */

.fade-in-up {
  opacity: 0;
  transform: translateY(18px);
  transition: opacity 0.4s ease, transform 0.4s ease;
}

.fade-in-up.is-visible {
  opacity: 1;
  transform: translateY(0);
}

/* ══════════════════════════════════════════════════════════
   REDUCED MOTION — V3 §9 Mandatory
   ══════════════════════════════════════════════════════════ */

@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }

  .fade-in-up {
    opacity: 1;
    transform: none;
  }

  html {
    scroll-behavior: auto;
  }
}