/* ===========================================================================
   VKV Group — Utilities & Animation Layer (Module 2)
   Grid, spacing, responsive helpers, and a small performant animation kit.
   All motion is transform/opacity only (compositor-friendly) and every
   animation is disabled under prefers-reduced-motion.
   =========================================================================== */

/* ---- Container variants ---- */
.container-wide { width: min(100% - 2.5rem, var(--container-wide)); margin-inline: auto; }
.container-narrow { width: min(100% - 2.5rem, var(--container-narrow)); margin-inline: auto; }

/* ---- Fluid auto grid ---- */
.grid { display: grid; gap: var(--gutter); }
.grid-2 { grid-template-columns: repeat(2, 1fr); }
.grid-3 { grid-template-columns: repeat(3, 1fr); }
.grid-4 { grid-template-columns: repeat(4, 1fr); }
.grid-auto { grid-template-columns: repeat(auto-fit, minmax(min(100%, 260px), 1fr)); }
.grid-auto-sm { grid-template-columns: repeat(auto-fit, minmax(min(100%, 180px), 1fr)); }
@media (max-width: 980px) { .grid-3, .grid-4 { grid-template-columns: repeat(2, 1fr); } }
@media (max-width: 640px) { .grid-2, .grid-3, .grid-4 { grid-template-columns: 1fr; } }

/* ---- Flex helpers ---- */
.flex { display: flex; } .inline-flex { display: inline-flex; }
.flex-col { flex-direction: column; }
.flex-wrap { flex-wrap: wrap; }
.items-center { align-items: center; } .items-start { align-items: flex-start; } .items-end { align-items: flex-end; }
.justify-center { justify-content: center; } .justify-between { justify-content: space-between; }
.gap-2 { gap: var(--space-2); } .gap-3 { gap: var(--space-3); } .gap-4 { gap: var(--space-4); }
.gap-5 { gap: var(--space-5); } .gap-6 { gap: var(--space-6); }

/* ---- Spacing utilities (margin/padding on the token scale) ---- */
.mt-0{margin-top:0}.mt-2{margin-top:var(--space-2)}.mt-3{margin-top:var(--space-3)}
.mt-4{margin-top:var(--space-4)}.mt-5{margin-top:var(--space-5)}.mt-6{margin-top:var(--space-6)}.mt-7{margin-top:var(--space-7)}
.mb-0{margin-bottom:0}.mb-2{margin-bottom:var(--space-2)}.mb-3{margin-bottom:var(--space-3)}
.mb-4{margin-bottom:var(--space-4)}.mb-5{margin-bottom:var(--space-5)}.mb-6{margin-bottom:var(--space-6)}.mb-7{margin-bottom:var(--space-7)}
.mx-auto{margin-inline:auto}
.pt-6{padding-top:var(--space-6)}.pt-7{padding-top:var(--space-7)}.pb-6{padding-bottom:var(--space-6)}.pb-7{padding-bottom:var(--space-7)}
.p-5{padding:var(--space-5)}.p-6{padding:var(--space-6)}
.section-sm { padding-block: var(--space-8); }
.section-lg { padding-block: calc(var(--space-9) + var(--space-6)); }

/* ---- Text utilities ---- */
.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}
.text-muted{color:var(--text-muted)}.text-accent{color:var(--accent-soft)}
.measure{max-width:62ch}.measure-narrow{max-width:46ch}
.fw-600{font-weight:600}.fw-700{font-weight:700}
.uppercase{text-transform:uppercase;letter-spacing:0.14em}

/* ---- Display / responsive visibility ---- */
.w-full{width:100%}.h-full{height:100%}
.hidden{display:none}
.relative{position:relative}
@media (max-width: 760px){ .hide-mobile{display:none !important} }
@media (min-width: 761px){ .show-mobile{display:none !important} }
@media (max-width: 980px){ .hide-tablet{display:none !important} }

/* ===========================================================================
   ANIMATION UTILITIES
   Usage: add a class; for scroll-triggered ones add data-reveal and ui.js
   toggles .is-visible when the element enters the viewport.
   =========================================================================== */

/* Reveal on scroll — element starts hidden, .is-visible reveals it. */
[data-reveal] { opacity: 0; transform: translateY(18px); transition:
  opacity var(--dur-slow) var(--ease-out), transform var(--dur-slow) var(--ease-out); will-change: opacity, transform; }
[data-reveal].is-visible { opacity: 1; transform: none; }
[data-reveal="left"]  { transform: translateX(-24px); }
[data-reveal="right"] { transform: translateX(24px); }
[data-reveal="scale"] { transform: scale(0.96); }
[data-reveal].is-visible { transform: none; }
/* Stagger children: set --i on each child (or via ui.js) */
[data-reveal-group] > * { opacity: 0; transform: translateY(16px);
  transition: opacity var(--dur-slow) var(--ease-out), transform var(--dur-slow) var(--ease-out);
  transition-delay: calc(var(--i, 0) * 70ms); }
[data-reveal-group].is-visible > * { opacity: 1; transform: none; }

/* One-shot fade-in on load */
.fade-in { animation: vkv-fade-in var(--dur-slow) var(--ease-out) both; }
.fade-up { animation: vkv-slide-up var(--dur-slow) var(--ease-out) both; }

/* Hover lift — for any interactive surface */
.hover-lift { transition: transform var(--dur) var(--ease), box-shadow var(--dur) var(--ease); will-change: transform; }
.hover-lift:hover { transform: translateY(-4px); box-shadow: var(--shadow-2); }

/* Hover tilt-glow accent line */
.hover-underline { position: relative; }
.hover-underline::after { content: ''; position: absolute; left: 0; bottom: -3px; height: 2px; width: 0;
  background: var(--grad-gold); transition: width var(--dur) var(--ease); }
.hover-underline:hover::after { width: 100%; }

/* Floating ambient motion (decorative elements only) */
.float { animation: vkv-float 6s var(--ease) infinite; }
.float-slow { animation: vkv-float 9s var(--ease) infinite; }

/* Parallax: ui.js sets --parallax on scroll; layer translates by data-speed */
[data-parallax] { will-change: transform; transform: translate3d(0, var(--parallax, 0px), 0); }

/* Ambient glow pulse for accents */
.pulse-glow { animation: vkv-pulse 3.2s var(--ease) infinite; }

/* ---- Keyframes ---- */
@keyframes vkv-fade-in { from { opacity: 0; } to { opacity: 1; } }
@keyframes vkv-slide-up { from { opacity: 0; transform: translateY(20px); } to { opacity: 1; transform: none; } }
@keyframes vkv-modal-in { from { opacity: 0; transform: translateY(12px) scale(0.98); } to { opacity: 1; transform: none; } }
@keyframes vkv-spin { to { transform: rotate(360deg); } }
@keyframes vkv-shimmer { 100% { transform: translateX(100%); } }
@keyframes vkv-float { 0%,100% { transform: translateY(0); } 50% { transform: translateY(-10px); } }
@keyframes vkv-pulse { 0%,100% { opacity: 0.6; } 50% { opacity: 1; } }

/* ---- Global reduced-motion guard ---- */
@media (prefers-reduced-motion: reduce) {
  [data-reveal], [data-reveal-group] > * { opacity: 1 !important; transform: none !important; transition: none !important; }
  .fade-in, .fade-up, .float, .float-slow, .pulse-glow, .tab-panel { animation: none !important; }
  [data-parallax] { transform: none !important; }
  .hover-lift:hover { transform: none; }
}

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