/* ============================================================
   STAGWIFHOOD ($STAG) — docs.css
   Documentation + How-To layout. Uses tokens from style.css
   (--gold, --muted, --ink, --line, --panel, etc.) — no new colors.
   ============================================================ */

/* ---------- page shell ---------- */
.doc-wrap{max-width:var(--maxw);margin:0 auto;padding:6.6rem clamp(1rem,4vw,2.5rem) 2rem}
.doc-head{max-width:820px;margin:0 auto 2.2rem;text-align:center}
.doc-head h1{font-family:'Cinzel',serif;font-weight:900;line-height:1.04;
  font-size:clamp(2rem,5vw,3.2rem);margin:.4rem 0 .8rem}
.doc-head p{color:var(--muted);font-size:clamp(1rem,1.4vw,1.12rem);max-width:60ch;margin:0 auto}
.doc-meta{display:flex;gap:.5rem .8rem;flex-wrap:wrap;justify-content:center;margin-top:1.1rem}
.doc-meta .tagpill{font-family:'Space Grotesk',monospace;font-size:.72rem;letter-spacing:.06em;
  color:var(--gold-lite);background:rgba(230,184,63,.1);border:1px solid var(--line);
  border-radius:100px;padding:.35em .9em}

/* ---------- cross-page CTA banner ---------- */
.doc-cta{display:flex;align-items:center;gap:1rem;flex-wrap:wrap;max-width:920px;margin:0 auto 2.4rem;
  padding:1.1rem 1.4rem;border:1px solid var(--line);border-radius:16px;
  background:linear-gradient(120deg,rgba(230,184,63,.09),rgba(14,36,21,.5))}
.doc-cta-ic{flex:none;width:42px;height:42px;border-radius:12px;display:grid;place-items:center;
  background:rgba(230,184,63,.14);color:var(--gold-lite);border:1px solid var(--line)}
.doc-cta-txt{flex:1;min-width:220px}
.doc-cta-txt b{display:block;font-family:'Cinzel',serif;font-weight:700;font-size:1.05rem;color:var(--ink)}
.doc-cta-txt span{font-size:.86rem;color:var(--muted)}
.doc-cta .btn{flex:none;white-space:nowrap}

/* ---------- layout: TOC + content ---------- */
.doc-layout{display:grid;grid-template-columns:250px 1fr;gap:2.4rem;align-items:start;max-width:var(--maxw);margin:0 auto}

/* ---------- sticky table of contents ---------- */
.doc-toc{position:sticky;top:calc(40px + 70px);align-self:start;
  background:rgba(9,24,14,.6);border:1px solid var(--line);border-radius:16px;
  padding:1.1rem 1.1rem;box-shadow:0 24px 60px -34px rgba(0,0,0,.85);backdrop-filter:blur(10px)}
.doc-toc-title{font-family:'Space Grotesk',monospace;font-size:.68rem;letter-spacing:.18em;
  text-transform:uppercase;color:var(--gold);margin-bottom:.7rem}
.doc-toc ol{list-style:none;counter-reset:toc;display:flex;flex-direction:column;gap:.05rem}
.doc-toc a{display:flex;gap:.55rem;align-items:baseline;font-size:.86rem;color:var(--muted);
  padding:.42em .55em;border-radius:9px;transition:.18s;line-height:1.35;border-left:2px solid transparent}
.doc-toc a::before{counter-increment:toc;content:counter(toc,decimal-leading-zero);
  font-family:'Space Grotesk',monospace;font-size:.68rem;color:var(--gold-deep);flex:none}
.doc-toc a:hover{color:var(--gold-lite);background:rgba(230,184,63,.06)}
.doc-toc a.active{color:var(--gold-lite);background:rgba(230,184,63,.1);border-left-color:var(--gold)}
.doc-toc a.active::before{color:var(--gold)}
.doc-toc-foot{margin-top:.9rem;padding-top:.8rem;border-top:1px solid var(--line)}
.doc-toc-foot a{display:block;font-size:.8rem;color:var(--gold-lite);padding:.3em 0}
.doc-toc-foot a::before{content:none}

/* mobile TOC: collapses to a <details> at the top */
.doc-toc-mobile{display:none;max-width:var(--maxw);margin:0 auto 1.6rem}
.doc-toc-mobile summary{cursor:pointer;list-style:none;font-family:'Space Grotesk',monospace;
  font-size:.8rem;letter-spacing:.08em;text-transform:uppercase;color:var(--gold);
  background:rgba(9,24,14,.7);border:1px solid var(--line);border-radius:12px;padding:.8rem 1rem;
  display:flex;align-items:center;justify-content:space-between}
.doc-toc-mobile summary::-webkit-details-marker{display:none}
.doc-toc-mobile summary::after{content:"▾";color:var(--gold-lite)}
.doc-toc-mobile[open] summary::after{content:"▴"}
.doc-toc-mobile ol{list-style:none;counter-reset:toc;margin-top:.5rem;
  background:rgba(9,24,14,.6);border:1px solid var(--line);border-radius:12px;padding:.6rem}
.doc-toc-mobile a{display:block;font-size:.88rem;color:var(--muted);padding:.5em .6em;border-radius:8px}
.doc-toc-mobile a::before{counter-increment:toc;content:counter(toc,decimal-leading-zero) "  ";
  color:var(--gold-deep);font-family:'Space Grotesk',monospace;font-size:.72rem}
.doc-toc-mobile a:hover{color:var(--gold-lite);background:rgba(230,184,63,.06)}

/* ---------- content column ---------- */
.doc-content{min-width:0}
.doc-section{scroll-margin-top:calc(40px + 76px);padding:1.6rem 0 1.9rem;border-top:1px solid var(--line)}
.doc-section:first-child{border-top:0;padding-top:.2rem}
.doc-section > h2{font-family:'Cinzel',serif;font-weight:900;font-size:clamp(1.5rem,3vw,2.1rem);
  line-height:1.12;margin-bottom:.4rem;scroll-margin-top:calc(40px + 76px);position:relative}
.doc-kicker{display:inline-block;font-family:'Space Grotesk',monospace;font-size:.7rem;letter-spacing:.22em;
  text-transform:uppercase;color:var(--gold);margin-bottom:.6rem}
.doc-section h3{font-family:'Cinzel',serif;font-weight:700;font-size:1.2rem;margin:1.5rem 0 .5rem;color:var(--ink)}
.doc-section p{color:var(--muted);margin:.6rem 0;line-height:1.7;font-size:.98rem}
.doc-section p strong,.doc-section li strong{color:var(--ink);font-weight:700}
.doc-section a.inl{color:var(--gold-lite);border-bottom:1px solid rgba(230,184,63,.4)}
.doc-section a.inl:hover{color:var(--gold);border-color:var(--gold)}
.doc-section ul.doc-list{list-style:none;display:grid;gap:.55rem;margin:.8rem 0 .4rem}
.doc-section ul.doc-list li{position:relative;padding-left:1.5rem;color:var(--muted);line-height:1.6;font-size:.96rem}
.doc-section ul.doc-list li::before{content:"";position:absolute;left:.2rem;top:.62em;width:6px;height:6px;
  border-radius:50%;background:var(--grad-gold);box-shadow:0 0 8px rgba(230,184,63,.5)}

/* anchor link on hover */
.doc-anchor{margin-left:.5rem;font-size:.7em;color:var(--gold-deep);opacity:0;transition:.2s;font-weight:400}
.doc-section > h2:hover .doc-anchor{opacity:1}
.doc-anchor:hover{color:var(--gold)}

/* ---------- feature grid (sub-cards) ---------- */
.doc-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:.9rem;margin:1.1rem 0}
.doc-mini{background:linear-gradient(180deg,var(--panel),var(--panel-2));border:1px solid var(--line);
  border-radius:14px;padding:1.1rem 1.2rem}
.doc-mini h4{font-family:'Space Grotesk',monospace;font-size:.74rem;letter-spacing:.08em;text-transform:uppercase;
  color:var(--gold-lite);margin-bottom:.5rem}
.doc-mini p{margin:0;font-size:.9rem;color:var(--muted)}
.doc-mini .big{font-family:'Space Grotesk',monospace;font-weight:700;font-size:1.3rem;color:var(--gold-lite);display:block;margin-bottom:.2rem}

/* ---------- reference table ---------- */
.doc-table-wrap{overflow-x:auto;margin:1.1rem 0;border:1px solid var(--line);border-radius:14px;
  box-shadow:0 24px 60px -34px rgba(0,0,0,.8)}
.doc-table{width:100%;border-collapse:collapse;min-width:560px;background:rgba(9,24,14,.5)}
.doc-table caption{caption-side:bottom;color:var(--muted);font-size:.76rem;padding:.7rem;text-align:left;font-style:italic}
.doc-table th,.doc-table td{text-align:left;padding:.8rem .9rem;border-bottom:1px solid var(--line);vertical-align:middle}
.doc-table thead th{font-family:'Space Grotesk',monospace;font-size:.68rem;letter-spacing:.1em;text-transform:uppercase;
  color:var(--gold);background:rgba(230,184,63,.05);white-space:nowrap}
.doc-table tbody tr:last-child td{border-bottom:0}
.doc-table tbody tr:hover{background:rgba(230,184,63,.04)}
.doc-table .t-name{font-family:'Cinzel',serif;font-weight:700;color:var(--ink);white-space:nowrap}
.doc-table .t-name small{display:block;font-family:'Inter',sans-serif;font-weight:500;color:var(--muted);font-size:.72rem;margin-top:.15rem;text-transform:none;letter-spacing:0}

/* ---------- monospace address pill w/ copy ---------- */
.addr{display:inline-flex;align-items:center;gap:.5rem;font-family:'Space Grotesk',monospace;font-size:.78rem;
  color:var(--gold-lite);background:rgba(0,0,0,.32);border:1px solid var(--line);border-radius:100px;
  padding:.28em .32em .28em .8em;max-width:100%}
.addr code{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;min-width:0}
.addr .addr-copy{flex:none;font-family:'Space Grotesk',monospace;font-size:.66rem;font-weight:700;
  color:var(--gold-lite);background:rgba(230,184,63,.14);border:1px solid var(--line);border-radius:100px;
  padding:.35em .7em;cursor:pointer;transition:.18s}
.addr .addr-copy:hover{background:var(--gold);color:#241708}
.addr .addr-copy.ok{background:var(--green-lite);color:#08160b}
.addr .addr-ext{flex:none;color:var(--gold-lite);font-size:.8rem;padding:0 .2em;opacity:.8}
.addr .addr-ext:hover{opacity:1;color:var(--gold)}
.addr.full code{white-space:normal;word-break:break-all}
td .addr{background:transparent;border:0;padding:0;gap:.4rem}

/* ---------- callouts ---------- */
.doc-note,.doc-warn{display:flex;gap:.8rem;margin:1.2rem 0;padding:1rem 1.1rem;border-radius:14px;
  border:1px solid var(--line);font-size:.92rem;line-height:1.6}
.doc-note{background:rgba(47,107,57,.12);border-color:rgba(90,168,105,.32)}
.doc-warn{background:rgba(230,184,63,.08);border-color:rgba(230,184,63,.4)}
.doc-note .ic,.doc-warn .ic{flex:none;font-size:1.1rem;line-height:1.5}
.doc-note b,.doc-warn b{color:var(--ink)}
.doc-note p,.doc-warn p{margin:0;color:var(--muted)}
.doc-warn p{color:var(--cream)}

/* ---------- numbered how-to steps ---------- */
.doc-steps{list-style:none;counter-reset:step;display:flex;flex-direction:column;gap:.9rem;margin:1.2rem 0}
.doc-steps > li{position:relative;padding:1.1rem 1.2rem 1.1rem 3.6rem;
  background:linear-gradient(180deg,var(--panel),var(--panel-2));border:1px solid var(--line);border-radius:14px;
  box-shadow:0 20px 50px -34px rgba(0,0,0,.85)}
.doc-steps > li::before{counter-increment:step;content:counter(step);
  position:absolute;left:1rem;top:1.05rem;width:32px;height:32px;border-radius:50%;
  display:grid;place-items:center;background:var(--grad-gold);color:#241708;
  font-family:'Space Grotesk',monospace;font-weight:700;font-size:.95rem;
  box-shadow:0 8px 20px -8px rgba(230,184,63,.6),inset 0 1px 0 rgba(255,255,255,.5)}
.doc-steps > li b{color:var(--ink);font-family:'Space Grotesk',monospace;font-size:.95rem;letter-spacing:.01em}
.doc-steps > li .s-body{color:var(--muted);font-size:.94rem;line-height:1.65;margin-top:.35rem}
.doc-steps > li .s-body p{margin:.5rem 0 0}
.doc-steps ul{list-style:none;margin:.6rem 0 0;display:grid;gap:.4rem}
.doc-steps ul li{position:relative;padding-left:1.3rem;color:var(--muted);font-size:.9rem;line-height:1.55}
.doc-steps ul li::before{content:"→";position:absolute;left:0;color:var(--gold-deep)}
.doc-steps .kbd{font-family:'Space Grotesk',monospace;font-size:.82rem;color:var(--gold-lite);
  background:rgba(230,184,63,.12);border:1px solid var(--line);border-radius:7px;padding:.1em .5em}

/* ---------- revenue-flow diagram (pure CSS) ---------- */
.flow{display:flex;align-items:stretch;gap:.7rem;flex-wrap:wrap;justify-content:center;margin:1.4rem 0}
.flow-node{flex:1;min-width:150px;max-width:230px;text-align:center;
  background:linear-gradient(180deg,var(--panel),var(--panel-2));border:1px solid var(--line);border-radius:14px;
  padding:1.1rem .9rem;display:flex;flex-direction:column;gap:.35rem;justify-content:center}
.flow-node.src{border-color:rgba(90,168,105,.35)}
.flow-node.hub{border-color:var(--gold)}
.flow-node.pool{border-color:rgba(140,230,90,.4)}
.flow-node .fn-ic{font-size:1.5rem}
.flow-node .fn-t{font-family:'Cinzel',serif;font-weight:700;font-size:1rem;color:var(--ink)}
.flow-node .fn-s{font-size:.78rem;color:var(--muted)}
.flow-node .fn-pct{font-family:'Space Grotesk',monospace;font-weight:700;color:var(--gold-lite)}
.flow-arrow{flex:none;display:grid;place-items:center;color:var(--gold);font-size:1.4rem;font-weight:700}
.flow-split{display:flex;flex-direction:column;gap:.7rem;flex:1;min-width:150px;max-width:230px}
.flow-badge{display:inline-block;font-family:'Space Grotesk',monospace;font-size:.66rem;letter-spacing:.08em;
  text-transform:uppercase;color:#241708;background:var(--grad-gold);border-radius:100px;padding:.2em .7em;font-weight:800;margin-bottom:.2rem;align-self:center}
@media(max-width:720px){
  .flow{flex-direction:column;align-items:stretch}
  .flow-node,.flow-split{max-width:none}
  .flow-arrow{transform:rotate(90deg)}
}

/* ---------- bubble-map legend mini ---------- */
.map-legend{display:flex;flex-wrap:wrap;gap:.6rem .9rem;margin:1rem 0;padding:.9rem 1.1rem;
  background:rgba(9,24,14,.5);border:1px solid var(--line);border-radius:12px}
.map-legend .ml{display:flex;align-items:center;gap:.5rem;font-size:.84rem;color:var(--muted)}
.map-legend .mdot{width:12px;height:12px;border-radius:50%;flex:none}
.mdot-cluster{background:#e6b83f;box-shadow:0 0 10px rgba(230,184,63,.6)}
.mdot-fund{background:#8ce65a;box-shadow:0 0 10px rgba(140,230,90,.5)}
.mdot-solo{background:rgba(150,190,150,.7)}
.mdot-ct{background:#6fa8ff}

/* ---------- responsive ---------- */
@media (max-width:960px){
  .doc-layout{grid-template-columns:1fr}
  .doc-toc{display:none}
  .doc-toc-mobile{display:block}
}
@media (max-width:520px){
  .doc-wrap{padding-top:6rem}
  .doc-steps > li{padding-left:1.1rem;padding-top:3.4rem}
  .doc-steps > li::before{top:1rem}
}