/* Docs page (docs.html). Tokens, type, buttons, header and footer come from assets/site.css; this file only lays out the docs:
   the table of contents (a sticky bar on a phone, the left column from 1040 px), the sections, the OS tabs, command blocks with Copy,
   the how-to parts with their video slots, the troubleshooting list and the feedback form. Square corners and hard shadows, as everywhere. */

/* anchors land below the header and the sticky contents bar */
html{scroll-padding-top:calc(var(--head-h) + 62px)}
/* a block on a phone, not a grid: a sticky grid item could not stick past its own row */
.docs{display:block;padding-top:28px;padding-bottom:24px}
.docs>*{min-width:0}
.docs-intro{padding-bottom:20px}
.docs-intro h1{font-size:clamp(2rem,7vw,3.4rem);letter-spacing:-.045em;margin-bottom:12px}
.docs-intro h1::after{content:"_";color:var(--r1);margin-left:.08em;animation:blink 1.1s steps(1,end) infinite}
@keyframes blink{50%{opacity:0}}
.lede{color:var(--dim);max-width:62ch;font-size:15.5px;margin:0}
.lede strong{color:var(--ink)}

/* ---- table of contents ---- */
.toc{position:sticky;top:0;z-index:40;margin:0 calc(var(--gut) * -1);transition:top .28s cubic-bezier(.2,.8,.3,1)}
/* while the shared header is showing, sit just under it; when it slides away, take the top */
.site-head:not(.away)~main .toc{top:calc(var(--head-h) + 2px)}
.toc-box{background:var(--bg-2);border-top:2px solid var(--line);border-bottom:2px solid var(--line-2)}
.toc-box summary{list-style:none;cursor:pointer;display:flex;align-items:center;gap:10px;min-height:48px;padding:8px var(--gut);font-size:12px;letter-spacing:.12em;text-transform:uppercase;color:var(--dim)}
.toc-box summary::-webkit-details-marker{display:none}
.toc-box summary::after{content:"";margin-left:auto;width:8px;height:8px;border-right:2px solid currentColor;border-bottom:2px solid currentColor;transform:rotate(45deg) translateY(-2px);flex:none}
.toc-box[open] summary::after{transform:rotate(225deg) translate(-2px,0)}
.toc-label{flex:none;font-weight:700}
.toc-now{text-transform:none;letter-spacing:0;font-size:13px;color:var(--ink);font-weight:700;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;min-width:0}
.toc-now:not(:empty)::before{content:"/ ";color:var(--dim);font-weight:400}
/* on a phone the open list drops over the page, so opening or closing it never moves what you are reading */
.toc-box{position:relative}
.toc-drop{position:absolute;left:0;right:0;top:100%;background:var(--bg-2);border-bottom:2px solid var(--line-2);box-shadow:0 8px 0 rgba(0,0,0,.25);max-height:calc(100vh - var(--head-h) - 70px);overflow:auto;overscroll-behavior:contain}
.toc-list{list-style:none;margin:0;padding:4px var(--gut) 8px}
.toc-list a{display:flex;align-items:baseline;gap:10px;min-height:40px;padding:9px 0 9px 10px;color:var(--ink);text-decoration:none;font-size:14px;border-left:2px solid var(--line)}
.toc-list a span{color:var(--dim);font-size:11px;letter-spacing:.06em;flex:none}
.toc-list a:hover{border-left-color:var(--accent)}
.toc-list a[aria-current="true"]{border-left-color:var(--r1);font-weight:700;background:linear-gradient(90deg,color-mix(in srgb,var(--r1) 12%,transparent),transparent 70%)}
.toc-list a[aria-current="true"] span{color:var(--r1)}
.toc-os{margin:0;padding:10px var(--gut) 14px;font-size:12.5px;color:var(--dim);border-top:1px dashed var(--line)}
.toc-os strong{color:var(--ink)}

/* ---- sections ---- */
.doc{max-width:800px}
.dsec{padding-top:44px;padding-bottom:12px}
.dsec+.dsec{border-top:2px solid var(--line);margin-top:28px}
.dsec-n{font-size:11px;letter-spacing:.16em;text-transform:uppercase;color:var(--accent-text);margin:0 0 10px;font-weight:700}
.dsec h2{font-size:clamp(1.6rem,5vw,2.4rem);letter-spacing:-.035em;margin-bottom:16px}
.dsec>p,.part>p{max-width:68ch}
.dsec h3{font-size:clamp(1.1rem,3vw,1.3rem);margin:22px 0 10px}
.aside{color:var(--dim);font-size:13px}
.os-note{color:var(--dim);font-size:13px;border-left:3px solid var(--line-2);padding:4px 0 4px 12px;margin:8px 0}

.need{margin:18px 0 6px;display:grid;gap:0;border-top:2px solid var(--line)}
.need>div{display:grid;gap:2px;padding:12px 0;border-bottom:1px dashed var(--line)}
.need dt{font-weight:700}
.need dd{margin:0;color:var(--dim)}

.spec{margin:0;display:grid;gap:0;border-top:2px solid var(--line)}
.spec>div{display:grid;gap:4px;padding:14px 0;border-bottom:1px dashed var(--line);min-width:0}
.spec>div>*{min-width:0}
.spec dt{font-weight:700;font-size:15px}
.spec dd{margin:0;color:var(--dim);max-width:68ch}
.spec-agents dt a{overflow-wrap:anywhere}
.tag-inline{margin:0 0 0 6px;font-size:10px;padding:2px 6px;border:1px solid currentColor;vertical-align:middle;letter-spacing:.12em}

/* the two ways to run it */
.ways{display:grid;gap:16px;margin:18px 0 26px}
.ways>*{min-width:0}
.way{background:var(--card);border:2px solid var(--line-2);box-shadow:var(--shadow);padding:18px}
.way h3{font-size:19px;margin:0 0 10px}
.way p{color:var(--dim)}
.ticks{list-style:none;margin:0;padding:0}
.ticks li{position:relative;padding:6px 0 6px 20px;font-size:13.5px;border-top:1px dashed var(--line)}
.ticks li::before{content:"";position:absolute;left:2px;top:13px;width:8px;height:8px;background:var(--accent)}
.ticks li.warn{color:var(--warn)}
.ticks li.warn::before{background:var(--warn);transform:rotate(45deg)}

/* ---- OS tabs: which steps show (site docs.js sets .os-on on every [data-show] that names the picked computer) ---- */
.pick-h{margin-top:28px!important}
.os-tabs{display:flex;flex-wrap:wrap;gap:0;border-bottom:2px solid var(--line-2);margin-bottom:8px}
.os-tabs button{min-height:44px;padding:8px 14px;background:transparent;color:var(--dim);border:2px solid transparent;border-bottom:0;margin-bottom:-2px;
  font:700 13.5px/1 var(--mono);cursor:pointer}
.os-tabs button:hover{color:var(--ink)}
.os-tabs button small{font-weight:500;font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--dim);margin-left:4px}
.os-tabs button[aria-selected="true"]{color:var(--ink);background:var(--card);border-color:var(--line-2);border-bottom:2px solid var(--card);box-shadow:inset 0 3px 0 var(--r1)}
.os-detected{font-size:12px;color:var(--dim);margin:0 0 18px;min-height:1.2em}
.js [data-show]:not(.os-on){display:none!important}

/* ---- a how-to part: its video slot, then the steps ---- */
.part{display:grid;gap:4px;background:var(--card);border:2px solid var(--line-2);box-shadow:var(--shadow);padding:16px;margin-top:6px}
.part>*{min-width:0}
.part>h3:first-of-type{margin-top:14px}
.video{position:relative;margin:0;background:var(--well);border:1px solid var(--line);aspect-ratio:16/9;overflow:hidden;display:grid;place-items:center}
.video img{position:absolute;inset:7% 0;width:100%;height:86%;object-fit:contain;filter:drop-shadow(6px 6px 0 rgba(0,0,0,.35))}
.video::before{content:"";position:absolute;inset:0;background:repeating-linear-gradient(135deg,transparent 0 10px,var(--dot) 10px 12px)}
.video figcaption{position:absolute;left:10px;bottom:10px;display:flex;align-items:center;gap:8px;background:var(--bg);color:var(--ink);
  border:1px solid var(--line-2);padding:6px 10px 6px 8px;font-size:12px;font-weight:700;letter-spacing:.04em}
.play{width:0;height:0;border-left:10px solid var(--r1);border-top:6px solid transparent;border-bottom:6px solid transparent}
.steps{margin:6px 0 4px;padding-left:1.6em}
.steps li{margin:0 0 14px;padding-left:4px}
.steps li::marker{color:var(--accent-text);font-weight:700}

/* ---- command blocks: a command wraps inside its box, never past it, and each block has a Copy button ---- */
.cmd{margin:8px 0 2px;padding:12px 14px;background:var(--well);border-left:3px solid var(--accent);font-size:13px;line-height:1.5;color:var(--ink);max-width:100%;
  white-space:pre-wrap;overflow-wrap:anywhere}
.cmd code{background:none;padding:0;white-space:pre-wrap;overflow-wrap:anywhere}
/* a wrapped line hangs in from its start: a cue that it is still one command */
.cmd .ln{display:block;padding-left:2ch;text-indent:-2ch}
.cmd-wrap{position:relative;margin:8px 0 10px;max-width:100%}
.cmd-wrap .cmd{margin:0;padding-right:76px}
.copy{position:absolute;top:6px;right:6px;min-height:32px;min-width:58px;padding:5px 9px;font:700 11.5px/1 var(--mono);letter-spacing:.04em;color:var(--ink);background:var(--card);
  border:1px solid var(--line-2);cursor:pointer}
.copy:hover{border-color:var(--ink)}
.copy.done{color:var(--accent-ink);background:var(--accent);border-color:var(--accent)}
.soon{background:var(--well);border:2px dashed var(--line-2);padding:20px}
.soon h3{font-size:19px;margin:0 0 10px!important}
.soon p{color:var(--dim);max-width:64ch}
.soon p:last-child{margin-bottom:0}

/* ---- troubleshooting ---- */
.faq{border-top:2px solid var(--line);margin:8px 0 18px}
.faq details{border-bottom:1px dashed var(--line)}
.faq summary{list-style:none;cursor:pointer;position:relative;display:block;min-height:48px;padding:12px 0 12px calc(1.2em + 12px);font-weight:700}
.faq summary::-webkit-details-marker{display:none}
.faq summary::before{content:"+";position:absolute;left:0;top:12px;width:1.2em;color:var(--accent-text);font-weight:700}
.faq details[open] summary::before{content:"-"}
.faq summary:hover{color:var(--accent-text)}
.faq details>:not(summary){margin-left:calc(1.2em + 12px)}
.faq details>p{color:var(--dim);max-width:66ch}
.faq details[open]{padding-bottom:6px}
.faq details:target{background:linear-gradient(90deg,color-mix(in srgb,var(--r1) 10%,transparent),transparent 80%)}

/* ---- feedback ---- */
.fb{display:grid;gap:20px;margin-top:14px}
.fb>*{min-width:0}
.fb-form{display:grid;gap:14px;max-width:640px}
.field{display:grid;gap:6px;min-width:0}
.field-row{display:grid;gap:14px}
.fb label{font-size:13px;font-weight:700}
.opt{font-weight:400;color:var(--dim);font-size:12px}
.fb input,.fb select,.fb textarea{width:100%;font:400 15px/1.4 var(--mono);color:var(--ink);background:var(--well);border:2px solid var(--line-2);border-radius:0;padding:10px 12px;min-height:44px}
.fb textarea{resize:vertical;min-height:120px}
.fb input:focus,.fb select:focus,.fb textarea:focus{border-color:var(--accent);outline:none;box-shadow:0 0 0 2px var(--focus)}
.fb [aria-invalid="true"]{border-color:var(--warn)}
.err{margin:0;color:var(--warn);font-size:12.5px;min-height:1em}
.fb-form .btn{justify-self:start}
.fb-out{background:var(--card);border:2px solid var(--accent);box-shadow:var(--shadow);padding:18px;min-width:0}
.fb-out h3{font-size:18px;margin:0 0 8px}
.fb-out pre{white-space:pre-wrap;overflow-wrap:anywhere;max-height:360px;overflow:auto}
.fb-actions{display:flex;flex-wrap:wrap;gap:10px;margin-top:12px}

/* on a phone the Copy button sits in a strip above the command, so the command gets the box's whole width */
@media (max-width:639px){
  .part{padding:14px 12px}
  .steps{padding-left:1.4em}
  .cmd-wrap .cmd{padding:42px 12px 12px}
  .cmd-wrap .cmd::before{content:"";position:absolute;left:3px;right:0;top:0;height:38px;border-bottom:1px dashed var(--line)}
  .cmd-wrap{position:relative}
}
@media (min-width:640px){
  .ways{grid-template-columns:1fr 1fr}
  .field-row{grid-template-columns:1fr 1fr}
  .part{padding:20px}
  .video{max-width:560px}
}

/* From 1040 px: the contents are the left column, always open, and stay in view. */
@media (min-width:1040px){
  html{scroll-padding-top:calc(var(--head-h) + 20px)}
  .docs{display:grid;grid-template-columns:232px minmax(0,1fr);column-gap:56px;padding-top:44px}
  .docs-intro{grid-column:2;grid-row:1}
  .toc{grid-column:1;grid-row:1/span 2;align-self:start;margin:0;top:24px;padding-top:6px}
  .site-head:not(.away)~main .toc{top:calc(var(--head-h) + 24px)}
  .doc{grid-column:2}
  .toc-box{background:none;border:0}
  .toc-box summary{pointer-events:none;padding:0 0 10px;min-height:0}
  .toc-box summary::after,.toc-now{display:none}
  .toc-drop{position:static;background:none;border:0;box-shadow:none;max-height:none;overflow:visible}
  .toc-list{padding:0}
  .toc-os{padding:14px 0 0;margin-top:10px}
  .fb{grid-template-columns:minmax(0,1fr)}
}

@media (prefers-reduced-motion:reduce){
  .docs-intro h1::after{animation:none}
  .toc{transition:none}
}
.todo-inline{display:inline-block;margin-left:4px;padding:0 6px;border:1px dashed var(--warn);color:var(--warn);font-size:12px}