/* ===============================
UTILITIES
Single-purpose helper classes 
(spacing, typography, layout).
=============================== */

/* Containers */
.container {
  width: 100%;
  max-width: var(--container-max);
  margin-inline: auto;
  padding-inline: var(--container-pad);
}

/* Section rhythm */
.section {
  padding-block: var(--spacing-lg);
}

.section--tight {
  padding-block: var(--spacing-md);
}

.section--xl {
  padding-block: var(--spacing-xl);
}

.section--xxl {
  padding-block: calc(var(--spacing-xl) + var(--spacing-sm));
}

/* Viewport Height Modifiers */
.vh-100 {
  --section-vh: 100vh;
}

.vh-90 {
  --section-vh: 90vh;
}

.vh-80 {
  --section-vh: 80vh;
}

.vh-70 {
  --section-vh: 70vh;
}

.vh-60 {
  --section-vh: 60vh;
}

.vh-50 {
  --section-vh: 50vh;
}

.vh-40 {
  --section-vh: 40vh;
}

.section--viewport {
  min-height: var(--section-vh, 100vh);
  display: flex;
  align-items: center;
  padding-block: var(--spacing-xl);
}

/* Stack (vertical spacing) */
.stack {
  display: grid;
  gap: var(--stack-gap, var(--spacing-md));
}

.stack--sm {
  --stack-gap: var(--spacing-sm);
}

.stack--md {
  --stack-gap: var(--spacing-md);
}

.stack--lg {
  --stack-gap: var(--spacing-lg);
}

.stack-prose>* {
  margin-block: 0;
}

/* Flexbox */
.flex {
  display: flex;
}

.items-center {
  align-items: center;
}

.justify-center {
  justify-content: center;
}

.flex-wrap {
  flex-wrap: wrap;
}

.flex-basis-300 {
  flex-basis: 300px;
  flex-grow: 0;
  flex-shrink: 0;
}

.items-start {
  align-items: start;
}


/* Grid */
.grid {
  display: grid;
}

.grid-cols-autofit {
  grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
}

.grid-cols-2 {
  grid-template-columns: repeat(2, 1fr);
}

.grid-cols-3 {
  grid-template-columns: repeat(3, 1fr);
}

.grid-cols-4 {
  grid-template-columns: repeat(4, 1fr);
}

.gap-sm {
  gap: var(--spacing-sm);
}

.gap-md {
  gap: var(--spacing-md);
}

.gap-lg {
  gap: var(--spacing-lg);
}

/* Display */
.hidden {
  display: none;
}

/* Typography */
.text-secondary {
  color: var(--color-text-secondary);
}

.font-regular {
  font-weight: var(--weight-regular);
}

.font-sm {
  font-size: var(--font-size-sm);
}

.font-hero {
  font-size: clamp(var(--font-size-2xl), 5vw, calc(var(--font-size-2xl) * 1.5));
}

.font-section-title {
  font-size: clamp(var(--font-size-xl), 3.5vw, var(--font-size-2xl));
}

.text-left {
  text-align: left;
}

.text-center {
  text-align: center;
}

.text-right {
  text-align: right;
}

.text-wrapper {
  max-width: 65ch;
}

.text-wrapper-tight {
  max-width: 52ch;
}

.text-wrapper-hero {
  max-width: 26ch;
}

/* Background Colors */
.bg-primary {
  background-color: var(--color-bg-primary);
}

.bg-secondary {
  background-color: var(--color-bg-secondary);
}

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

/* Spacing (margins) */
.m-0 {
  margin: 0;
}

.mb-0 {
  margin-bottom: 0;
}

.mt-0 {
  margin-top: 0;
}

/* Spacing (padding block/inline) */
.py-xs {
  padding-block: var(--spacing-xs);
}

.py-sm {
  padding-block: var(--spacing-sm);
}

.py-md {
  padding-block: var(--spacing-md);
}

.py-lg {
  padding-block: var(--spacing-lg);
}

.py-xl {
  padding-block: var(--spacing-xl);
}

.px-xs {
  padding-inline: var(--spacing-xs);
}

.px-sm {
  padding-inline: var(--spacing-sm);
}

.px-md {
  padding-inline: var(--spacing-md);
}

.px-lg {
  padding-inline: var(--spacing-lg);
}

.px-xl {
  padding-inline: var(--spacing-xl);
}

/* Spacing (padding sides) */
.pt-sm {
  padding-top: var(--spacing-sm);
}

.pt-md {
  padding-top: var(--spacing-md);
}

.pt-lg {
  padding-top: var(--spacing-lg);
}

.pb-sm {
  padding-bottom: var(--spacing-sm);
}

.pb-md {
  padding-bottom: var(--spacing-md);
}

/* Center any block-level element horizontally */
.mx-auto {
  margin-left: auto;
  margin-right: auto;
}

/* Effects, Borders & Lists */
.list-unstyled {
  list-style: none;
  padding-left: 0;
  margin: 0;
}

.shadow-sm {
  box-shadow: var(--shadow-sm);
}

.shadow-md {
  box-shadow: var(--shadow-md);
}

.img-rounded {
  border-radius: var(--border-radius-img);
}

.rounded-base {
  border-radius: var(--border-radius-base);
}

/* Body States */
.no-scroll {
  overflow: hidden;
}

/* Text Variants */
.text-muted {
  color: var(--color-text-secondary);
  opacity: 0.8;
}

.text-balance {
  text-wrap: balance;
}


/* Animation Utilities */

/* 1. The Base Reveal State */
.reveal {
  opacity: 0;
  visibility: hidden;
  transition:
    /* Add the delay variable to both properties */
    opacity var(--anim-duration-default) var(--anim-easing-default) var(--anim-delay, 0s),
    transform var(--anim-duration-default) var(--anim-easing-default) var(--anim-delay, 0s);
}

/* 2. Animation Variations (Define "Before" states first) */
.reveal.slide-in-up {
  transform: translateY(var(--anim-translate-distance));
}

.reveal.slide-in-left {
  transform: translateX(calc(var(--anim-translate-distance) * -1));
}

.reveal.slide-in-right {
  transform: translateX(var(--anim-translate-distance));
}

/* Animation Delays */
.delay-1 {
  --anim-delay: 100ms;
}

.delay-2 {
  --anim-delay: 200ms;
}

.delay-3 {
  --anim-delay: 300ms;
}

.delay-4 {
  --anim-delay: 400ms;
}

.delay-5 {
  --anim-delay: 500ms;
}

/* 3. The "Active" State (Define "After" state last) */
.reveal.is-revealed {
  opacity: 1;
  visibility: visible;
  transform: none;
}


/* ===============================
RESPONSIVE UTILITIES
(breakpoint: 768px)
NOTE: CSS custom properties cannot be used in @media queries,
so we use static values here. Keep in sync with --bp-md in _theme.css.
=============================== */

@media (max-width: 767px) {

  /* Hides elements on small screens (mobile) */
  .hidden-below-md {
    display: none;
  }

  /* Shows hamburger on small screens */
  .mobile-menu-toggle {
    display: flex;
  }
}

@media (min-width: 768px) {

  /* Hides elements on large screens (desktop) */
  .hidden-md {
    display: none;
  }

  /* Responsive grid template */
  .grid-cols-md-3-1 {
    grid-template-columns: 3fr 1fr;
  }

  /* New responsive positioning */
  .md-sticky {
    position: sticky;
  }

  /* Responsive Grid Columns */
  .grid-cols-md-2 {
    grid-template-columns: repeat(2, 1fr);
  }

  .grid-cols-md-3 {
    grid-template-columns: repeat(3, 1fr);
  }

  .grid-cols-md-4 {
    grid-template-columns: repeat(4, 1fr);
  }
}