/* ============================== TOKENS ============================== */
  :root{
    --bg:        #EDEBE0;
    --bg-raise:  #F5F3E9;
    --bg-sunken: #E2DFD0;
    --ink:       #1D2118;
    --ink-soft:  #4B5044;
    --line:      #CFCABA;
    --line-soft: #DDD8C8;
    --accent:    #A9631E;
    --accent-ink:#5C3812;
    --accent-bg: #F0DEC2;
    --green:     #4B6B3C;
    --green-bg:  #DCE5D1;
    --red:       #9A3324;
    --red-bg:    #EAD9D2;
    --shadow:    0 1px 0 rgba(29,33,24,0.06);
    --radius:    3px;
    --mono-display: 'Space Mono', ui-monospace, 'SF Mono', Menlo, monospace;
    --mono-code:    'IBM Plex Mono', ui-monospace, 'SF Mono', Menlo, monospace;
    --serif:        'Source Serif 4', Georgia, 'Times New Roman', serif;
  }
  @media (prefers-color-scheme: dark){
    :root:not([data-theme="light"]){
      --bg:        #181B15;
      --bg-raise:  #1F231B;
      --bg-sunken: #121510;
      --ink:       #EAE7D9;
      --ink-soft:  #ACA894;
      --line:      #383C30;
      --line-soft: #2B2F25;
      --accent:    #DDA355;
      --accent-ink:#F3D9AE;
      --accent-bg: #33291A;
      --green:     #8FAE78;
      --green-bg:  #263021;
      --red:       #C97A63;
      --red-bg:    #3A241E;
      --shadow:    0 1px 0 rgba(0,0,0,0.4);
    }
  }
  :root[data-theme="dark"]{
    --bg:        #181B15;
    --bg-raise:  #1F231B;
    --bg-sunken: #121510;
    --ink:       #EAE7D9;
    --ink-soft:  #ACA894;
    --line:      #383C30;
    --line-soft: #2B2F25;
    --accent:    #DDA355;
    --accent-ink:#F3D9AE;
    --accent-bg: #33291A;
    --green:     #8FAE78;
    --green-bg:  #263021;
    --red:       #C97A63;
    --red-bg:    #3A241E;
    --shadow:    0 1px 0 rgba(0,0,0,0.4);
  }

  *{box-sizing:border-box;}
  html{-webkit-text-size-adjust:100%;}
  body{
    margin:0; background:var(--bg); color:var(--ink);
    font-family:var(--serif); font-size:17px; line-height:1.6;
    -webkit-font-smoothing:antialiased;
  }
  h1,h2,h3,.mono-display{ font-family:var(--mono-display); text-wrap:balance; }
  code,pre,.mono-code,kbd{ font-family:var(--mono-code); }
  a{ color:inherit; }
  ::selection{ background:var(--accent); color:var(--bg-raise); }

  .wrap{ max-width:920px; margin:0 auto; padding:0 28px; }
  .wrap-wide{ max-width:1080px; margin:0 auto; padding:0 28px; }

  /* ============================== NAV ============================== */
  nav{
    position:sticky; top:0; z-index:20;
    background:color-mix(in srgb, var(--bg) 88%, transparent);
    backdrop-filter:blur(6px);
    border-bottom:1px solid var(--line);
  }
  .nav-row{
    display:flex; align-items:center; justify-content:space-between;
    padding:16px 28px; max-width:1080px; margin:0 auto;
  }
  .brand{
    font-family:var(--mono-display); font-weight:700; font-size:19px;
    display:flex; align-items:center; gap:9px; text-decoration:none;
    letter-spacing:-0.02em;
  }
  .brand .dot{
    width:9px;height:9px;border-radius:50%;
    background:var(--accent);
    box-shadow:0 0 0 3px var(--accent-bg);
  }
  .nav-links{ display:flex; gap:26px; font-family:var(--mono-code); font-size:13.5px; }
  .nav-links a{ text-decoration:none; color:var(--ink-soft); border-bottom:1px solid transparent; padding-bottom:2px; transition:border-color .15s, color .15s; }
  .nav-links a:hover{ color:var(--ink); border-color:var(--accent); }
  .nav-links .gh{ display:flex; align-items:center; gap:6px; }
  @media (max-width:640px){ .nav-links{ display:none; } }

  /* ============================== HERO ============================== */
  .hero{ padding:64px 0 52px; }
  .eyebrow{
    font-family:var(--mono-code); font-size:12.5px; letter-spacing:.08em; text-transform:uppercase;
    color:var(--accent-ink); background:var(--accent-bg); display:inline-block;
    padding:4px 9px; border-radius:2px; margin-bottom:22px;
  }
  h1.title{
    font-size:clamp(34px, 5.4vw, 56px); font-weight:700; line-height:1.04;
    margin:0 0 20px; letter-spacing:-0.01em;
  }
  h1.title em{ font-style:normal; color:var(--accent); }
  .sub{
    font-size:19px; color:var(--ink-soft); max-width:540px; margin:0 0 34px; line-height:1.55;
  }
  .hero-actions{ display:flex; gap:14px; flex-wrap:wrap; margin-bottom:14px; }
  .btn{
    font-family:var(--mono-code); font-size:14px; font-weight:500;
    padding:11px 20px; border-radius:var(--radius); text-decoration:none;
    display:inline-flex; align-items:center; gap:8px; border:1px solid transparent;
    cursor:pointer;
  }
  .btn-primary{ background:var(--ink); color:var(--bg-raise); }
  .btn-primary:hover{ background:var(--accent-ink); }
  .btn-ghost{ border-color:var(--line); color:var(--ink); }
  .btn-ghost:hover{ border-color:var(--ink-soft); }

  .dl-buttons{ display:flex; flex-wrap:wrap; gap:10px; margin:8px 0 4px; }
  .dl-btn{ font-size:13px; padding:9px 16px; position:relative; }
  .dl-btn .tick{ opacity:0.55; }
  .dl-btn.detected{ border-color:var(--accent); color:var(--accent-ink); }
  .dl-btn.detected::after{
    content:"detected"; position:absolute; top:-9px; right:8px;
    font-size:9.5px; letter-spacing:.05em; text-transform:uppercase;
    background:var(--accent); color:var(--bg-raise); padding:1px 6px; border-radius:3px;
  }

  .hero-grid{
    display:grid; grid-template-columns:1.05fr 1fr; gap:56px; align-items:start;
  }
  @media (max-width:860px){ .hero-grid{ grid-template-columns:1fr; } }

  /* ============================== TERMINAL ============================== */
  .term{
    background:var(--bg-sunken); border:1px solid var(--line); border-radius:6px;
    overflow:hidden; box-shadow:0 10px 30px -18px rgba(0,0,0,0.35);
  }
  .term-bar{
    display:flex; align-items:center; gap:7px; padding:10px 14px;
    border-bottom:1px solid var(--line); background:var(--bg-raise);
  }
  .term-bar span{ width:10px;height:10px;border-radius:50%; background:var(--line); }
  .term-bar .lbl{
    margin-left:8px; font-family:var(--mono-code); font-size:12px; color:var(--ink-soft);
  }
  .term-body{
    font-family:var(--mono-code); font-size:13px; line-height:1.72;
    padding:18px 18px 20px; overflow-x:auto;
  }
  .t-dim{ color:var(--ink-soft); }
  .t-prompt{ color:var(--accent); }
  .t-ok{ color:var(--green); }
  .t-bar-fill{ color:var(--accent); }
  .t-bar-track{ color:var(--line); }
  .t-bold{ font-weight:600; color:var(--ink); }

  .hero-stats{ display:flex; gap:0; margin-top:16px; border:1px solid var(--line); border-radius:var(--radius); overflow:hidden; }
  .hero-stats div{ flex:1; padding:12px 14px; border-right:1px solid var(--line); }
  .hero-stats div:last-child{ border-right:none; }
  .hero-stats .n{ font-family:var(--mono-display); font-weight:700; font-size:18px; display:block; }
  .hero-stats .l{ font-family:var(--mono-code); font-size:11px; color:var(--ink-soft); text-transform:uppercase; letter-spacing:.04em; }

  /* ============================== install line ============================== */
  .install-line{
    display:flex; align-items:center; gap:0; margin-top:10px;
    background:var(--ink); border-radius:var(--radius); overflow:hidden;
  }
  .install-line code{
    flex:1; padding:12px 14px; font-size:13.5px; color:var(--bg-raise); overflow-x:auto;
  }
  .install-line code .t-prompt{ color:var(--accent); }
  .copy-btn{
    background:transparent; border:none; border-left:1px solid rgba(255,255,255,0.15);
    color:var(--bg-raise); font-family:var(--mono-code); font-size:12px;
    padding:0 16px; cursor:pointer; align-self:stretch; white-space:nowrap;
  }
  .copy-btn:hover{ background:rgba(255,255,255,0.08); }

  /* ============================== SECTION SCAFFOLD ============================== */
  section{ padding:64px 0; border-top:1px solid var(--line); }
  .section-head{ margin-bottom:38px; max-width:620px; }
  .kicker{
    font-family:var(--mono-code); font-size:12.5px; letter-spacing:.08em; text-transform:uppercase;
    color:var(--accent); margin-bottom:10px; display:block;
  }
  h2{ font-size:clamp(24px,3.4vw,32px); margin:0 0 12px; letter-spacing:-0.01em; }
  .section-head p{ color:var(--ink-soft); font-size:16.5px; margin:0; }

  /* ============================== SPEC TABLE (comparison) ============================== */
  .spec{ width:100%; border-collapse:collapse; font-size:15px; }
  .spec thead th{
    text-align:left; font-family:var(--mono-code); font-size:11.5px; text-transform:uppercase;
    letter-spacing:.04em; color:var(--ink-soft); font-weight:500;
    padding:0 16px 12px; border-bottom:1px solid var(--line);
  }
  .spec thead th:first-child{ padding-left:0; }
  .spec tbody th{
    text-align:left; font-weight:600; padding:15px 16px 15px 0; vertical-align:top;
    width:30%; font-size:15.5px;
  }
  .spec tbody td{
    padding:15px 16px; vertical-align:top; border-bottom:1px solid var(--line-soft);
    color:var(--ink-soft); font-size:14.5px; line-height:1.5;
  }
  .spec tbody tr:last-child td, .spec tbody tr:last-child th{ border-bottom:none; }
  .spec td.win{ color:var(--ink); font-weight:500; }
  .tag{
    display:inline-block; font-family:var(--mono-code); font-size:11px;
    padding:2px 7px; border-radius:2px; margin-bottom:6px; letter-spacing:.02em;
  }
  .tag-brew{ background:var(--red-bg); color:var(--red); }
  .tag-hop{ background:var(--green-bg); color:var(--green); }
  .spec-scroll{ overflow-x:auto; }

  /* ============================== GENERATIONS DIAGRAM ============================== */
  .mech{ display:grid; grid-template-columns:1fr 1fr; gap:50px; align-items:center; }
  @media (max-width:860px){ .mech{ grid-template-columns:1fr; } }
  .mech-copy p{ color:var(--ink-soft); margin:0 0 16px; font-size:16px; }
  .mech-copy strong{ color:var(--ink); font-weight:600; }
  .diagram{ background:var(--bg-raise); border:1px solid var(--line); border-radius:6px; padding:26px 22px; }
  .diagram svg{ display:block; width:100%; height:auto; }
  .diagram-cap{ font-family:var(--mono-code); font-size:12px; color:var(--ink-soft); margin-top:14px; text-align:center; }

  /* ============================== PACKAGE INDEX (card catalog) ============================== */
  .catalog-meta{
    display:flex; justify-content:space-between; align-items:baseline; margin-bottom:20px;
    flex-wrap:wrap; gap:10px;
  }
  .catalog-count{ font-family:var(--mono-code); font-size:13px; color:var(--ink-soft); }
  .catalog{
    display:grid; grid-template-columns:repeat(auto-fill, minmax(230px,1fr)); gap:1px;
    background:var(--line); border:1px solid var(--line); border-radius:6px; overflow:hidden;
  }
  .card{
    background:var(--bg-raise); padding:16px 16px 14px; display:flex; flex-direction:column; gap:6px;
    min-height:118px;
  }
  .card-top{ display:flex; justify-content:space-between; align-items:baseline; gap:8px; }
  .card-name{ font-family:var(--mono-display); font-weight:700; font-size:15px; }
  .card-ver{ font-family:var(--mono-code); font-size:11.5px; color:var(--accent); white-space:nowrap; }
  .card-desc{ font-size:13.5px; color:var(--ink-soft); line-height:1.45; flex:1; }
  .card-plats{ font-family:var(--mono-code); font-size:10.5px; color:var(--ink-soft); opacity:.7; letter-spacing:.03em; }
  .catalog-more{
    background:var(--bg-sunken); display:flex; align-items:center; justify-content:center;
    font-family:var(--mono-code); font-size:13px; color:var(--ink-soft); min-height:118px;
  }

  /* ============================== MIGRATE CALLOUT ============================== */
  .callout{
    display:grid; grid-template-columns:auto 1fr; gap:22px; align-items:start;
    background:var(--accent-bg); border:1px solid var(--accent); border-radius:6px;
    padding:24px 26px; margin-top:8px;
  }
  .callout-mark{ font-family:var(--mono-display); font-weight:700; font-size:22px; color:var(--accent-ink); line-height:1; padding-top:2px; }
  .callout h3{ margin:0 0 8px; font-size:17px; color:var(--accent-ink); }
  .callout p{ margin:0; color:var(--accent-ink); font-size:14.5px; line-height:1.55; opacity:.92; }
  .callout code{ background:rgba(0,0,0,0.06); padding:1px 5px; border-radius:2px; font-size:.92em; }

  /* ============================== FOOTER ============================== */
  footer{ border-top:1px solid var(--line); padding:40px 0 50px; }
  .foot-row{ display:flex; justify-content:space-between; flex-wrap:wrap; gap:20px; align-items:center; }
  .foot-links{ display:flex; gap:22px; font-family:var(--mono-code); font-size:13px; }
  .foot-links a{ text-decoration:none; color:var(--ink-soft); }
  .foot-links a:hover{ color:var(--ink); }
  .foot-note{ font-family:var(--mono-code); font-size:12px; color:var(--ink-soft); }

  @media (prefers-reduced-motion: reduce){ *{ transition:none !important; animation:none !important; } }

  /* ============================== MOTION ============================== */
  /* Progressive enhancement: sections render fully visible with no JS or if
     scripts fail; only when html.js is present do they start slightly
     dimmed and settle into place as they enter the viewport. Nothing ever
     starts at opacity:0, so a screenshot taken before the observer fires
     still shows real, readable content. */
  html.js .reveal{
    opacity:.5; transform:translateY(14px);
    transition:opacity .5s ease, transform .5s ease;
  }
  html.js .reveal.in-view{ opacity:1; transform:translateY(0); }

  /* terminal cursor: a live block that blinks at the end of a session */
  .cursor{
    display:inline-block; width:7px; height:13px; margin-left:2px; vertical-align:-2px;
    background:var(--ink); animation:blink 1s step-end infinite;
  }
  @keyframes blink{ 50%{ opacity:0; } }

  /* progress bars: rendered already-complete (never an empty first frame),
     with a light sweep to read as "actively transferring" rather than a
     static drawing of a bar */
  .term-line{ min-height:1.72em; white-space:pre; }
  .term-pre{ white-space:pre; }
  .pbar-row{ display:flex; align-items:center; gap:10px; }
  .pbar{
    position:relative; display:inline-block; width:160px; height:8px;
    background:var(--line); border-radius:2px; overflow:hidden; flex-shrink:0;
  }
  .pbar-fill{ position:absolute; inset:0; background:var(--accent); border-radius:2px; }
  .pbar-fill::after{
    content:''; position:absolute; inset:0;
    background:linear-gradient(100deg, transparent 30%, rgba(255,255,255,.4) 50%, transparent 70%);
    transform:translateX(-100%); animation:shimmer 2.4s ease-in-out infinite;
  }
  .pbar-row:nth-child(1) .pbar-fill::after{ animation-delay:0s; }
  .pbar-row:nth-child(2) .pbar-fill::after{ animation-delay:.5s; }
  .pbar-row:nth-child(3) .pbar-fill::after{ animation-delay:1s; }
  .pbar-row:nth-child(4) .pbar-fill::after{ animation-delay:1.5s; }
  @keyframes shimmer{ to{ transform:translateX(220%); } }

  /* card catalog + package cards get a small lift on hover/focus */
  .card{ transition:background-color .15s ease, box-shadow .15s ease; }
  .card:hover, .card:focus-within{ background:var(--bg-sunken); box-shadow:inset 0 0 0 1px var(--accent); }

/* ============================== DOC PAGES ============================== */
/* Shared layout for the long-form pages (commands, architecture,
   relocation, migrate-guide): a readable article column, a sticky
   in-page table of contents on wide screens, and a couple of callout
   styles used to mark a plain-language aside apart from the technical
   detail around it. */
.doc-head{ padding:48px 0 8px; }
.doc-eyebrow{
  font-family:var(--mono-code); font-size:12.5px; letter-spacing:.08em; text-transform:uppercase;
  color:var(--accent-ink); background:var(--accent-bg); display:inline-block;
  padding:4px 9px; border-radius:2px; margin-bottom:18px;
}
.doc-head h1{ font-size:clamp(28px,4.4vw,42px); margin:0 0 14px; letter-spacing:-0.01em; }
.doc-head .sub{ font-size:17.5px; color:var(--ink-soft); max-width:640px; margin:0; line-height:1.55; }

.doc-layout{ display:grid; grid-template-columns:200px 1fr; gap:56px; padding:36px 0 72px; align-items:start; }
@media (max-width:860px){ .doc-layout{ grid-template-columns:1fr; } }

.doc-toc{ position:sticky; top:84px; font-family:var(--mono-code); font-size:13px; }
.doc-toc .toc-label{ text-transform:uppercase; letter-spacing:.06em; font-size:11px; color:var(--ink-soft); margin-bottom:10px; display:block; }
.doc-toc ol{ list-style:none; margin:0; padding:0; display:flex; flex-direction:column; gap:8px; }
.doc-toc a{ text-decoration:none; color:var(--ink-soft); border-left:2px solid transparent; padding-left:10px; display:block; transition:color .15s, border-color .15s; }
.doc-toc a:hover{ color:var(--ink); }
.doc-toc a.active{ color:var(--ink); border-color:var(--accent); font-weight:500; }
@media (max-width:860px){ .doc-toc{ position:static; margin-bottom:8px; } .doc-toc ol{ flex-direction:row; flex-wrap:wrap; gap:14px; } .doc-toc a{ border-left:none; padding-left:0; border-bottom:2px solid transparent; } .doc-toc a.active{ border-color:var(--accent); } }

.doc-body{ max-width:680px; }
.doc-body h2{ font-size:clamp(21px,2.8vw,26px); margin:44px 0 14px; scroll-margin-top:84px; }
.doc-body h2:first-child{ margin-top:0; }
.doc-body h3{ font-family:var(--mono-display); font-size:17px; margin:28px 0 10px; scroll-margin-top:84px; }
.doc-body p{ color:var(--ink-soft); margin:0 0 16px; font-size:16px; line-height:1.65; }
.doc-body p strong{ color:var(--ink); font-weight:600; }
.doc-body ul, .doc-body ol{ color:var(--ink-soft); font-size:16px; line-height:1.65; margin:0 0 16px; padding-left:22px; }
.doc-body li{ margin-bottom:6px; }
.doc-body li strong{ color:var(--ink); font-weight:600; }
.doc-body code{ background:var(--bg-raise); border:1px solid var(--line-soft); padding:1px 5px; border-radius:2px; font-size:.9em; }
.doc-body a{ color:var(--accent-ink); text-decoration-color:var(--line); text-underline-offset:2px; }
.doc-body a:hover{ text-decoration-color:var(--accent); }

/* "in plain terms" — a quick, non-technical restatement set apart from the
   surrounding detail, not a replacement for it. */
.plain{
  background:var(--bg-raise); border-left:3px solid var(--accent); border-radius:0 4px 4px 0;
  padding:14px 18px; margin:18px 0; font-size:15px; color:var(--ink-soft); line-height:1.55;
}
.plain b{ color:var(--accent-ink); font-family:var(--mono-code); font-size:11.5px; text-transform:uppercase; letter-spacing:.05em; display:block; margin-bottom:6px; font-weight:600; }

/* a neutral note box for asides that aren't a plain-language restatement —
   caveats, "confirmed by running it", cross-references */
.note{
  background:var(--bg-sunken); border:1px solid var(--line); border-radius:4px;
  padding:14px 18px; margin:18px 0; font-size:14.5px; color:var(--ink-soft); line-height:1.55;
}
.note b{ color:var(--ink); }

.doc-code{
  background:var(--ink); border-radius:var(--radius); overflow-x:auto;
  padding:14px 16px; margin:14px 0 18px; font-family:var(--mono-code); font-size:13px;
  color:var(--bg-raise); line-height:1.65; white-space:pre;
}
.doc-code .t-dim{ opacity:.55; }
.doc-code .t-prompt{ color:var(--accent); }

/* command reference cards */
.cmd-card{ border:1px solid var(--line); border-radius:6px; padding:20px 22px; margin-bottom:16px; scroll-margin-top:84px; }
.cmd-card-head{ display:flex; align-items:baseline; gap:12px; flex-wrap:wrap; margin-bottom:8px; }
.cmd-name{ font-family:var(--mono-display); font-weight:700; font-size:18px; }
.cmd-alias{ font-family:var(--mono-code); font-size:12px; color:var(--ink-soft); }
.cmd-group{ font-family:var(--mono-code); font-size:11px; text-transform:uppercase; letter-spacing:.05em; color:var(--accent-ink); background:var(--accent-bg); padding:2px 7px; border-radius:2px; margin-left:auto; }
.cmd-usage{ font-family:var(--mono-code); font-size:13.5px; color:var(--ink-soft); background:var(--bg-raise); border-radius:3px; padding:8px 12px; margin:0 0 12px; overflow-x:auto; }
.cmd-desc{ font-size:15px; color:var(--ink-soft); line-height:1.6; margin:0 0 10px; }
.cmd-flags{ font-size:13.5px; }
.cmd-flags dt{ font-family:var(--mono-code); color:var(--ink); float:left; clear:left; width:200px; margin-bottom:6px; }
.cmd-flags dd{ margin:0 0 6px 210px; color:var(--ink-soft); }
@media (max-width:600px){ .cmd-flags dt{ float:none; width:auto; } .cmd-flags dd{ margin-left:0; margin-bottom:12px; } }

.cmd-jump{ display:flex; flex-wrap:wrap; gap:8px; margin:0 0 32px; }
.cmd-jump a{
  font-family:var(--mono-code); font-size:12.5px; text-decoration:none; color:var(--ink-soft);
  border:1px solid var(--line); border-radius:3px; padding:4px 9px; transition:border-color .15s, color .15s;
}
.cmd-jump a:hover{ color:var(--ink); border-color:var(--accent); }