/* ============================================================
   English Opera · 讲义 / Handbook — documentation layout
   Swiss International Style, token-driven. Linked BEFORE swiss.css
   so swiss.css tokens win; values here carry Swiss fallbacks so the
   page is correct even standalone. Structure/data decoupled.
   ============================================================ */

:root{
  --doc-side-w: 250px;
  --doc-toc-w: 220px;
  --doc-top: 66px;            /* sticky offset under the top bar */
  --doc-max: none;            /* full-bleed layout */
  --doc-pad: 48px;            /* page side padding */
  --doc-measure: 900px;       /* article readability cap inside the column */
}

*{box-sizing:border-box}

body{
  margin:0;
  background:var(--cl-bg,#fff);
  color:var(--cl-text,#111);
  font-family:var(--eo-grotesk,"Helvetica Neue",Helvetica,Arial,"PingFang SC","Microsoft YaHei",sans-serif);
  -webkit-font-smoothing:antialiased;
}

/* ---- hero strip ---- */
.docs-hero{
  max-width:var(--doc-max);
  margin:0 auto;
  padding:40px var(--doc-pad) 6px;
}
.docs-hero__eyebrow{
  letter-spacing:5px;text-transform:uppercase;font-size:.72rem;
  color:var(--cl-accent,#e2231a);margin:0 0 12px;font-weight:700;
}
.docs-hero__title{
  font-size:clamp(1.7rem,4vw,2.5rem);line-height:1.05;margin:0 0 10px;font-weight:800;letter-spacing:-.5px;
}
.docs-hero__title small{display:block;font-size:.42em;font-weight:600;letter-spacing:.04em;color:var(--cl-text-dim,#6b6b6b);margin-top:8px}
.docs-hero__sub{max-width:64ch;color:var(--cl-text-dim,#6b6b6b);font-size:.98rem;line-height:1.7;margin:0}

/* ---- 3-column shell ---- */
.docs{
  max-width:var(--doc-max);
  margin:0 auto;
  padding:22px var(--doc-pad) 60px;
  display:grid;
  grid-template-columns:var(--doc-side-w) minmax(0,1fr) var(--doc-toc-w);
  gap:44px;
  align-items:start;
}

/* ---- left sidebar (chapter list) ---- */
.docs__side{position:sticky;top:var(--doc-top);align-self:start}
.docs__side-title,.docs__toc-title{
  font-size:.7rem;letter-spacing:3px;text-transform:uppercase;
  color:var(--cl-text-dim,#6b6b6b);font-weight:700;
  padding:0 0 10px;margin:0 0 8px;border-bottom:2px solid var(--cl-text,#111);
}
.docs__nav{display:flex;flex-direction:column}
.docs__nav a{
  display:block;text-decoration:none;color:var(--cl-text,#111);
  padding:10px 12px;border-left:3px solid transparent;
  transition:background .15s,border-color .15s,color .15s;
}
.docs__nav a small{display:block;font-size:.76rem;color:var(--cl-text-dim,#6b6b6b);margin-top:2px;font-weight:400}
.docs__nav a b{font-weight:700;font-size:.95rem}
.docs__nav a:hover{background:var(--cl-bg-2,#f4f4f1)}
.docs__nav a.is-active{
  border-left-color:var(--cl-accent,#e2231a);
  background:var(--cl-bg-2,#f4f4f1);
}
.docs__nav a.is-active b{color:var(--cl-accent,#e2231a)}

/* ---- main article ---- */
.docs__main{min-width:0}
.docs__crumb{
  font-size:.76rem;letter-spacing:1px;text-transform:uppercase;
  color:var(--cl-text-dim,#6b6b6b);margin:0 0 18px;
}
.docs__crumb b{color:var(--cl-accent,#e2231a);font-weight:700}

/* article typography */
.docs__article{font-size:.98rem;line-height:1.78;color:var(--cl-text,#111);max-width:var(--doc-measure);margin:0 auto;overflow-wrap:break-word;word-break:break-word}

/* mobile chapter <select> (hidden on desktop) */
.docs__nav-select{
  display:none;
  width:100%;margin:0 0 14px;padding:11px 14px;
  font:inherit;font-size:.95rem;color:var(--cl-text,#111);
  background:var(--cl-bg,#fff);border:1px solid var(--cl-border,#d8d8d2);
  border-radius:0;appearance:none;-webkit-appearance:none;
  background-image:linear-gradient(45deg,transparent 50%,var(--cl-text,#111) 50%),linear-gradient(135deg,var(--cl-text,#111) 50%,transparent 50%);
  background-position:calc(100% - 18px) 50%,calc(100% - 13px) 50%;
  background-size:5px 5px,5px 5px;background-repeat:no-repeat;
}
.docs__article > :first-child{margin-top:0}
.docs__article h1{
  font-size:clamp(1.5rem,3.4vw,2rem);line-height:1.12;font-weight:800;
  letter-spacing:-.4px;margin:0 0 20px;padding-bottom:14px;
  border-bottom:3px solid var(--cl-accent,#e2231a);
}
.docs__article h2{
  font-size:1.3rem;font-weight:800;line-height:1.2;margin:44px 0 14px;
  padding-top:20px;border-top:1px solid var(--cl-border,#d8d8d2);scroll-margin-top:calc(var(--doc-top) + 14px);
}
.docs__article h3{
  font-size:1.06rem;font-weight:700;margin:28px 0 10px;
  scroll-margin-top:calc(var(--doc-top) + 14px);
}
.docs__article h4{font-size:.98rem;font-weight:700;margin:20px 0 8px;color:var(--cl-accent,#e2231a)}
.docs__article p{margin:0 0 14px}
.docs__article a{color:var(--cl-accent,#e2231a);text-decoration:underline;text-underline-offset:2px}
.docs__article strong,.docs__article b{font-weight:700}
.docs__article ul,.docs__article ol{margin:0 0 16px;padding-left:1.4em}
.docs__article li{margin:5px 0}
.docs__article li::marker{color:var(--cl-accent,#e2231a)}
.docs__article hr{border:0;border-top:1px solid var(--cl-border,#d8d8d2);margin:30px 0}

/* blockquote = red tick */
.docs__article blockquote{
  margin:18px 0;padding:12px 18px;
  border-left:3px solid var(--cl-accent,#e2231a);
  background:var(--cl-bg-2,#f4f4f1);color:var(--cl-text,#111);
}
.docs__article blockquote p:last-child{margin:0}

/* code */
.docs__article code{
  font-family:"SFMono-Regular",Consolas,"Liberation Mono",monospace;
  background:var(--cl-bg-2,#f4f4f1);border:1px solid var(--cl-border,#d8d8d2);
  padding:.04em .4em;font-size:.86em;border-radius:0;
}
.docs__article pre{
  background:var(--cl-bg-2,#f4f4f1);border:1px solid var(--cl-border,#d8d8d2);
  border-left:3px solid var(--cl-text,#111);
  padding:14px 16px;overflow:auto;margin:0 0 18px;font-size:.85rem;line-height:1.6;
}
.docs__article pre code{background:none;border:0;padding:0;font-size:1em}

/* tables — Swiss ledger */
.docs__article table{
  width:100%;border-collapse:collapse;margin:0;font-size:.9rem;
  border:1px solid var(--cl-border,#d8d8d2);
}
/* keep wide tables inside a horizontal scroller */
.docs__article .table-wrap{
  overflow-x:auto;-webkit-overflow-scrolling:touch;
  margin:0 0 20px;
  border:1px solid var(--cl-border,#d8d8d2);
  scrollbar-width:thin;
}
/* on desktop the table fills the column; when content is wider it scrolls */
.docs__article .table-wrap > table{min-width:100%}
.docs__article th,.docs__article td{
  border:1px solid var(--cl-border,#d8d8d2);padding:9px 12px;text-align:left;vertical-align:top;
}
.docs__article thead th{
  background:var(--cl-text,#111);color:var(--cl-bg,#fff);font-weight:700;
  letter-spacing:.3px;
}
.docs__article tbody tr:nth-child(even){background:var(--cl-bg-2,#f4f4f1)}
.docs__article img{max-width:100%}

/* pager */
.docs__pager{
  display:flex;justify-content:space-between;gap:14px;margin-top:48px;
  border-top:1px solid var(--cl-border,#d8d8d2);padding-top:22px;
}
.docs__pager a{
  flex:1;text-decoration:none;color:var(--cl-text,#111);
  border:1px solid var(--cl-border,#d8d8d2);padding:14px 16px;
  transition:border-color .15s,background .15s;
}
.docs__pager a:hover{border-color:var(--cl-accent,#e2231a);background:var(--cl-bg-2,#f4f4f1)}
.docs__pager a.is-next{text-align:right}
.docs__pager span{display:block;font-size:.7rem;letter-spacing:2px;text-transform:uppercase;color:var(--cl-text-dim,#6b6b6b);margin-bottom:4px}
.docs__pager b{font-weight:700;font-size:.95rem;color:var(--cl-accent,#e2231a)}
.docs__pager a.is-empty{visibility:hidden}

/* ---- right TOC ---- */
.docs__toc{position:sticky;top:var(--doc-top);align-self:start}
.docs__toc-nav{display:flex;flex-direction:column;max-height:calc(100vh - var(--doc-top) - 40px);overflow:auto}
.docs__toc-nav a{
  text-decoration:none;color:var(--cl-text-dim,#6b6b6b);font-size:.82rem;line-height:1.4;
  padding:5px 10px;border-left:2px solid var(--cl-border,#d8d8d2);
}
.docs__toc-nav a.lvl-3{padding-left:22px;font-size:.78rem}
.docs__toc-nav a:hover{color:var(--cl-text,#111)}
.docs__toc-nav a.is-active{color:var(--cl-accent,#e2231a);border-left-color:var(--cl-accent,#e2231a);font-weight:600}

/* ---- footer ---- */
.docs-footer{
  max-width:var(--doc-max);margin:0 auto;padding:26px var(--doc-pad);text-align:center;
  border-top:1px solid var(--cl-border,#d8d8d2);color:var(--cl-text-dim,#6b6b6b);
}
.docs-footer p{margin:4px 0}
.docs-footer a{color:var(--cl-accent,#e2231a);text-decoration:none}

/* ============ responsive ============ */
@media (max-width:1080px){
  .docs{grid-template-columns:var(--doc-side-w) minmax(0,1fr);}
  .docs__toc{display:none}
}
/* tablet: keep vertical sidebar, just tighten */
@media (max-width:900px){
  :root{--doc-side-w:210px;--doc-pad:28px}
}
/* phone: swap the horizontal scroll-row for a native <select> */
@media (max-width:760px){
  .docs{grid-template-columns:1fr;gap:14px;padding:16px 16px 48px}
  .docs-hero{padding:24px 16px 4px}
  .docs-footer{padding:26px 16px}
  .docs__side{position:static;top:auto}
  .docs__side-title{display:none}
  .docs__nav{display:none}                 /* replaced by <select> below */
  .docs__nav-select{display:block}
  .docs__article{font-size:.95rem}

  /* tables: show ~2 columns at a time, swipe the rest horizontally */
  .docs__article .table-wrap{
    overflow-x:auto;-webkit-overflow-scrolling:touch;
    border:1px solid var(--cl-border,#d8d8d2);
  }
  .docs__article .table-wrap > table{width:auto;min-width:0;table-layout:auto}
  .docs__article .table-wrap th,
  .docs__article .table-wrap td{
    min-width:44vw;max-width:72vw;
    white-space:normal;overflow-wrap:anywhere;
  }
}
/* very small screens: drop side padding further, keep readability */
@media (max-width:420px){
  .docs{padding:12px 12px 40px}
  .docs-hero{padding:20px 12px 2px}
}