/* ==========================================================================
   LAYOUT UTILITIES — Containers, Sections, Grids, Flex, and Alignment
   ========================================================================== */

/* --------------------------------------------------------------------------
   1. Containers
   -------------------------------------------------------------------------- */

.container {
  width: 100%;
  max-width: var(--container-max);
  margin-inline: auto;
  padding-inline: var(--section-px);
}

.container-md {
  max-width: var(--container-md);
}

.container-sm {
  max-width: var(--container-sm);
}

/* --------------------------------------------------------------------------
   2. Sections
   -------------------------------------------------------------------------- */

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

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

.section-dark {
  background-color: var(--color-bg-dark);
  color: var(--color-white);
}

.section-dark h1,
.section-dark h2,
.section-dark h3,
.section-dark h4,
.section-dark h5,
.section-dark h6 {
  color: var(--color-white);
}

.section-dark p {
  color: var(--color-text-light);
}

.section-navy {
  background-color: var(--color-navy);
  color: var(--color-white);
}

.section-navy h1,
.section-navy h2,
.section-navy h3,
.section-navy h4,
.section-navy h5,
.section-navy h6 {
  color: var(--color-white);
}

.section-navy p {
  color: var(--color-text-light);
}

/* --------------------------------------------------------------------------
   3. CSS Grid Utilities
   -------------------------------------------------------------------------- */

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

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

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

/* Grid — alignment helpers */
.grid-center {
  align-items: center;
}

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

.grid-stretch {
  align-items: stretch;
}

/* --------------------------------------------------------------------------
   4. Flexbox Utilities
   -------------------------------------------------------------------------- */

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

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

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

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

.flex-col {
  display: flex;
  flex-direction: column;
}

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

.flex-gap-sm {
  gap: var(--space-2);
}

.flex-gap {
  gap: var(--space-4);
}

.flex-gap-md {
  gap: var(--space-6);
}

.flex-gap-lg {
  gap: var(--space-8);
}

/* --------------------------------------------------------------------------
   5. Text Alignment
   -------------------------------------------------------------------------- */

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

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

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

/* --------------------------------------------------------------------------
   6. Display Utilities
   -------------------------------------------------------------------------- */

.d-none {
  display: none;
}

.d-block {
  display: block;
}

.d-inline-block {
  display: inline-block;
}

/* --------------------------------------------------------------------------
   7. Width & Sizing
   -------------------------------------------------------------------------- */

.w-full {
  width: 100%;
}

.mx-auto {
  margin-inline: auto;
}

/* --------------------------------------------------------------------------
   8. Spacing Helpers
   -------------------------------------------------------------------------- */

.mt-section {
  margin-top: var(--section-py);
}

.mb-section {
  margin-bottom: var(--section-py);
}

/* --------------------------------------------------------------------------
   9. Responsive Breakpoints
   -------------------------------------------------------------------------- */

/* ── Tablet (< 1024px) ──────────────────────────────────────────────────── */
@media (max-width: 1024px) {
  .grid-4 {
    grid-template-columns: repeat(2, 1fr);
  }

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

/* ── Mobile (< 768px) ───────────────────────────────────────────────────── */
@media (max-width: 768px) {
  .grid-2,
  .grid-3,
  .grid-4 {
    grid-template-columns: 1fr;
  }

  .flex-between {
    flex-wrap: wrap;
    gap: var(--space-4);
  }

  /* Stack flex rows on mobile unless they explicitly opt out */
  .flex-col-mobile {
    flex-direction: column;
    align-items: stretch;
  }

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

  .d-none-mobile {
    display: none;
  }

  .d-block-mobile {
    display: block;
  }
}

/* ── Desktop-only visibility ────────────────────────────────────────────── */
@media (min-width: 1025px) {
  .d-none-desktop {
    display: none;
  }
}