/* ═══════════════════════════════════════════════════════════════════
   LIVIA NATURALS — utilities.css
   Layout containers, grids, glassmorphism, aspect ratios, visibility.
   Depends on: tokens.css, base.css
   TidyFactor Design Engine v1.4 · Zero per-page CSS
   ═══════════════════════════════════════════════════════════════════ */

/* Pre-emit critique: P5 H5 E5 S5 R5 V5 */

/* ─── 1. CONTAINERS ───────────────────────────────────────────────── */

.wrap {
  max-width: var(--container);
  margin-inline: auto;
  padding-inline: var(--space-lg);
}

.wrap-wide {
  max-width: var(--container-wide);
  margin-inline: auto;
  padding-inline: var(--space-lg);
}

.wrap-text {
  max-width: var(--container-text);
  margin-inline: auto;
  padding-inline: var(--space-lg);
}

/* ─── 2. SECTION SPACING ──────────────────────────────────────────── */

.section-pad {
  padding-block: clamp(2.5rem, 4.5vh, 4.25rem);
}

.section-pad-sm {
  padding-block: clamp(1.5rem, 3vh, 2.5rem);
}

.section-pad-lg {
  padding-block: clamp(3.5rem, 6vh, 5rem);
}

/* ─── 3. RESPONSIVE GRIDS ─────────────────────────────────────────── */

.grid-2 {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: var(--space-lg);
}

.grid-3 {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: var(--space-lg);
}

.grid-4 {
  display: grid;
  grid-template-columns: repeat(4, 1fr);
  gap: var(--space-md);
}

.grid-auto-fill {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
  gap: var(--space-lg);
}

.grid-split {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--space-xl);
  align-items: center;
}

.grid-split-3-2 {
  display: grid;
  grid-template-columns: 3fr 2fr;
  gap: var(--space-xl);
  align-items: center;
}

/* ─── 4. FLEX UTILITIES ───────────────────────────────────────────── */

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

/* ─── 5. ASPECT RATIOS ────────────────────────────────────────────── */

.aspect-square   { aspect-ratio: 1 / 1; }
.aspect-portrait { aspect-ratio: 3 / 4; }
.aspect-video    { aspect-ratio: 16 / 9; }
.aspect-cinematic { aspect-ratio: 21 / 9; }
.aspect-card     { aspect-ratio: 4 / 5; }
.aspect-hero     { aspect-ratio: 4 / 3; }

.cover-fill {
  width: 100%;
  height: 100%;
  object-fit: cover;
  object-position: center;
}

/* ─── 6. GLASSMORPHISM ────────────────────────────────────────────── */

.glass {
  background: var(--livia-glass);
  backdrop-filter: blur(16px) saturate(180%);
  -webkit-backdrop-filter: blur(16px) saturate(180%);
  border: 1px solid rgba(255, 255, 255, 0.3);
}

.glass-dark {
  background: var(--livia-glass-dark);
  backdrop-filter: blur(20px) saturate(150%);
  -webkit-backdrop-filter: blur(20px) saturate(150%);
  border: 1px solid rgba(255, 255, 255, 0.08);
}

.glass-lilac {
  background: rgba(201, 184, 232, 0.18);
  backdrop-filter: blur(12px);
  -webkit-backdrop-filter: blur(12px);
  border: 1px solid rgba(201, 184, 232, 0.35);
}

/* ─── 7. BACKGROUND FILLS ─────────────────────────────────────────── */

.bg-pearl     { background-color: var(--livia-pearl); }
.bg-blush     { background-color: var(--livia-blush); }
.bg-marble    { background-color: var(--livia-marble); }
.bg-ink       { background-color: var(--livia-ink); }
.bg-magenta   { background-color: var(--livia-magenta); }
.bg-lilac     { background-color: var(--livia-lilac-pale); }
.bg-gold-pale { background-color: var(--livia-gold-pale); }

.bg-gradient-hero {
  background: linear-gradient(160deg,
    var(--livia-ink) 0%,
    #3A1040 40%,
    #2A0A35 70%,
    var(--livia-ink) 100%);
}

.bg-gradient-magenta {
  background: linear-gradient(135deg,
    var(--livia-magenta) 0%,
    var(--livia-magenta-dark) 100%);
}

.bg-gradient-lilac {
  background: linear-gradient(135deg,
    var(--livia-lilac) 0%,
    var(--livia-lilac-dark) 100%);
}

.bg-gradient-brand {
  background: linear-gradient(135deg,
    var(--livia-magenta) 0%,
    #7B3AAA 50%,
    var(--livia-lilac-dark) 100%);
}

/* ─── 8. TEXT COLOR UTILITIES ─────────────────────────────────────── */

.text-ink      { color: var(--livia-ink); }
.text-soft     { color: var(--livia-ink-soft); }
.text-muted    { color: var(--livia-ink-muted); }
.text-magenta  { color: var(--livia-magenta); }
.text-lilac    { color: var(--livia-lilac); }
.text-gold     { color: var(--livia-gold); }
.text-white    { color: var(--livia-white); }
.text-botanical { color: var(--livia-botanical); }

/* ─── 9. DIVIDERS ─────────────────────────────────────────────────── */

.divider {
  width: 100%;
  height: 1px;
  background: var(--livia-line);
}

.divider-gold {
  width: 48px;
  height: 1px;
  background: var(--livia-gold);
  margin-block: var(--space-md);
}

/* ─── 10. VISIBILITY & ANIMATION CLASSES ─────────────────────────── */

.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  overflow: hidden;
  clip: rect(0,0,0,0);
  white-space: nowrap;
}

/* Scroll-reveal base states (GSAP sets opacity/transform) */
.reveal {
  opacity: 0;
  transform: translateY(24px);
}

.reveal-left {
  opacity: 0;
  transform: translateX(-32px);
}

.reveal-right {
  opacity: 0;
  transform: translateX(32px);
}

.reveal.is-visible,
.reveal-left.is-visible,
.reveal-right.is-visible {
  opacity: 1;
  transform: translate(0, 0);
  transition: opacity var(--dur-slow) var(--ease-out),
              transform var(--dur-slow) var(--ease-out);
}

/* ─── 11. OVERFLOW ────────────────────────────────────────────────── */

.clip        { overflow: hidden; }
.overflow-x  { overflow-x: auto; overflow-y: visible; }

/* ─── 12. POSITION UTILITIES ──────────────────────────────────────── */

.relative { position: relative; }
.absolute { position: absolute; }
.inset-0  { inset: 0; }
.z-above  { z-index: var(--z-above); }

/* ─── 13. RESPONSIVE BREAKPOINTS ──────────────────────────────────── */

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

@media (max-width: 768px) {
  .wrap,
  .wrap-wide,
  .wrap-text {
    padding-inline: var(--space-md);
  }

  .grid-2,
  .grid-3,
  .grid-4,
  .grid-split,
  .grid-split-3-2 {
    grid-template-columns: 1fr;
  }

  .section-pad   { padding-block: clamp(2rem, 4vh, 3rem); }
  .section-pad-lg { padding-block: clamp(2.5rem, 5vh, 3.5rem); }

  .hide-mobile { display: none !important; }
}

@media (min-width: 769px) {
  .hide-desktop { display: none !important; }
}