/* =============================================================================
   POLAR LIGHT STUDIO — Layout
   =============================================================================
   Page structure, containers, grid, and responsive patterns.
   Assumes variables.css and base.css are loaded first.
============================================================================= */

/* ---------------------------------------------------------------------------
   Page structure
--------------------------------------------------------------------------- */

.page {
  display: flex;
  flex-direction: column;
  min-height: 100vh;
}

.page__content {
  flex: 1;
}

/* ---------------------------------------------------------------------------
   Container
--------------------------------------------------------------------------- */

.container {
  width: 100%;
  max-width: var(--container-max);
  margin-left: auto;
  margin-right: auto;
  padding-left: var(--container-padding);
  padding-right: var(--container-padding);
}

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

/* ---------------------------------------------------------------------------
   Sections
--------------------------------------------------------------------------- */

.section {
  padding-top: var(--space-16);
  padding-bottom: var(--space-16);
}

.section--sm {
  padding-top: var(--space-10);
  padding-bottom: var(--space-10);
}

.section--lg {
  padding-top: var(--space-20);
  padding-bottom: var(--space-20);
}

/* ---------------------------------------------------------------------------
   Grid system — CSS Grid based
--------------------------------------------------------------------------- */

.grid {
  display: grid;
  gap: var(--space-6);
}

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

/* Fixed column grids */
.grid--2 {
  grid-template-columns: repeat(2, 1fr);
}

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

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

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

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

/* ---------------------------------------------------------------------------
   Flexbox utilities
--------------------------------------------------------------------------- */

.flex {
  display: flex;
}

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

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

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

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

.gap-2 { gap: var(--space-2); }
.gap-3 { gap: var(--space-3); }
.gap-4 { gap: var(--space-4); }
.gap-6 { gap: var(--space-6); }
.gap-8 { gap: var(--space-8); }

/* ---------------------------------------------------------------------------
   Spacing utilities — Vertical rhythm
--------------------------------------------------------------------------- */

.stack > * + * {
  margin-top: var(--space-4);
}

.stack--sm > * + * {
  margin-top: var(--space-2);
}

.stack--lg > * + * {
  margin-top: var(--space-8);
}

/* ---------------------------------------------------------------------------
   Two-column layout — Common pattern for detail pages
--------------------------------------------------------------------------- */

.two-col {
  display: grid;
  gap: var(--space-8);
}

@media (min-width: 768px) {
  .two-col {
    grid-template-columns: 1fr 1fr;
    align-items: start;
  }
  
  .two-col--wide-right {
    grid-template-columns: 2fr 3fr;
  }
  
  .two-col--wide-left {
    grid-template-columns: 3fr 2fr;
  }
}

/* ---------------------------------------------------------------------------
   Responsive breakpoints reference:
   - Mobile: < 768px
   - Tablet: 768px - 1024px
   - Desktop: > 1024px
--------------------------------------------------------------------------- */