/* ============================================================================
   CHARTVEIL — USER MANUAL
   A book-style docs shell on the site's tokens: sidebar of chapters on the
   left, the chapter in the middle, "On this page" on the right. Inter for all
   type, Chakra Petch only in the wordmark, JetBrains Mono for keys and code.
   Dark only — it is the platform's own ground. print.css restyles the same
   markup for the PDF.
   ========================================================================== */

@font-face{font-family:'Chakra Petch';src:url('../assets/fonts/ChakraPetch-Bold.woff2') format('woff2'),url('../assets/fonts/ChakraPetch-Bold.ttf') format('truetype');font-weight:700;font-display:swap}
@font-face{font-family:'Inter';src:url('../assets/fonts/Inter-Variable.woff2') format('woff2'),url('../assets/fonts/Inter-Variable.ttf') format('truetype');font-weight:100 900;font-display:swap}
@font-face{font-family:'JetBrains Mono';src:url('../assets/fonts/JetBrainsMono-Variable.woff2') format('woff2'),url('../assets/fonts/JetBrainsMono-Variable.ttf') format('truetype');font-weight:100 800;font-display:swap}

:root{
  --surface-base:#0A0A0A;
  --surface-panel:#111111;
  --surface-raised:#171717;
  --surface-input:rgba(255,255,255,.04);
  --line:rgba(255,255,255,.08);
  --line-strong:rgba(255,255,255,.18);
  --text-primary:#FFFFFF;
  --text-secondary:#A1A1A6;
  --text-muted:#6E6E73;
  --brand:#E5352F;
  --brand-hover:#F04B45;
  --brand-wash:rgba(229,53,47,.08);
  --up:#22C55E;
  --amber:#F5A623;
  --blue:#4F8BFF;
  --font-body:'Inter',-apple-system,BlinkMacSystemFont,'Segoe UI',system-ui,sans-serif;
  --font-logo:'Chakra Petch','Inter',system-ui,sans-serif;
  --font-mono:'JetBrains Mono',ui-monospace,Consolas,monospace;
  --side-w:280px;
  --toc-w:220px;
  --doc-w:760px;
  --top-h:56px;
  --r-sm:8px;--r-md:10px;--r-lg:14px;
}

*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%;scroll-behavior:smooth;scroll-padding-top:calc(var(--top-h) + 16px)}
body{
  margin:0;background:var(--surface-base);color:var(--text-secondary);
  font-family:var(--font-body);font-size:16px;line-height:1.6;
  -webkit-font-smoothing:antialiased;
}
::selection{background:var(--brand);color:#fff}
a{color:var(--text-primary);text-decoration:none}
a:hover{color:var(--brand-hover)}
img{max-width:100%;height:auto;display:block}
.skip{position:absolute;left:-9999px;top:8px;background:var(--brand);color:#fff;padding:8px 12px;border-radius:6px;z-index:100}
.skip:focus{left:8px}

/* ---- wordmark ------------------------------------------------------------ */
.logo{display:inline-flex;align-items:center;gap:8px;min-height:44px}
.logo__mark{width:24px;height:24px;color:var(--brand);flex:none}
.logo__text{font-family:var(--font-logo);font-weight:700;font-size:18px;letter-spacing:.06em;text-transform:uppercase;line-height:1}
.logo__text b{color:var(--text-primary);font-weight:700}
.logo__text i{color:var(--brand);font-style:normal}

/* ---- layout ---------------------------------------------------------------- */
.book{display:grid;grid-template-columns:var(--side-w) minmax(0,1fr);min-height:100vh}
.side{
  position:sticky;top:0;height:100vh;display:flex;flex-direction:column;
  background:var(--surface-panel);border-right:1px solid var(--line);
  overflow:hidden;
}
.side__top{padding:14px 16px 10px;border-bottom:1px solid var(--line)}
.side__title{display:flex;align-items:baseline;gap:8px;margin:2px 0 12px;font-weight:600;color:var(--text-primary);font-size:15px}
.side__title .ver{font-family:var(--font-mono);font-size:11px;color:var(--text-muted);font-weight:500}
.side__nav{flex:1;overflow-y:auto;padding:8px 8px 16px;scrollbar-width:thin;scrollbar-color:rgba(255,255,255,.14) transparent}
.side__group{padding:10px 8px 4px}
.side__group h5{margin:0 0 6px;font-size:11px;letter-spacing:.08em;text-transform:uppercase;font-weight:600;color:var(--text-muted)}
.side__group ul{list-style:none;margin:0;padding:0}
.side__group li a{
  display:block;padding:6px 10px;margin:1px 0;border-radius:6px;font-size:14px;line-height:1.35;
  color:var(--text-secondary);border-left:2px solid transparent;
}
.side__group li a:hover{background:rgba(255,255,255,.04);color:var(--text-primary)}
.side__group li a.is-on{color:var(--text-primary);background:rgba(255,255,255,.05);border-left-color:var(--brand);font-weight:500}
.side__foot{padding:12px 16px 14px;border-top:1px solid var(--line);display:flex;flex-direction:column;gap:6px;font-size:13px}
.side__foot a{color:var(--text-secondary)}
.side__foot a:hover{color:var(--text-primary)}
.side__pdf{display:inline-flex;align-items:center;gap:8px;color:var(--text-primary)!important;font-weight:500}
.side__pdf svg{width:16px;height:16px;color:var(--brand)}

/* ---- search ---------------------------------------------------------------- */
.search{position:relative;display:flex;align-items:center;gap:8px;background:var(--surface-input);border:1px solid var(--line);border-radius:var(--r-sm);padding:0 10px;height:36px}
.search:focus-within{border-color:var(--line-strong);box-shadow:0 0 0 3px rgba(229,53,47,.14)}
.search__icon{width:15px;height:15px;color:var(--text-muted);flex:none}
.search input{flex:1;min-width:0;background:none;border:0;outline:0;color:var(--text-primary);font:inherit;font-size:14px}
.search input::placeholder{color:var(--text-muted)}
.search input::-webkit-search-cancel-button{display:none}
.search kbd{font-family:var(--font-mono);font-size:11px;color:var(--text-muted);border:1px solid var(--line);border-radius:4px;padding:1px 5px;line-height:1.3}
.search__hits{
  position:absolute;left:-1px;right:-1px;top:calc(100% + 6px);z-index:30;
  background:var(--surface-raised);border:1px solid var(--line-strong);border-radius:var(--r-md);
  max-height:min(60vh,420px);overflow-y:auto;box-shadow:0 18px 48px rgba(0,0,0,.55);padding:6px;
}
.search__hits[hidden]{display:none}
.hit{display:block;padding:8px 10px;border-radius:6px;color:var(--text-secondary)}
.hit:hover,.hit.is-active{background:rgba(255,255,255,.06);color:var(--text-secondary)}
.hit small{display:block;font-size:11px;letter-spacing:.04em;text-transform:uppercase;color:var(--text-muted);margin-bottom:2px}
.hit b{display:block;color:var(--text-primary);font-weight:500;font-size:14px}
.hit span{display:block;font-size:12.5px;line-height:1.4;margin-top:2px;overflow:hidden;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical}
.hit mark{background:none;color:var(--brand-hover);font-weight:600}
.hit--none{padding:10px;font-size:13px;color:var(--text-muted)}

/* ---- top bar (phone / tablet) --------------------------------------------- */
.topbar{display:none;position:sticky;top:0;z-index:20;height:var(--top-h);align-items:center;gap:12px;padding:0 12px;background:rgba(10,10,10,.92);backdrop-filter:blur(10px);border-bottom:1px solid var(--line)}
.topbar__title{font-weight:600;color:var(--text-primary);font-size:15px;margin-left:auto}
.burger{width:40px;height:40px;border:1px solid var(--line);border-radius:8px;background:none;display:flex;flex-direction:column;justify-content:center;gap:4px;align-items:center;cursor:pointer;flex:none}
.burger span{display:block;width:16px;height:2px;background:var(--text-primary);border-radius:2px}

/* ---- the document ---------------------------------------------------------- */
.doc{display:grid;grid-template-columns:minmax(0,1fr) var(--toc-w);gap:40px;padding:0 40px;align-items:start}
.doc__body{max-width:var(--doc-w);width:100%;margin:0 auto;padding:40px 0 64px;min-width:0}
.doc__head{margin-bottom:28px}
.crumbs{display:flex;gap:8px;font-size:12px;letter-spacing:.06em;text-transform:uppercase;color:var(--text-muted);margin-bottom:12px;font-weight:500}
.crumbs a{color:var(--text-muted)}
.crumbs a:hover{color:var(--text-primary)}
h1,h2,h3,h4{font-family:var(--font-body);color:var(--text-primary);letter-spacing:-.02em;line-height:1.15;text-wrap:balance;margin:0}
h1{font-size:clamp(28px,4vw,38px);font-weight:700;letter-spacing:-.03em;margin-bottom:10px}
h2{font-size:22px;font-weight:600;margin:40px 0 12px;padding-top:20px;border-top:1px solid var(--line)}
h3{font-size:17px;font-weight:600;margin:26px 0 8px}
h4{font-size:15px;font-weight:600;margin:18px 0 6px}
.lede{font-size:17px;color:var(--text-secondary);max-width:60ch;margin:0}
p{margin:0 0 14px}
strong,b{color:var(--text-primary);font-weight:600}
em{color:var(--text-primary);font-style:italic}
ul,ol{padding-left:22px;margin:0 0 14px}
li{margin:4px 0}
li>ul,li>ol{margin:4px 0 0}
hr{border:0;border-top:1px solid var(--line);margin:28px 0}
.doc__body a:not(.pn):not(.btn){color:var(--text-primary);border-bottom:1px solid var(--line-strong)}
.doc__body a:not(.pn):not(.btn):hover{color:var(--brand-hover);border-bottom-color:var(--brand-hover)}
code,kbd{font-family:var(--font-mono);font-size:.88em}
code{background:rgba(255,255,255,.06);border:1px solid var(--line);border-radius:4px;padding:1px 5px;color:var(--text-primary)}
kbd{display:inline-block;background:var(--surface-raised);border:1px solid var(--line-strong);border-bottom-width:2px;border-radius:5px;padding:1px 6px;color:var(--text-primary);line-height:1.4;font-size:.82em;font-weight:500}
pre{background:var(--surface-panel);border:1px solid var(--line);border-radius:var(--r-md);padding:14px 16px;overflow-x:auto;margin:0 0 16px;font-size:13.5px;line-height:1.55}
pre code{background:none;border:0;padding:0;color:var(--text-primary)}
table{width:100%;border-collapse:collapse;margin:0 0 18px;font-size:14.5px}
th,td{text-align:left;padding:9px 10px;border-bottom:1px solid var(--line);vertical-align:top}
th{font-size:12px;letter-spacing:.06em;text-transform:uppercase;color:var(--text-muted);font-weight:600}
td:first-child{color:var(--text-primary)}
td kbd{white-space:nowrap}
dl{margin:0 0 16px}
dt{color:var(--text-primary);font-weight:600;margin-top:12px}
dd{margin:2px 0 0}
blockquote{margin:0 0 16px;padding:2px 0 2px 16px;border-left:2px solid var(--line-strong);color:var(--text-secondary)}

/* callouts */
.callout{display:grid;grid-template-columns:auto 1fr;gap:12px;align-items:start;margin:18px 0;padding:14px 16px;border:1px solid var(--line);border-left-width:3px;border-radius:var(--r-md);background:rgba(255,255,255,.025)}
.callout__label{font-size:11px;letter-spacing:.08em;text-transform:uppercase;font-weight:600;color:var(--text-primary);padding-top:3px;min-width:56px}
.callout__body p:last-child{margin-bottom:0}
.callout--note{border-left-color:var(--blue)}
.callout--tip{border-left-color:var(--up)}
.callout--warning{border-left-color:var(--brand);background:var(--brand-wash)}
.callout--warning .callout__label{color:var(--brand-hover)}
.callout--rule{border-left-color:var(--amber)}
.callout--example{border-left-color:var(--line-strong)}

/* figures */
.shot{margin:0 0 26px;border:1px solid var(--line);border-radius:var(--r-lg);overflow:hidden;background:#000}
.shot img{width:100%}
.shot--tall{background:var(--surface-panel)}
.shot--tall img{width:auto;max-height:560px;margin:0 auto}
.shot figcaption{padding:8px 12px;font-size:12.5px;line-height:1.45;color:var(--text-secondary);border-top:1px solid var(--line);background:var(--surface-panel)}
.shot figcaption .note{display:block;margin-top:3px;font-size:11.5px;color:var(--text-muted)}
.shot--narrow{max-width:520px}
.shot--narrow.shot--tall{max-width:none}

/* pager */
.pager{display:grid;grid-template-columns:1fr 1fr;gap:14px;margin-top:48px}
.pn{display:flex;flex-direction:column;gap:4px;padding:14px 16px;border:1px solid var(--line);border-radius:var(--r-md);background:var(--surface-panel);color:var(--text-primary)}
.pn:hover{border-color:var(--line-strong);color:var(--text-primary)}
.pn small{font-size:11px;letter-spacing:.06em;text-transform:uppercase;color:var(--text-muted)}
.pn b{font-weight:600;font-size:15px}
.pn--next{text-align:right;grid-column:2}
.pn--prev{grid-column:1}
.doc__foot{display:flex;justify-content:space-between;gap:16px;flex-wrap:wrap;margin-top:40px;padding-top:16px;border-top:1px solid var(--line);font-size:12.5px;color:var(--text-muted)}
.doc__foot a{color:var(--text-muted)}
.doc__foot a:hover{color:var(--text-primary)}

/* on this page */
.toc{position:sticky;top:0;padding:44px 0 24px;max-height:100vh;overflow-y:auto;font-size:13px;scrollbar-width:thin}
.toc h5{margin:0 0 8px;font-size:11px;letter-spacing:.08em;text-transform:uppercase;font-weight:600;color:var(--text-muted)}
.toc ul{list-style:none;margin:0;padding:0;border-left:1px solid var(--line)}
.toc li a{display:block;padding:4px 0 4px 12px;margin-left:-1px;border-left:1px solid transparent;color:var(--text-muted);line-height:1.35}
.toc li.lvl3 a{padding-left:24px;font-size:12.5px}
.toc li a:hover{color:var(--text-primary)}
.toc li a.is-on{color:var(--text-primary);border-left-color:var(--brand)}

/* ---- cover ------------------------------------------------------------------ */
.is-cover .doc{grid-template-columns:minmax(0,1fr)}
.is-cover .doc__body{max-width:920px}
.cover{padding:16px 0 26px}
.eyebrow{font-size:12px;letter-spacing:.06em;text-transform:uppercase;color:var(--text-muted);font-weight:500;margin-bottom:12px}
.cover h1{font-size:clamp(34px,5vw,52px);letter-spacing:-.035em;line-height:1.02;max-width:16ch}
.cover h1 em{font-style:normal;color:var(--brand)}
.cover .lede{margin-top:14px;max-width:62ch}
.cover .lede a{color:var(--text-primary);border-bottom:1px solid var(--line-strong)}
.cover__actions{display:flex;gap:10px;flex-wrap:wrap;margin-top:22px}
.btn{display:inline-flex;align-items:center;justify-content:center;min-height:42px;padding:0 18px;border-radius:var(--r-sm);font-weight:600;font-size:14px;border:1px solid transparent}
.btn--primary{background:var(--brand);color:#fff}
.btn--primary:hover{background:var(--brand-hover);color:#fff}
.btn--ghost{border-color:var(--line-strong);color:var(--text-primary)}
.btn--ghost:hover{border-color:#fff;color:#fff}
.shot--cover{margin:8px 0 36px}
.cover__group{margin:28px 0}
.cover__group h2{border:0;padding:0;margin:0 0 10px;font-size:13px;letter-spacing:.08em;text-transform:uppercase;color:var(--text-muted);font-weight:600}
.cover__group ul{list-style:none;margin:0;padding:0;display:grid;grid-template-columns:repeat(auto-fill,minmax(260px,1fr));gap:10px}
.cover__group li a{display:flex;flex-direction:column;gap:4px;padding:14px 16px;border:1px solid var(--line);border-radius:var(--r-md);background:var(--surface-panel);height:100%}
.cover__group li a:hover{border-color:var(--line-strong)}
.cover__group li b{color:var(--text-primary);font-weight:600;font-size:15px}
.cover__group li span{font-size:13px;color:var(--text-secondary);line-height:1.45}

/* ---- responsive --------------------------------------------------------------- */
@media (max-width:1180px){
  .doc{grid-template-columns:minmax(0,1fr);padding:0 32px}
  .toc{display:none}
}
@media (max-width:900px){
  .book{grid-template-columns:minmax(0,1fr)}
  .topbar{display:flex}
  .side{
    position:fixed;left:0;top:0;bottom:0;width:min(320px,88vw);z-index:40;
    transform:translateX(-102%);transition:transform .22s ease;box-shadow:0 0 0 100vw rgba(0,0,0,0);
  }
  body.side-open .side{transform:none;box-shadow:0 0 0 100vw rgba(0,0,0,.55)}
  body.side-open{overflow:hidden}
  .doc{padding:0 16px}
  .doc__body{padding:22px 0 48px}
  h2{margin-top:32px}
  .pager{grid-template-columns:1fr}
  .pn--next,.pn--prev{grid-column:auto}
  .pn--next{text-align:left}
  table{display:block;overflow-x:auto;white-space:nowrap}
  table td,table th{white-space:normal;min-width:120px}
}
@media (max-width:480px){
  .cover h1{font-size:30px}
  .callout{grid-template-columns:1fr;gap:6px}
}
@media (prefers-reduced-motion:reduce){
  html{scroll-behavior:auto}
  .side{transition:none}
}