:root{
    --bg:#fbfbf9; --grid:rgba(22,24,26,.055); --surface:#ffffff; --surface-2:#f3f2ef;
    --ink:#16181a; --ink-2:#4d5155; --ink-3:#8a8d90; --rule:#e6e4df;
    --copper:#b0602a; --copper-soft:#f7ede4;
    --signal:#c0341c; --ok:#1f7a52; --ok-soft:#e6f2ec;
    --amber:#8a6a12; --amber-soft:#faf3dd;
    --sky:#1f6b86; --sky-soft:#e4f0f4;
    --mono: ui-monospace,"SFMono-Regular","Cascadia Mono",Consolas,"Liberation Mono",Menlo,monospace;
    --sans: ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
    --nav-h:60px;
  }
  @media (prefers-color-scheme: dark){
    :root:not([data-theme="light"]){
      --bg:#0d1114; --grid:rgba(236,228,207,.05); --surface:#141a1e; --surface-2:#1b2227;
      --ink:#e9e7e1; --ink-2:#a8aeb2; --ink-3:#6f767b; --rule:#242d33;
      --copper:#d08b4f; --copper-soft:#241a12;
      --signal:#e0715c; --ok:#5fbf90; --ok-soft:#12241b;
      --amber:#d4b062; --amber-soft:#241f10;
      --sky:#6fb3cc; --sky-soft:#0f2129;
    }
  }
  :root[data-theme="dark"]{
    --bg:#0d1114; --grid:rgba(236,228,207,.05); --surface:#141a1e; --surface-2:#1b2227;
    --ink:#e9e7e1; --ink-2:#a8aeb2; --ink-3:#6f767b; --rule:#242d33;
    --copper:#d08b4f; --copper-soft:#241a12;
    --signal:#e0715c; --ok:#5fbf90; --ok-soft:#12241b;
    --amber:#d4b062; --amber-soft:#241f10;
    --sky:#6fb3cc; --sky-soft:#0f2129;
  }

  *{box-sizing:border-box;}
  html{scroll-behavior:smooth;}
  body{
    margin:0;background:var(--bg);color:var(--ink);
    font-family:var(--sans);font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased;
    background-image:linear-gradient(var(--grid) 1px,transparent 1px),linear-gradient(90deg,var(--grid) 1px,transparent 1px);
    background-size:64px 64px;
  }
  @media (prefers-reduced-motion:reduce){*{animation-duration:.001ms!important;animation-iteration-count:1!important;transition-duration:.001ms!important;}}
  a{color:var(--copper);text-underline-offset:2px;}

  /* ── top nav ─────────────────────────────────────────────── */
  .topnav{
    position:sticky;top:0;z-index:40;height:var(--nav-h);
    display:flex;align-items:center;gap:18px;
    padding:0 clamp(14px,2.4vw,26px);
    background:color-mix(in srgb,var(--bg) 88%,transparent);
    backdrop-filter:blur(9px);border-bottom:1px solid var(--rule);
  }
  .mark{font-family:var(--mono);font-weight:700;font-size:15px;letter-spacing:.04em;color:var(--ink);text-decoration:none;white-space:nowrap;}
  .mark span{color:var(--copper);}
  .topnav nav{display:flex;align-items:center;gap:4px;margin-left:10px;}
  .topnav nav a{
    font-size:13.5px;color:var(--ink-2);text-decoration:none;padding:6px 11px;border-radius:7px;
    transition:background .14s ease,color .14s ease;
  }
  .topnav nav a:hover{color:var(--ink);background:var(--surface-2);}
  .topnav nav a[aria-current="page"]{background:var(--surface-2);color:var(--ink);font-weight:600;}
  .navspace{flex:1;}
  .themebtn{
    font-family:var(--mono);font-size:11px;letter-spacing:.08em;text-transform:uppercase;
    background:var(--surface);border:1px solid var(--rule);color:var(--ink-2);
    padding:7px 12px;border-radius:7px;cursor:pointer;
  }
  .themebtn:hover{color:var(--ink);border-color:var(--copper);}

  /* ── three-column shell ──────────────────────────────────── */
  .shell{display:grid;grid-template-columns:250px minmax(0,1fr) 232px;gap:0;max-width:1400px;margin:0 auto;}
  @media(max-width:1140px){.shell{grid-template-columns:230px minmax(0,1fr);} .toc{display:none;}}
  @media(max-width:840px){.shell{grid-template-columns:1fr;} .sidebar{display:none;}}

  .sidebar{
    border-right:1px solid var(--rule);padding:26px 16px 40px;
    position:sticky;top:var(--nav-h);height:calc(100vh - var(--nav-h));overflow-y:auto;
  }
  .sgroup{font-family:var(--mono);font-size:10.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin:22px 0 8px;display:flex;align-items:center;gap:7px;}
  .sgroup:first-child{margin-top:0;}
  .sgroup i{width:6px;height:6px;background:var(--copper);border-radius:1px;display:inline-block;}
  .sidebar a{
    display:block;font-size:14px;color:var(--ink-2);text-decoration:none;
    padding:6.5px 11px;border-radius:7px;transition:background .14s ease,color .14s ease;
  }
  .sidebar a:hover{background:var(--surface-2);color:var(--ink);}
  .sidebar a[aria-current="page"]{background:var(--surface-2);color:var(--ink);font-weight:600;}

  .toc{padding:30px 20px 40px;position:sticky;top:var(--nav-h);height:calc(100vh - var(--nav-h));overflow-y:auto;}
  .toc-card{border:1px solid var(--rule);border-radius:11px;background:var(--surface);padding:15px 15px 17px;}
  .toc-title{font-family:var(--mono);font-size:10.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin:0 0 11px;}
  .toc a{display:block;font-size:13px;color:var(--ink-2);text-decoration:none;padding:4.5px 0;border-left:2px solid transparent;padding-left:11px;margin-left:-1px;}
  .toc a:hover{color:var(--copper);border-left-color:var(--copper);}
  .toc a.sub{padding-left:24px;font-size:12.5px;color:var(--ink-3);}

  /* ── article ─────────────────────────────────────────────── */
  article{padding:44px clamp(20px,4vw,58px) 100px;min-width:0;max-width:820px;}
  .crumb{font-family:var(--mono);font-size:11px;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin:0 0 14px;}
  .crumb a{color:var(--ink-3);text-decoration:none;}
  .crumb a:hover{color:var(--copper);}
  h1{font-size:clamp(31px,4.4vw,42px);line-height:1.1;letter-spacing:-.025em;margin:0 0 12px;font-weight:700;text-wrap:balance;}
  .standfirst{font-size:18px;color:var(--ink-2);margin:0 0 32px;max-width:58ch;}
  h2{font-size:24px;line-height:1.25;letter-spacing:-.015em;margin:44px 0 12px;font-weight:700;scroll-margin-top:calc(var(--nav-h) + 16px);}
  h3{font-size:17px;margin:30px 0 8px;font-weight:650;scroll-margin-top:calc(var(--nav-h) + 16px);}
  p{margin:0 0 15px;color:var(--ink-2);}
  p strong,li strong{color:var(--ink);font-weight:650;}
  article ul{margin:0 0 16px;padding-left:20px;color:var(--ink-2);}
  article li{margin-bottom:6px;}
  code{font-family:var(--mono);font-size:.875em;background:var(--surface-2);padding:2px 6px;border-radius:4px;color:var(--ink);}
  pre{margin:0 0 18px;padding:16px 18px;background:var(--surface);border:1px solid var(--rule);border-radius:10px;overflow-x:auto;font-family:var(--mono);font-size:13px;line-height:1.75;color:var(--ink-2);}
  pre .c{color:var(--ink-3);}
  pre .k{color:var(--copper);}

  /* numbered steps — the spine of every guide */
  .steps{counter-reset:step;list-style:none;margin:0 0 22px;padding:0;}
  .steps>li{counter-increment:step;position:relative;padding-left:44px;margin-bottom:20px;}
  .steps>li::before{
    content:counter(step);position:absolute;left:0;top:-1px;
    width:28px;height:28px;border-radius:8px;
    background:var(--copper-soft);border:1px solid var(--copper);color:var(--copper);
    font-family:var(--mono);font-size:13px;font-weight:700;
    display:flex;align-items:center;justify-content:center;
  }
  .steps>li>strong{display:block;color:var(--ink);font-size:16px;margin-bottom:3px;}
  .steps p{margin:0;}

  /* callouts — the sticker device, straightened for reading */
  .note{border:1px solid var(--rule);border-left:3px solid var(--sky);background:var(--surface);border-radius:9px;padding:14px 16px;margin:0 0 20px;font-size:15px;color:var(--ink-2);}
  .note.warn{border-left-color:var(--signal);}
  .note.good{border-left-color:var(--ok);}
  .note b{display:block;color:var(--ink);font-size:13px;margin-bottom:3px;}

  /* the tilted sticker tags, borrowed and used where they earn it */
  .tags{display:flex;flex-wrap:wrap;gap:9px;margin:0 0 30px;}
  .tag{
    font-family:var(--mono);font-size:11.5px;padding:4px 10px;border-radius:5px;
    border:1px dashed currentColor;display:inline-block;
  }
  .tag.t1{color:var(--ok);background:var(--ok-soft);transform:rotate(-1.6deg);}
  .tag.t2{color:var(--amber);background:var(--amber-soft);transform:rotate(1.1deg);}
  .tag.t3{color:var(--sky);background:var(--sky-soft);transform:rotate(-.7deg);}

  /* screenshot placeholder — a capture instruction, never "image here" */
  .shot{
    border:1.5px dashed var(--rule);border-radius:11px;background:var(--surface-2);
    padding:26px 22px;margin:0 0 22px;text-align:center;
  }
  .shot .lbl{font-family:var(--mono);font-size:10.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--copper);margin-bottom:7px;}
  .shot .desc{font-size:14px;color:var(--ink-3);max-width:52ch;margin:0 auto;}

  table{width:100%;border-collapse:separate;border-spacing:0;font-size:14.5px;margin:0 0 22px;}
  .tbl{overflow-x:auto;border:1px solid var(--rule);border-radius:11px;background:var(--surface);margin-bottom:22px;}
  .tbl table{margin:0;}
  th,td{text-align:left;padding:11px 15px;border-bottom:1px solid var(--rule);}
  th{font-size:12px;letter-spacing:.05em;text-transform:uppercase;color:var(--ink-3);font-weight:600;}
  tr:last-child td{border-bottom:0;}
  td.num{font-family:var(--mono);text-align:right;font-variant-numeric:tabular-nums;color:var(--copper);white-space:nowrap;}
  td a{color:var(--ink);text-decoration:none;border-bottom:1px dotted var(--copper);}
  td a:hover{color:var(--copper);}
  tfoot td{font-weight:650;color:var(--ink);border-top:1px solid var(--copper);}

  .pager{display:flex;gap:12px;margin-top:52px;padding-top:24px;border-top:1px solid var(--rule);}
  .pager a{flex:1;border:1px solid var(--rule);border-radius:10px;padding:13px 16px;text-decoration:none;background:var(--surface);}
  .pager a:hover{border-color:var(--copper);}
  .pager .dir{display:block;font-family:var(--mono);font-size:10.5px;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-bottom:3px;}
  .pager .ttl{color:var(--ink);font-size:14.5px;font-weight:600;}
  .pager .next{text-align:right;}
