/* layout.css — layout primitives, typography rhythm */

/* Vertical spacing between page sections */
.section {
  margin-block: var(--space-6);
  margin-inline: 0;
  padding-block: var(--space-6);
}

/* Optional alternate section background (full viewport width) */
.section--alt {
  background: var(--bg-section);
  width: 100vw;
  margin-inline: calc(-50vw + 50%);
  padding-inline: max(var(--space-4), calc((100vw - var(--container-max)) / 2 + var(--space-4)));
}

/* Vertical flow with consistent gap */
.stack {
  display: flex;
  flex-direction: column;
  gap: var(--space-4);
}

.stack--1 { gap: var(--space-1); }
.stack--2 { gap: var(--space-2); }
.stack--3 { gap: var(--space-3); }
.stack--5 { gap: var(--space-5); }
.stack--6 { gap: var(--space-6); }
.stack--8 { gap: var(--space-8); }

/* Readable line length utility */
.measure {
  max-width: 68ch;
}

/* Responsive grid: 1 col default, 2 col from breakpoint */
.grid {
  display: grid;
  gap: var(--space-4);
  grid-template-columns: 1fr;
}

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

/* Horizontal grouping with wrap (e.g. nav/footer groups) */
.cluster {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-4);
}

/* Hero layout (spacing only) */
.hero .stack {
  gap: var(--space-4);
}

.hero p {
  max-width: var(--measure);
}

.hero ul {
  max-width: var(--measure);
}

.hero .cluster {
  gap: var(--space-3);
}

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

.hero .demo-frame {
  margin-top: var(--space-5);
}

/* Heading spacing rhythm */
h1 {
  margin: 0 0 var(--space-3);
}

h2 {
  margin: 0 0 var(--space-3);
}

h3 {
  margin: 0 0 var(--space-2);
}

.section h1,
.section h2,
.section h3 {
  margin-bottom: var(--space-2);
}

/* Section intro readability */
main h2,
main h3 {
  max-width: var(--measure);
}

main h2 + p,
main h3 + p {
  margin-top: calc(var(--space-3) * -1);
}

/* Paragraph spacing */
p {
  margin: 0 0 var(--space-3);
}

p:last-child {
  margin-bottom: 0;
}

/* List readability */
ul, ol {
  margin: 0 0 var(--space-3);
  padding-left: 1.2em;
}

li + li {
  margin-top: var(--space-2);
}

/* Panel internal rhythm */
.panel > *:first-child {
  margin-top: 0;
}

.panel > *:last-child {
  margin-bottom: 0;
}

/* Article spacing (scoped to main) */
main article h3 {
  margin-bottom: var(--space-2);
}

main article p {
  margin-bottom: var(--space-3);
}

main article p:last-child {
  margin-bottom: 0;
}

/* Compact lists inside panels */
.panel ul,
.panel ol {
  margin-bottom: 0;
}