/* Header user guide (headernotes.com/guide). Ported from the parked full site's visual guide and
   restyled in this site's Clay palette. No scripts: chapters are separate pages; the chapter list
   is a sidebar on wide screens and a native disclosure on narrow ones. Colours the guide needs on
   top of styles.css are scoped to .gd, so the rest of the site is untouched. */
.gd {
  --muted: var(--ink-soft);
  --faint: #8F8278;
  --border: var(--line);
  --border-strong: #D3C6BB;
  --bg-2: var(--surface);
  --surface-2: #FDFBF9;
  --card: var(--paper);
  --teal: #4F7A2A; --teal-soft: #EEF6E3;
  --amber: #A4651A; --amber-soft: #FBF0DC;
  --rose: #B4405F; --rose-soft: #FBE8EE;
  --shadow: 0 1px 2px rgba(41,33,29,.05), 0 6px 20px rgba(41,33,29,.06);
  max-width: 1180px; margin: 0 auto; padding: 0 24px;
  display: grid; grid-template-columns: 250px minmax(0, 1fr); gap: 56px;
}
@media (prefers-color-scheme: dark) {
  .gd {
    --faint: #85786F;
    --border-strong: #4A423C;
    --surface-2: #26211E;
    --card: var(--surface);
    --teal: #A3CB6E; --teal-soft: #232B1A;
    --amber: #E0B15A; --amber-soft: #2D2416;
    --rose: #EF8AA6; --rose-soft: #2E1A21;
    --shadow: 0 1px 2px rgba(0,0,0,.35), 0 8px 24px rgba(0,0,0,.28);
  }
}

/* Chapter list */
.gd-nav { position: sticky; top: 0; align-self: start; max-height: 100vh; overflow-y: auto; padding: 56px 4px 40px 0; }
.gd-nav-title { font-size: 12px; font-weight: 700; letter-spacing: .08em; text-transform: uppercase; color: var(--faint); margin: 0 0 10px 10px; }
.gd-nav ol, .gd-nav-mobile ol { list-style: none; margin: 0; padding: 0; }
.gd-nav a { display: block; padding: 7px 10px; border-radius: 8px; color: var(--ink-soft); text-decoration: none; font-size: 14px; line-height: 1.35; }
.gd-nav a:hover { background: var(--surface); color: var(--ink); }
.gd-nav a[aria-current="page"] { background: var(--accent-soft); color: var(--accent); font-weight: 600; }
.gd-nav-mobile { display: none; }
.gd-nav-group + .gd-nav-group { margin-top: 14px; }
.gd-nav-group-label { font-size: 11.5px; font-weight: 700; letter-spacing: .07em; text-transform: uppercase; color: var(--faint); margin: 0 0 4px 10px; }
.gd-nav-mobile .gd-nav-group-label { margin: 10px 0 2px; }

/* On this page: the chapter's feature cards, after the lede. */
.gd .gd-toc { margin: 18px 0 8px; padding: 14px 18px 12px; border: 1px solid var(--border); border-radius: 12px; background: var(--surface-2); }
.gd .gd-toc-title { font-size: 12px; font-weight: 700; letter-spacing: .07em; text-transform: uppercase; color: var(--faint); margin: 0 0 8px; }
.gd .gd-toc ol { list-style: none; margin: 0; padding: 0; columns: 2; column-gap: 28px; }
.gd .gd-toc li { break-inside: avoid; margin: 0 0 6px; font-size: 15px; line-height: 1.35; }
.gd .gd-toc a { color: var(--ink-soft); text-decoration: none; }
.gd .gd-toc a:hover { color: var(--accent); text-decoration: underline; }

.gd-content { min-width: 0; max-width: 820px; padding: 48px 0 24px; }
.gd-content p { margin: 0 0 1em; }
.gd-content h2, .gd-content h3, .gd-content h4 { line-height: 1.2; letter-spacing: -.015em; color: var(--ink); margin: 0; }
.gd-content code { font: .86em ui-monospace, "SF Mono", Menlo, monospace; background: var(--surface); border: 1px solid var(--border); border-radius: 6px; padding: .1em .4em; }

/* Sections */
.gd section.block { padding: 0 0 8px; scroll-margin-top: 16px; }
.gd section.block + section.block { margin-top: 40px; padding-top: 32px; border-top: 1px solid var(--border); }
.gd .kicker { display: inline-flex; align-items: center; gap: 8px; font: 700 12px ui-monospace, "SF Mono", Menlo, monospace; letter-spacing: .08em; text-transform: uppercase; color: var(--accent); }
.gd .kicker .dot { width: 7px; height: 7px; border-radius: 2px; background: var(--accent); }
.gd h2.section-title { font: 700 34px/1.15 var(--display); margin: 12px 0 10px; text-align: left; }
.gd .section-lede { font-size: 19px; color: var(--ink-soft); max-width: 44em; margin-bottom: 12px; }
.gd .g-h3 { font-size: 19px; margin: 26px 0 8px; }

/* Feature cards */
.gd .feature { background: var(--card); border: 1px solid var(--border); border-radius: 14px; padding: 22px 24px; margin: 20px 0; box-shadow: var(--shadow); scroll-margin-top: 16px; }
.gd .feature.hot { border-color: color-mix(in srgb, var(--accent) 38%, var(--border)); }
.gd .feature-head { display: flex; align-items: flex-start; gap: 14px; margin-bottom: 8px; }
.gd .glyph { flex: 0 0 auto; width: 42px; height: 42px; border-radius: 11px; display: grid; place-items: center; background: var(--accent-soft); color: var(--accent); }
.gd .glyph.teal { background: var(--teal-soft); color: var(--teal); }
.gd .glyph.amber { background: var(--amber-soft); color: var(--amber); }
.gd .glyph.rose { background: var(--rose-soft); color: var(--rose); }
.gd .glyph.trust { background: var(--teal-soft); color: var(--teal); }
.gd .feature h3 { font-size: 21px; display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
.gd .tag { font-size: 11px; font-weight: 700; letter-spacing: .04em; text-transform: uppercase; padding: 3px 9px; border-radius: 999px; background: var(--surface); color: var(--muted); border: 1px solid var(--border); }
.gd .tag.ai { background: var(--accent-soft); color: var(--accent); border-color: transparent; }
.gd .tag.trust { background: var(--teal-soft); color: var(--teal); border-color: transparent; }
.gd .feature .role { color: var(--muted); font-size: 14px; margin-top: 2px; }
.gd .feature p { font-size: 16px; color: var(--ink-soft); }
.gd .feature strong { color: var(--ink); }
.gd .why { display: flex; gap: 10px; align-items: flex-start; color: var(--ink-soft); font-size: 15.5px; margin: .4em 0; }
.gd .why svg { flex: 0 0 auto; margin-top: 3px; color: var(--accent); }
.gd .try { background: var(--surface-2); border: 1px dashed var(--border-strong); border-left: 3px solid var(--teal); border-radius: 12px; padding: 14px 16px; margin: 16px 0; font-size: 15.5px; }
.gd .try .lbl { display: inline-flex; align-items: center; gap: 7px; font-weight: 700; color: var(--teal); font-size: 13px; text-transform: uppercase; letter-spacing: .05em; margin-bottom: 6px; }
.gd .where { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 14px; align-items: center; }
.gd .where .lbl { font-size: 12.5px; color: var(--faint); font-weight: 600; text-transform: uppercase; letter-spacing: .06em; margin-right: 2px; }
.gd kbd { font: 600 12.5px var(--sans); background: var(--card); border: 1px solid var(--border-strong); border-bottom-width: 2px; border-radius: 7px; padding: 3px 8px; color: var(--ink-soft); }
.gd .path { font-size: 13px; background: var(--surface); border: 1px solid var(--border); border-radius: 7px; padding: 3px 9px; color: var(--ink-soft); }

/* Callouts */
.gd .note { display: flex; gap: 13px; padding: 15px 18px; border-radius: 12px; margin: 18px 0; font-size: 15.5px; border: 1px solid var(--border); }
.gd .note svg { flex: 0 0 auto; margin-top: 2px; color: var(--accent); }
.gd .note.tip { background: var(--teal-soft); border-color: transparent; }
.gd .note.tip svg { color: var(--teal); }
.gd .note.warn { background: var(--amber-soft); border-color: transparent; }
.gd .note.warn svg { color: var(--amber); }
.gd .note.info { background: var(--accent-soft); border-color: transparent; }
.gd .note b { color: var(--ink); }

/* Grids, mini cards, pills */
.gd .cols-2 { display: grid; grid-template-columns: 1fr 1fr; gap: 18px; margin: 18px 0; }
.gd .cols-3 { display: grid; grid-template-columns: 1fr 1fr 1fr; gap: 18px; margin: 18px 0; }
.gd .mini { background: var(--card); border: 1px solid var(--border); border-radius: 12px; padding: 16px 18px; box-shadow: var(--shadow); }
.gd .mini h4 { font-size: 16px; margin-bottom: 6px; display: flex; align-items: center; gap: 8px; }
.gd .mini p { font-size: 14.5px; color: var(--muted); margin: 0; }
.gd .pills { display: flex; flex-wrap: wrap; gap: 8px; margin: 12px 0; }
.gd .pill { font-size: 13.5px; background: var(--card); border: 1px solid var(--border); border-radius: 999px; padding: 6px 13px; color: var(--ink-soft); }
.gd .pill b { color: var(--accent); }

/* Figures and tables */
.gd figure { margin: 18px 0; background: var(--surface-2); border: 1px solid var(--border); border-radius: 16px; padding: 16px; }
.gd figure svg { display: block; width: 100%; height: auto; border-radius: 10px; }
.gd figure svg.fig-narrow { max-width: 520px; margin: 0 auto; }
.gd figcaption { margin-top: 10px; font-size: 13.5px; color: var(--muted); text-align: center; }
.gd table { width: 100%; border-collapse: collapse; margin: 14px 0; font-size: 15px; background: var(--card); border: 1px solid var(--border); border-radius: 12px; overflow: hidden; }
.gd th, .gd td { text-align: left; vertical-align: top; padding: 10px 14px; border-bottom: 1px solid var(--border); }
.gd th { background: var(--surface); font-size: 12.5px; text-transform: uppercase; letter-spacing: .05em; color: var(--muted); }
.gd tr:last-child td { border-bottom: 0; }
.gd td kbd { white-space: nowrap; }

/* Small spacing helpers (replace the old inline styles) */
.gd .mt-6 { margin-top: 6px; } .gd .mt-8 { margin-top: 8px; } .gd .mt-10 { margin-top: 10px; }
.gd .mt-18 { margin-top: 18px; } .gd .mt-22 { margin-top: 22px; } .gd .mb-8 { margin-bottom: 8px; }
.gd .g-list { margin: 0 0 10px 18px; }
.gd .g-list-soft { margin: 6px 0 0; padding-left: 20px; color: var(--ink-soft); }
.gd .g-fine { color: var(--muted); font-size: 14px; margin-top: 10px; }

/* Previous / next */
.gd-pager { display: flex; justify-content: space-between; gap: 20px; margin-top: 48px; padding-top: 22px; border-top: 1px solid var(--border); font-weight: 600; }
.gd-pager a { text-decoration: none; }

@media (max-width: 960px) {
  .gd { display: block; padding: 0 24px; }
  .gd-nav { display: none; }
  .gd-content { margin: 0 auto; padding-top: 24px; }
  .gd-nav-mobile { display: block; margin: 0 0 28px; border: 1px solid var(--border); border-radius: 12px; padding: 0 16px; }
  .gd-nav-mobile summary { padding: 12px 0; min-height: 44px; cursor: pointer; font-weight: 600; color: var(--accent); }
  .gd-nav-mobile[open] summary { border-bottom: 1px solid var(--border); margin-bottom: 6px; }
  .gd-nav-mobile a { display: block; padding: 7px 0; color: var(--ink); text-decoration: none; }
  .gd-nav-mobile a[aria-current="page"] { color: var(--accent); font-weight: 600; }
  .gd-nav-mobile ol { padding-bottom: 8px; }
  .gd .cols-2, .gd .cols-3 { grid-template-columns: 1fr; }
  .gd .gd-toc ol { columns: 1; }
}
@media (max-width: 620px) {
  .gd { padding: 0 16px; }
  .gd h2.section-title { font-size: 28px; }
  .gd .feature { padding: 18px; }
  .gd-pager { flex-direction: column; }
}

/* ---- Calmer, more neutral reading (2026-10-23 review) -------------------------------------
   Neutral near-black headings and a neutral grey body instead of the warm brown-grey; flat
   hairline cards instead of shadowed ones; one neutral surface for tips, exercises and the page
   list, so colour is left to links, the active chapter and warnings. */
.gd {
  --g-head: #272522;
  --g-body: #4D4B50;
  --g-muted: #6E6C72;
  --g-surface: #F7F6F4;
}
@media (prefers-color-scheme: dark) {
  .gd { --g-head: #EDEBE8; --g-body: #C3C0BB; --g-muted: #9C988F; --g-surface: #211F1D; }
}
.gd-content { font-size: 16px; color: var(--g-body); }
.gd-content p, .gd-content li { line-height: 1.65; }
.gd-content h2, .gd-content h3, .gd-content h4 { color: var(--g-head); }
.gd h2.section-title { font-size: 38px; letter-spacing: -.02em; }
.gd .section-lede { font-size: 18px; color: var(--g-muted); line-height: 1.55; }
.gd .feature { box-shadow: none; border-color: var(--border); padding: 22px 24px 18px; }
.gd .feature.hot { border-color: var(--border); }
.gd .feature h3 { font-size: 21px; }
.gd .feature p, .gd .g-list-soft { color: var(--g-body); }
.gd .feature .role { color: var(--g-muted); }
.gd .glyph { width: 36px; height: 36px; border-radius: 9px; }
.gd .note.tip, .gd .note.info { background: var(--g-surface); border: 1px solid var(--border); }
.gd .note.tip svg { color: var(--teal); }
.gd .try { background: var(--g-surface); border: 1px solid var(--border); border-left: 3px solid var(--teal); }
.gd .mini { box-shadow: none; }
.gd figure { background: var(--g-surface); }
.gd .gd-toc { background: var(--g-surface); }
.gd-nav a { color: var(--g-muted); }
.gd-nav a:hover { color: var(--g-head); }

/* Sticky "On this page" column on wide screens; the inline copy after the lede is for narrower
   screens. Both are generated by scripts/guide_nav.py. No script: the list does not highlight the
   section you are reading. */
.gd-toc-side { display: none; }
@media (min-width: 1280px) {
  .gd { max-width: 1400px; grid-template-columns: 240px minmax(0, 1fr) 220px; gap: 48px; }
  .gd-content { max-width: 800px; }
  .gd .gd-toc { display: none; }
  .gd-toc-side {
    display: block; position: sticky; top: 0; align-self: start; max-height: 100vh; overflow-y: auto;
    padding: 56px 0 40px; font-size: 13.5px;
  }
  .gd-toc-side .gd-toc-title { font-size: 11.5px; font-weight: 700; letter-spacing: .07em; text-transform: uppercase; color: var(--faint); margin: 0 0 10px; }
  .gd-toc-side ol { list-style: none; margin: 0; padding: 0 0 0 12px; border-left: 1px solid var(--border); }
  .gd-toc-side li { margin: 0 0 8px; line-height: 1.35; }
  .gd-toc-side a { color: var(--g-muted); text-decoration: none; }
  .gd-toc-side a:hover { color: var(--accent); }
  .gd-toc-side li { position: relative; }
  .gd-toc-side a.is-current { color: var(--g-head); font-weight: 600; }
  .gd-toc-side a.is-current::before { content: ""; position: absolute; left: -13px; top: 1px; bottom: 1px; width: 3px; border-radius: 2px; background: var(--accent); }
}

/* Guide search: a plain GET form answered by the worker at /guide/search. */
.gd-search { position: relative; margin: 0 0 18px; }
.gd-search input {
  width: 100%; box-sizing: border-box; font: 14px var(--sans); color: var(--g-head);
  padding: 8px 44px 8px 12px; border: 1px solid var(--border); border-radius: 9px; background: var(--card);
}
.gd-search input::placeholder { color: var(--faint); }
.gd-search input:focus { outline: 2px solid color-mix(in srgb, var(--accent) 45%, transparent); outline-offset: 1px; border-color: var(--accent); }
.gd-search-key { position: absolute; right: 8px; top: 50%; transform: translateY(-50%); font-size: 11px; padding: 1px 6px; pointer-events: none; }
.gd-search input:not(:placeholder-shown) + .gd-search-key { display: none; }
.gd-search input:not(:placeholder-shown) { padding-right: 12px; }
.gd-search-mobile { display: none; }
.gd-results { list-style: none; margin: 22px 0 0; padding: 0; }
.gd-result { padding: 14px 0; border-top: 1px solid var(--border); }
.gd-result a { text-decoration: none; display: flex; flex-wrap: wrap; align-items: baseline; gap: 4px 12px; }
.gd-result-title { font-size: 18px; font-weight: 650; color: var(--accent); }
.gd-result a:hover .gd-result-title { text-decoration: underline; }
.gd-result-chapter { font-size: 13px; color: var(--g-muted); }
.gd-result-snippet { margin: 6px 0 0; font-size: 15px; color: var(--g-body); }
.gd-result-snippet mark { background: var(--accent-soft); color: var(--g-head); border-radius: 2px; }
@media (max-width: 960px) {
  .gd-search-mobile { display: block; margin: 0 0 12px; }
  .gd-search-mobile input { padding-right: 12px; font-size: 16px; }
}