/* ============================================================
   Hearth Design System — Base
   Reset, page shell, typography scale, layout primitives.
   ============================================================ */

*,
*::before,
*::after {
  box-sizing: border-box;
}

html,
body {
  margin: 0;
  padding: 0;
}

html {
  scroll-behavior: smooth;
  /* anchor targets clear the sticky navbar */
  scroll-padding-top: var(--space-16);
}

/* The hidden attribute always wins, even against .stack/.grid display rules */
[hidden] {
  display: none !important;
}

body {
  background: var(--color-paper);
  color: var(--color-ink);
  font-family: var(--font-sans);
  font-size: var(--type-body-size);
  line-height: var(--leading-normal);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

a {
  color: var(--color-sky-text);
  text-decoration: none;
}

a:hover {
  color: var(--color-ink);
}

img {
  max-width: 100%;
  display: block;
}

button,
input,
textarea,
select {
  font-family: inherit;
}

:focus-visible {
  outline: none;
  box-shadow: var(--focus-ring);
}

/* ---------- Type scale ---------- */

.t-display,
.t-h1,
.t-h2,
.t-h3 {
  margin: 0;
}

.t-display {
  font-size: var(--type-display-size);
  font-weight: var(--type-display-weight);
  letter-spacing: var(--type-display-tracking);
  line-height: 1.05;
}

.t-h1 {
  font-size: var(--type-h1-size);
  font-weight: var(--type-h1-weight);
  letter-spacing: var(--type-h1-tracking);
  line-height: var(--leading-tight);
}

.t-h2 {
  font-size: var(--type-h2-size);
  font-weight: var(--type-h2-weight);
  letter-spacing: var(--type-h2-tracking);
  line-height: var(--leading-snug);
}

.t-h3 {
  font-size: var(--type-h3-size);
  font-weight: var(--type-h3-weight);
  letter-spacing: var(--type-h3-tracking);
  line-height: var(--leading-snug);
}

.t-body {
  font-size: var(--type-body-size);
  font-weight: var(--type-body-weight);
  letter-spacing: var(--type-body-tracking);
  line-height: var(--leading-normal);
}

.t-caption {
  font-size: var(--type-caption-size);
  font-weight: var(--type-caption-weight);
  letter-spacing: var(--type-caption-tracking);
}

.t-mono {
  font-family: var(--font-mono);
  font-size: 12px;
  font-weight: 400;
  color: var(--color-ink-muted);
}

.t-muted {
  color: var(--color-ink-muted);
}

.t-subtle {
  color: var(--color-ink-subtle);
}

/* Section number label — "01 — Tokens" */
.kicker {
  font-family: var(--font-mono);
  font-size: 12px;
  font-weight: 500;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--color-sky-text);
  margin-bottom: var(--space-2);
}

.kicker--marigold {
  color: var(--color-marigold-text);
}

.kicker--iris {
  color: var(--color-iris-text);
}

.kicker--meadow {
  color: var(--color-meadow-text);
}

.kicker--rose {
  color: var(--color-rose-text);
}

/* Documentation section heading (between h1 and h2 on the scale) */
.section-title {
  margin: 0;
  font-size: 32px;
  font-weight: 800;
  letter-spacing: -0.02em;
  line-height: var(--leading-snug);
}

/* ---------- Layout primitives ---------- */

.page {
  max-width: var(--container);
  margin: 0 auto;
  padding: 72px var(--space-10) 120px;
}

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

.section--major {
  padding-top: 88px;
}

.section__head {
  margin-bottom: var(--space-8);
}

.section__head .section-title {
  margin-bottom: var(--space-2);
}

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

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

.grid--2 {
  grid-template-columns: 1fr 1fr;
}

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

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

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

.row {
  display: flex;
  align-items: center;
  gap: var(--space-3);
}

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

.push {
  margin-left: auto;
}

/* Gap + margin steps, restricted to the 4px scale so nothing drifts off-grid */
.gap-1 { gap: var(--space-1); }
.gap-2 { gap: var(--space-2); }
.gap-3 { gap: var(--space-3); }
.gap-4 { gap: var(--space-4); }
.gap-5 { gap: var(--space-5); }
.gap-6 { gap: var(--space-6); }
.gap-7 { gap: var(--space-7); }
.gap-8 { gap: var(--space-8); }

.mt-2 { margin-top: var(--space-2); }
.mt-5 { margin-top: var(--space-5); }
.mt-8 { margin-top: var(--space-8); }
.mt-auto { margin-top: auto; }

.mb-4 { margin-bottom: var(--space-4); }
.mb-6 { margin-bottom: var(--space-6); }
.mb-10 { margin-bottom: var(--space-10); }

/* Supporting copy under a section title */
.section-lede {
  margin: var(--space-2) 0 var(--space-8);
  font-size: 15px;
  color: var(--color-ink-muted);
}

/* Minor heading inside a token section */
.subhead {
  margin: var(--space-6) 0 var(--space-3);
  font-size: 14px;
  font-weight: 700;
  color: var(--color-ink-muted);
}

.visually-hidden {
  position: absolute;
  width: 1px;
  height: 1px;
  margin: -1px;
  padding: 0;
  overflow: hidden;
  clip: rect(0 0 0 0);
  white-space: nowrap;
  border: 0;
}

/* ---------- Page header & footer ---------- */

.masthead {
  display: flex;
  flex-direction: column;
  gap: var(--space-5);
  padding-bottom: 56px;
  border-bottom: 1px solid var(--color-border);
}

.masthead__brand {
  display: flex;
  align-items: center;
  gap: var(--space-3);
}

.masthead__title {
  max-width: 640px;
}

.masthead__lede {
  margin: 0;
  font-size: 18px;
  line-height: var(--leading-normal);
  color: var(--color-ink-muted);
  max-width: 560px;
}

.logo {
  width: 40px;
  height: 40px;
  flex: none;
  border-radius: var(--radius-md);
  background: var(--color-sky);
  color: #fff;
  display: flex;
  align-items: center;
  justify-content: center;
  font-weight: 800;
  font-size: 20px;
}

.logo--sm {
  width: 28px;
  height: 28px;
  border-radius: 9px;
  font-size: 14px;
}

.wordmark {
  font-weight: 800;
  font-size: 18px;
  letter-spacing: -0.02em;
}

.site-footer {
  margin-top: 88px;
  padding-top: var(--space-8);
  border-top: 1px solid var(--color-border);
  display: flex;
  align-items: center;
  gap: var(--space-3);
  font-size: 13px;
  color: var(--color-ink-muted);
}

/* ---------- Responsive ---------- */

@media (max-width: 900px) {
  .grid--3,
  .grid--4 {
    grid-template-columns: repeat(2, 1fr);
  }
  .grid--6 {
    grid-template-columns: repeat(3, 1fr);
  }
}

@media (max-width: 700px) {
  .page {
    padding: 48px var(--space-6) 80px;
  }
  .t-display {
    font-size: 38px;
  }
  .section-title {
    font-size: 26px;
  }
  .grid--2,
  .grid--3,
  .grid--4 {
    grid-template-columns: 1fr;
  }
  .grid--6 {
    grid-template-columns: repeat(2, 1fr);
  }
  .site-footer {
    flex-direction: column;
    align-items: flex-start;
  }
  .site-footer .push {
    margin-left: 0;
  }
}