/*
  Heartwood Health Network · How-to docs · shared stylesheet
  Used by:
   - how-to-build.html              (index)
   - how-to-{component}.html        (9 per-chart pages)
*/

:root {
  /* Forest Green (primary) - earth, evergreen, stable */
  --primary:    #2D4A36;
  --primary-2:  #3F6B4F;
  --primary-3:  #6B8A78;
  /* Clay/Terracotta (secondary) - warmth */
  --secondary:  #C8633B;
  --secondary-2:#A24E2D;
  /* Amber/Honey (tertiary) - wellness */
  --tertiary:   #C8964B;
  --tertiary-2: #966D2C;
  /* Walnut ink */
  --ink:        #2A201A;
  --ink-3:      #1A130E;
  /* Cream surfaces */
  --bg:         #ffffff;
  --bg-soft:    #faf6ef;
  --bg-code:    #f3ede0;
  --border:     #e5dbc9;
  --border-2:   #d0c2a8;
  --muted:      #6e5e4a;
  --muted-2:    #8e7e6a;

  --font-display: 'Source Serif 4', 'Source Serif Pro', Georgia, serif;
  --font-body:    'DM Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
  --font-mono:    'JetBrains Mono', monaco, consolas, monospace;
}

* { margin: 0; padding: 0; box-sizing: border-box; }
html, body {
  background: var(--bg-soft);
  color: var(--ink);
  font-family: var(--font-body);
  -webkit-font-smoothing: antialiased;
  line-height: 1.6;
}
body { padding: 48px 32px 96px; }

a { color: var(--primary); text-decoration: none; }
a:hover { text-decoration: underline; }

/* ============================================================
   PAGE HEAD
   ============================================================ */
.page-head {
  max-width: 1080px; margin: 0 auto 28px;
  display: grid; grid-template-columns: auto 1fr auto;
  gap: 24px; padding-bottom: 22px;
  border-bottom: 1px solid var(--border);
  align-items: end;
}
.lockup { display: flex; align-items: center; gap: 14px; }
.lockup .mark { width: 44px; color: var(--primary); flex-shrink: 0; }
.lockup .mark svg { width: 100%; height: auto; display: block; }
.lockup-text .label {
  font-family: var(--font-mono);
  font-size: 10.5px; letter-spacing: 0.18em;
  text-transform: uppercase; color: var(--primary);
  margin-bottom: 4px;
}
.lockup-text h1 {
  font-family: var(--font-display);
  font-weight: 500;
  font-size: clamp(1.6rem, 2.6vw, 2.25rem);
  letter-spacing: -0.005em;
  color: var(--ink-3);
  line-height: 1.1;
}
.page-head .meta {
  text-align: right;
  font-family: var(--font-mono);
  font-size: 9.5px; letter-spacing: 0.16em;
  text-transform: uppercase; color: var(--muted);
  line-height: 1.7;
}
.page-head .meta a { color: var(--muted); }
.page-head .meta a:hover { color: var(--primary); }

/* ============================================================
   INDEX PAGE — intro + TOC
   ============================================================ */
.intro {
  max-width: 1080px; margin: 0 auto 36px;
  display: grid; grid-template-columns: 1.4fr 1fr; gap: 36px;
}
.intro p {
  font-size: 15px; line-height: 1.7; color: var(--ink);
  margin-bottom: 12px;
}
.intro p .key {
  font-family: var(--font-mono); font-size: 13px;
  background: var(--bg); padding: 1px 6px; border-radius: 3px;
  border: 1px solid var(--border);
}

.toc {
  background: var(--bg);
  border: 1px solid var(--border);
  border-top: 3px solid var(--primary);
  border-radius: 6px;
  padding: 16px 18px;
}
.toc-label {
  font-family: var(--font-mono);
  font-size: 9.5px; letter-spacing: 0.2em;
  text-transform: uppercase; color: var(--primary);
  margin-bottom: 10px;
}
.toc ol { list-style: none; counter-reset: toc; }
.toc li {
  counter-increment: toc;
  padding: 5px 0;
  border-bottom: 1px dotted var(--border);
  display: flex; gap: 14px; align-items: baseline;
  font-size: 13px;
}
.toc li:last-child { border-bottom: none; }
.toc li::before {
  content: counter(toc, decimal-leading-zero);
  font-family: var(--font-mono);
  font-size: 10px; letter-spacing: 0.1em;
  color: var(--muted-2);
  flex-shrink: 0;
}
.toc li a { color: var(--ink-3); }
.toc li a:hover { color: var(--primary); }
.toc li .desc {
  color: var(--muted); font-size: 11.5px;
  margin-left: auto; text-align: right;
}

@media (max-width: 880px) {
  .intro { grid-template-columns: 1fr; }
}

/* ============================================================
   HOWTO SECTION (used on per-chart pages)
   ============================================================ */
.howto {
  max-width: 1080px; margin: 0 auto 32px;
  background: var(--bg);
  border: 1px solid var(--border);
  border-top: 3px solid var(--accent, var(--primary));
  border-radius: 6px;
  padding: 28px 32px 32px;
  scroll-margin-top: 24px;
}

.howto-head {
  display: flex; align-items: flex-start; gap: 18px;
  padding-bottom: 18px;
  border-bottom: 1px solid var(--border);
  margin-bottom: 22px;
}
.howto-num {
  font-family: var(--font-mono);
  font-size: 11px; letter-spacing: 0.2em;
  color: var(--accent, var(--primary));
  background: var(--bg-soft);
  border: 1px solid var(--border);
  padding: 8px 10px; border-radius: 4px;
  line-height: 1; flex-shrink: 0;
  font-weight: 600;
  min-width: 56px; text-align: center;
}
.howto-head-text { flex: 1; }
.howto-label {
  font-family: var(--font-mono);
  font-size: 10.5px; letter-spacing: 0.2em;
  text-transform: uppercase; color: var(--accent, var(--primary));
  margin-bottom: 4px;
  font-weight: 500;
}
.howto-title {
  font-family: var(--font-display);
  font-size: 22px; font-weight: 500;
  color: var(--ink-3); line-height: 1.2;
  letter-spacing: -0.005em;
}
.howto-lede {
  font-size: 14px; color: var(--muted); line-height: 1.65;
  margin-top: 10px; max-width: 64ch;
}

.howto-body {
  display: grid; grid-template-columns: 1fr 1fr; gap: 28px;
}
@media (max-width: 880px) {
  .howto-body { grid-template-columns: 1fr; }
}

.block { margin-bottom: 18px; }
.block:last-child { margin-bottom: 0; }
.block-label {
  font-family: var(--font-mono);
  font-size: 9.5px; letter-spacing: 0.18em;
  text-transform: uppercase; color: var(--ink-3);
  margin-bottom: 6px;
  font-weight: 600;
}
.block p {
  font-size: 13.5px; line-height: 1.65; color: var(--ink);
}
.block p + p { margin-top: 8px; }
.block code {
  font-family: var(--font-mono); font-size: 12px;
  background: var(--bg-code); padding: 1px 5px;
  border-radius: 3px; border: 1px solid var(--border);
  color: var(--ink-3);
}

pre.code {
  font-family: var(--font-mono);
  font-size: 11.5px;
  line-height: 1.55;
  background: var(--bg-code);
  border: 1px solid var(--border);
  border-left: 3px solid var(--accent, var(--primary));
  border-radius: 4px;
  padding: 12px 14px;
  overflow-x: auto;
  color: var(--ink);
  white-space: pre;
}
pre.code .comment { color: var(--muted); font-style: italic; }
pre.code .keyword { color: var(--secondary-2); font-weight: 500; }
pre.code .string { color: var(--tertiary-2); }
pre.code .number { color: var(--primary); }

.callout {
  margin-top: 20px;
  background: #fbf2eb;
  border: 1px solid #ecd6c2;
  border-left: 3px solid var(--secondary-2);
  border-radius: 4px;
  padding: 12px 16px;
  display: grid; grid-template-columns: auto 1fr; gap: 14px;
  align-items: flex-start;
}
.callout-icon {
  font-family: var(--font-mono);
  font-size: 11px; letter-spacing: 0.18em;
  text-transform: uppercase;
  color: var(--secondary-2);
  background: #fff;
  border: 1px solid #ecd6c2;
  padding: 5px 9px; border-radius: 3px;
  line-height: 1; flex-shrink: 0;
  font-weight: 600;
  align-self: start;
}
.callout p {
  font-size: 13px; line-height: 1.6; color: var(--ink);
}
.callout p + p { margin-top: 6px; }
.callout strong { color: var(--ink-3); font-weight: 600; }
.callout code {
  font-family: var(--font-mono); font-size: 11.5px;
  background: rgba(255,255,255,0.7); padding: 1px 5px;
  border-radius: 3px; color: var(--ink-3);
  border: 1px solid #ecd6c2;
}

/* Per-section accent colors — applied to body via data-component attr,
   so the same selector logic works across both the inline (index) and
   standalone-page contexts. */
[data-component="stat-counter"]  { --accent: var(--primary);     }
[data-component="bar-chart"]     { --accent: var(--secondary);   }
[data-component="line-chart"]    { --accent: var(--tertiary);    }
[data-component="donut"]         { --accent: var(--ink-3);       }
[data-component="slope"]         { --accent: var(--secondary-2); }
[data-component="heat-grid"]     { --accent: var(--tertiary-2);  }
[data-component="sankey"]        { --accent: var(--primary);     }
[data-component="grouped-bars"]  { --accent: var(--secondary);   }
[data-component="hbar"]          { --accent: var(--tertiary-2);  }

/* ============================================================
   PREV / NEXT NAV (per-chart pages)
   ============================================================ */
.prev-next {
  max-width: 1080px; margin: 0 auto 24px;
  display: grid; grid-template-columns: 1fr auto 1fr; gap: 16px;
  font-family: var(--font-mono);
  font-size: 10.5px; letter-spacing: 0.18em;
  text-transform: uppercase;
}
.prev-next a {
  display: block;
  background: var(--bg);
  border: 1px solid var(--border);
  border-radius: 5px;
  padding: 12px 16px;
  color: var(--ink-3);
  font-weight: 500;
  transition: border-color 0.15s, color 0.15s;
}
.prev-next a:hover {
  border-color: var(--primary);
  color: var(--primary);
  text-decoration: none;
}
.prev-next .prev { text-align: left; }
.prev-next .next { text-align: right; grid-column: 3; }
.prev-next .index {
  text-align: center; padding: 12px 16px;
  border: 1px solid var(--border);
  border-radius: 5px;
  background: var(--bg);
  color: var(--muted);
  font-weight: 500;
}
.prev-next .index:hover {
  border-color: var(--primary); color: var(--primary);
  text-decoration: none;
}
.prev-next .role {
  display: block;
  font-size: 9px; color: var(--muted);
  font-weight: 400;
  margin-bottom: 3px;
  letter-spacing: 0.22em;
}

@media (max-width: 720px) {
  .prev-next { grid-template-columns: 1fr; }
  .prev-next .next { grid-column: 1; text-align: left; }
}

/* ============================================================
   FOOTER
   ============================================================ */
.page-foot {
  max-width: 1080px; margin: 48px auto 0;
  padding-top: 24px;
  border-top: 1px solid var(--border);
  display: flex; justify-content: space-between;
  font-family: var(--font-mono);
  font-size: 10px; letter-spacing: 0.18em;
  text-transform: uppercase; color: var(--muted);
  flex-wrap: wrap; gap: 12px;
}
.page-foot a { color: var(--muted); }
.page-foot a:hover { color: var(--primary); }
