/* ============================================================
   Layout System
   ============================================================
   Container, CSS Grid, Flexbox patterns, and section spacing.
   Mobile-first responsive approach.
   ============================================================ */

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

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

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

/* ── Section ──────────────────────────────────────────────── */
.section {
  padding-block: var(--section-py);
}

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

.section--dark {
  background-color: var(--color-dark);
  color: var(--color-text-inverse);
}

.section__inner {
  padding-block: var(--space-xl);
}

/* ── Grid System ──────────────────────────────────────────── */
.grid {
  display: grid;
  gap: var(--space-xl);
}

/* Common grid patterns */
.grid-2 {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-xl);
}

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

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

/* Responsive grid upgrades */
@media (min-width: 576px) {
  .grid-2 { grid-template-columns: repeat(2, 1fr); }
  .grid-4 { grid-template-columns: repeat(2, 1fr); }
}

@media (min-width: 768px) {
  .grid-3 { grid-template-columns: repeat(2, 1fr); }
}

@media (min-width: 992px) {
  .grid-3 { grid-template-columns: repeat(3, 1fr); }
  .grid-4 { grid-template-columns: repeat(4, 1fr); }
}

/* Auto-fit responsive grid */
.grid-auto {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
  gap: var(--space-xl);
}

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

@media (min-width: 992px) {
  .grid-split {
    grid-template-columns: 1fr 1fr;
    gap: var(--space-3xl);
  }
}

.grid-split--reverse > *:first-child {
  order: 2;
}

.grid-split--reverse > *:last-child {
  order: 1;
}

@media (max-width: 991px) {
  .grid-split--reverse > *:first-child {
    order: 1;
  }
  .grid-split--reverse > *:last-child {
    order: 2;
  }
}

/* ── Flex Utilities ───────────────────────────────────────── */
.flex {
  display: flex;
}

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

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

.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: flex-start;
}

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

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

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

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

.justify-between {
  justify-content: space-between;
}

.justify-end {
  justify-content: flex-end;
}

/* ── Gap Utilities ────────────────────────────────────────── */
.gap-xs  { gap: var(--space-xs); }
.gap-sm  { gap: var(--space-sm); }
.gap-md  { gap: var(--space-md); }
.gap-lg  { gap: var(--space-lg); }
.gap-xl  { gap: var(--space-xl); }
.gap-2xl { gap: var(--space-2xl); }

/* ── Width Utilities ──────────────────────────────────────── */
.w-full { width: 100%; }

/* ── Position Utilities ───────────────────────────────────── */
.relative { position: relative; }
.absolute { position: absolute; }
.sticky   { position: sticky; }

/* ── Overflow ─────────────────────────────────────────────── */
.overflow-hidden { overflow: hidden; }

/* ── Display Utilities ────────────────────────────────────── */
.block       { display: block; }
.inline-flex { display: inline-flex; }
.hidden      { display: none; }

/* Responsive visibility */
@media (max-width: 767px) {
  .hide-mobile { display: none !important; }
}

@media (min-width: 768px) and (max-width: 991px) {
  .hide-tablet { display: none !important; }
}

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

@media (max-width: 991px) {
  .show-desktop-only { display: none !important; }
}

@media (min-width: 992px) {
  .show-mobile-only { display: none !important; }
}