/* aayu tell docs --site (WP8.2): one stylesheet, no scripts, no web fonts.
   Colours are design/brand.yaml's palette; every text and control pair passes WCAG 2.2 AA there. */
:root {
  --fg: #1d2330;
  --muted: #535b6b;
  --bg: #ffffff;
  --panel: #f5f6f8;
  --line: #d9dde4;
  --accent: #1f5bd1;
  --code: #eef1f6;
  --here: #eef3fd;
  --tip: #edf7ee;
  --tip-edge: #2e7d32;
  --done: #fdf6e3;
  --done-edge: #9a6700;
  --setup: #fdf0ec;
  --setup-edge: #b4441d;
  --story: #f3f0fa;
  --story-edge: #6941c6;
  --hood: #eef1f6;
  --hood-edge: #535b6b;
  --measure: 44rem;
  color-scheme: light;
}
* { box-sizing: border-box; }
html { font-size: 100%; }
body {
  margin: 0;
  color: var(--fg);
  background: var(--bg);
  font: 1.0625rem/1.65 system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
}
a { color: var(--accent); text-underline-offset: 0.15em; }
a:hover { text-decoration-thickness: 2px; }
a:focus-visible, summary:focus-visible { outline: 3px solid var(--accent); outline-offset: 2px; }
.skip { position: absolute; left: -999px; top: 0; padding: 0.5rem 1rem; background: var(--fg); color: #fff; }
.skip:focus { left: 0.5rem; z-index: 10; }
.top {
  display: flex; flex-wrap: wrap; align-items: baseline; gap: 0.25rem 1.5rem;
  padding: 0.75rem 1.5rem; border-bottom: 1px solid var(--line); background: var(--fg);
}
.top a, .top .build { color: #ffffff; }
.top a:focus-visible { outline-color: #ffffff; }
.brand { font-weight: 700; font-size: 1.15rem; text-decoration: none; }
.build { font-size: 0.875rem; }
.layout { display: flex; align-items: flex-start; max-width: 80rem; margin: 0 auto; }

/* Sidebar on wide screens; a collapsed Menu on narrow ones. */
.menu { display: none; }
nav.side {
  flex: 0 0 16rem; position: sticky; top: 0; max-height: 100vh; overflow-y: auto;
  padding: 1rem 1rem 2rem 1.5rem; border-right: 1px solid var(--line); font-size: 0.9375rem; line-height: 1.4;
}
nav ul { list-style: none; margin: 0 0 0.75rem; padding: 0; }
nav li a { display: block; padding: 0.35rem 0.5rem; border-radius: 4px; text-decoration: none; color: var(--fg); min-height: 2rem; }
nav li a:hover { background: var(--panel); }
nav a[aria-current="page"] { background: var(--here); color: var(--accent); font-weight: 600; box-shadow: inset 3px 0 0 var(--accent); }
nav summary { cursor: pointer; padding: 0.35rem 0; font-weight: 600; color: var(--muted); }

main { flex: 1 1 auto; min-width: 0; padding: 1.75rem 2.5rem 3rem; }
main > :where(p, ul, ol, blockquote, h1, h2, h3, h4, dl) { max-width: var(--measure); }
main h1 { font-size: 2.25rem; line-height: 1.2; margin: 0.5rem 0 1rem; letter-spacing: -0.01em; }
main h2 { font-size: 1.5rem; line-height: 1.3; margin-top: 2.5rem; padding-bottom: 0.3rem; border-bottom: 1px solid var(--line); }
main h3 { font-size: 1.2rem; line-height: 1.35; margin-top: 1.75rem; }
main p, main li { margin: 0.6rem 0; }
main li > p { margin: 0.3rem 0; }
main h1 + p { font-size: 1.1875rem; line-height: 1.55; color: var(--fg); }
main img { display: block; max-width: 100%; height: auto; margin: 1.5rem auto; }
main p:has(> img:only-child) { margin: 1.5rem 0; text-align: center; }
main p:has(> img:only-child) + p > em:only-child { display: block; text-align: center; color: var(--muted); font-size: 0.9375rem; }
strong { font-weight: 650; }
hr { border: 0; border-top: 1px solid var(--line); margin: 2.5rem 0; }

code { font: 0.875em/1.5 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; background: var(--code); padding: 0.1em 0.3em; border-radius: 3px; }
/* Code wraps instead of scrolling, so every line is readable without a sideways scroll. */
pre { background: var(--code); padding: 0.9rem 1rem; border-radius: 6px; white-space: pre-wrap; overflow-wrap: anywhere; font-size: 0.9375rem; }
pre code { padding: 0; background: none; }
table { border-collapse: collapse; display: block; overflow-x: auto; margin: 1rem 0; font-size: 0.9375rem; line-height: 1.5; }
table:focus-visible { outline: 3px solid var(--accent); outline-offset: 2px; }
th, td { border: 1px solid var(--line); padding: 0.45rem 0.7rem; text-align: left; vertical-align: top; }
th { background: var(--panel); }

/* A plain block quote is a story scene: it opens each chapter. */
blockquote { margin: 1.5rem 0; padding: 0.35rem 1.1rem; border-left: 4px solid var(--story-edge); color: var(--fg); font-size: 1.0625em; }
blockquote em:first-child { font-style: normal; font-weight: 650; color: var(--story-edge); }
/* Callouts: a block quote that opens with a bold label ("Tip:", "You are here:", …). The label is text,
   so the meaning never rests on colour alone. */
blockquote.callout {
  color: var(--fg); background: var(--panel); border: 1px solid var(--line); border-left-width: 5px;
  border-radius: 6px; padding: 0.6rem 1.1rem; font-size: 1rem;
}
blockquote.callout > p:first-child > strong:first-child { display: inline; margin-right: 0.25rem; }
blockquote.callout-you-are-here, blockquote.callout-start-here { background: var(--here); border-color: var(--accent); }
blockquote.callout-tip { background: var(--tip); border-color: var(--tip-edge); }
blockquote.callout-well-done { background: var(--done); border-color: var(--done-edge); }
blockquote.callout-needs-setup, blockquote.callout-before-the-first-release, blockquote.callout-honest-status { background: var(--setup); border-color: var(--setup-edge); }
blockquote.callout-in-the-story { background: var(--story); border-color: var(--story-edge); }
blockquote.callout-under-the-hood { background: var(--hood); border-color: var(--hood-edge); font-size: 0.9375rem; }
blockquote.callout-start-here { font-size: 1.125rem; padding: 0.9rem 1.25rem; }

footer { margin-top: 3rem; padding-top: 1rem; border-top: 1px solid var(--line); color: var(--muted); font-size: 0.875rem; max-width: var(--measure); }

@media (max-width: 52rem) {
  body { font-size: 1rem; }
  .top { padding: 0.65rem 1rem; }
  .layout { display: block; }
  nav.side { display: none; }
  .menu { display: block; border-bottom: 1px solid var(--line); background: var(--panel); }
  .menu > summary { padding: 0.75rem 1rem; font-weight: 600; cursor: pointer; min-height: 2.75rem; }
  .menu nav { padding: 0 1rem 0.75rem; font-size: 0.9375rem; }
  .menu nav li a { min-height: 2.75rem; padding: 0.6rem 0.5rem; }
  main { padding: 1.25rem 1rem 2.5rem; }
  main h1 { font-size: 1.875rem; }
  main h2 { font-size: 1.35rem; }
  blockquote.callout { padding: 0.6rem 0.85rem; }
}
