/* ============================================================
   Cherum dev-shell — devshell.css
   Shared shell for developer surfaces: docs.cherum.io, the widget
   playground, and any future dev page. Header + footer + article/
   code typography. Tokens are 1:1 the partner-cabinet system
   (frontend/public/partners/cabinet.css) — the reference DS.
   Vanilla CSS, CSP-clean, self-host fonts only (system fallback
   until /fonts). Dark is primary; light ships too.

   Load order on a page:  devshell.css → page-specific styles.
   Safe to load next to cabinet.css (token values are identical);
   shell classes are dv-prefixed to avoid collisions.
   ============================================================ */
:root{
  --r-sm:8px;--r-md:12px;--r-lg:16px;--r-xl:20px;--r-2xl:26px;
  --ff:"Inter Tight",ui-sans-serif,system-ui,-apple-system,"Segoe UI",sans-serif; /* @kind font */
  --serif:"Instrument Serif","Iowan Old Style",Georgia,serif; /* @kind font */
  --mono:"JetBrains Mono",ui-monospace,SFMono-Regular,Menlo,monospace; /* @kind font */
  --ease:cubic-bezier(.2,.8,.2,1); /* @kind other */
}
[data-theme="dark"]{
  --bg-0:oklch(0.17 0.010 310);--bg-1:oklch(0.205 0.012 310);--bg-2:oklch(0.25 0.014 310);--bg-3:oklch(0.29 0.016 310);
  --line:oklch(0.32 0.018 310);--line-2:oklch(0.38 0.022 310);
  --text-1:oklch(0.93 0.008 310);--text-2:oklch(0.78 0.012 310);--text-3:oklch(0.63 0.016 310);
  --accent:oklch(0.74 0.14 305);--accent-hi:oklch(0.82 0.14 305);--accent-ink:#18121F;
  --good:oklch(0.74 0.11 162);--good-hi:oklch(0.82 0.12 162);--good-bg:oklch(0.30 0.05 162);
  --warn:oklch(0.80 0.12 78);--warn-hi:oklch(0.86 0.12 82);--warn-bg:oklch(0.32 0.05 70);
  --info:oklch(0.72 0.08 235);
  --card-grad:linear-gradient(180deg,color-mix(in oklab,var(--bg-1) 94%,transparent),color-mix(in oklab,var(--bg-0) 82%,transparent));
  --hairline:color-mix(in oklab,var(--text-1) 11%,transparent);
  --mesh-a:oklch(0.31 0.10 305 / 0.40);--mesh-b:oklch(0.27 0.085 342 / 0.30);
  color-scheme:dark;
}
[data-theme="light"]{
  --bg-0:oklch(0.975 0.004 310);--bg-1:oklch(0.99 0.003 310);--bg-2:oklch(0.945 0.006 310);--bg-3:oklch(0.915 0.008 310);
  --line:oklch(0.88 0.010 310);--line-2:oklch(0.82 0.012 310);
  --text-1:oklch(0.22 0.012 310);--text-2:oklch(0.40 0.014 310);--text-3:oklch(0.52 0.016 310);
  --accent:oklch(0.52 0.16 305);--accent-hi:oklch(0.44 0.16 305);--accent-ink:#fff;
  --good:oklch(0.52 0.13 162);--good-hi:oklch(0.44 0.13 162);--good-bg:oklch(0.93 0.04 162);
  --warn:oklch(0.62 0.13 70);--warn-hi:oklch(0.52 0.13 70);--warn-bg:oklch(0.94 0.05 80);
  --info:oklch(0.50 0.09 235);
  --card-grad:linear-gradient(180deg,#fff,color-mix(in oklab,var(--bg-1) 90%,transparent));
  --hairline:color-mix(in oklab,var(--text-1) 9%,transparent);
  --mesh-a:oklch(0.82 0.07 305 / 0.40);--mesh-b:oklch(0.87 0.055 342 / 0.32);
  color-scheme:light;
}

/* ============ base ============ */
*{box-sizing:border-box;margin:0;padding:0}
html{scroll-behavior:smooth}
body{font-family:var(--ff);background:var(--bg-0);color:var(--text-1);font-size:15px;line-height:1.55;
  -webkit-font-smoothing:antialiased;min-height:100vh}
a{color:inherit;text-decoration:none}
.mono{font-family:var(--mono)}
.serif{font-family:var(--serif);font-weight:400;letter-spacing:-0.015em;line-height:1.08}
.caps{font-family:var(--mono);font-size:10.5px;letter-spacing:.08em;text-transform:uppercase;color:var(--text-3)}
.tnum{font-variant-numeric:tabular-nums}
.card{background-image:var(--card-grad);border:1px solid var(--hairline);border-radius:var(--r-lg);box-shadow:0 1px 2px rgba(0,0,0,.05)}

.btn{display:inline-flex;align-items:center;justify-content:center;gap:8px;border-radius:10px;font-weight:600;font-size:14px;
  padding:11px 16px;cursor:pointer;border:1px solid transparent;transition:.15s;white-space:nowrap}
.btn:active{transform:translateY(1px)}
.btn-primary{background:linear-gradient(180deg,var(--accent-hi),var(--accent));color:var(--accent-ink);border-color:color-mix(in oklab,var(--accent) 60%,white)}
.btn-primary:hover{filter:brightness(1.05)}
.btn-ghost{background:var(--bg-1);color:var(--text-1);border-color:var(--line-2)}
.btn-ghost:hover{background:var(--bg-2)}
.btn-sm{padding:8px 12px;font-size:13px;border-radius:9px}

.pill{display:inline-flex;align-items:center;gap:6px;padding:3px 9px;border-radius:999px;font-size:11px;font-weight:600;
  font-family:var(--mono);letter-spacing:.02em;white-space:nowrap}
.pill-good{background:color-mix(in oklab,var(--good) 14%,transparent);color:var(--good-hi);border:1px solid color-mix(in oklab,var(--good) 36%,transparent)}
.pill-neutral{background:var(--bg-2);color:var(--text-2);border:1px solid var(--line-2)}
.pill-accent{background:color-mix(in oklab,var(--accent) 14%,transparent);color:var(--accent-hi);border:1px solid color-mix(in oklab,var(--accent) 34%,transparent)}
.dot{width:6px;height:6px;border-radius:999px;background:currentColor;flex:none}

/* ============ shell header ============ */
.dv-top{position:sticky;top:0;z-index:60;height:58px;
  background:color-mix(in oklab,var(--bg-0) 82%,transparent);backdrop-filter:blur(14px);
  border-bottom:1px solid var(--hairline)}
.dv-top-in{max-width:1280px;margin:0 auto;height:100%;padding:0 22px;display:flex;align-items:center;gap:22px}
.dv-brand{display:flex;align-items:center;gap:9px;font-weight:600;font-size:19px;letter-spacing:-0.028em;flex:none}
.dv-brand .mk{display:inline-flex;color:var(--text-1)}
.dv-brand .tag{font-family:var(--mono);font-size:10px;letter-spacing:.07em;text-transform:uppercase;color:var(--accent-hi);
  border:1px solid color-mix(in oklab,var(--accent) 34%,transparent);border-radius:999px;padding:2px 8px;
  background:color-mix(in oklab,var(--accent) 12%,transparent)}
.dv-nav{display:flex;align-items:center;gap:4px;flex:1;min-width:0;overflow-x:auto;scrollbar-width:none}
.dv-nav::-webkit-scrollbar{display:none}
.dv-nav a{font-size:13.5px;font-weight:500;color:var(--text-2);padding:7px 11px;border-radius:9px;white-space:nowrap;transition:.15s}
.dv-nav a:hover{color:var(--text-1);background:var(--bg-1)}
.dv-nav a.on{color:var(--text-1);background:var(--bg-2);border:1px solid var(--line)}
.dv-nav a .ext{opacity:.55;margin-left:3px;font-size:11px}
.dv-top-right{display:flex;align-items:center;gap:10px;flex:none}
.dv-iconbtn{width:34px;height:34px;border-radius:9px;border:1px solid var(--line-2);background:var(--bg-1);
  color:var(--text-2);display:grid;place-items:center;cursor:pointer;transition:.15s}
.dv-iconbtn:hover{color:var(--text-1);background:var(--bg-2)}

/* ============ shell footer ============ */
.dv-foot{border-top:1px solid var(--hairline);margin-top:72px;background:color-mix(in oklab,var(--bg-1) 45%,transparent)}
.dv-foot-in{max-width:1280px;margin:0 auto;padding:40px 22px 26px}
.dv-foot-grid{display:grid;grid-template-columns:1.5fr 1fr 1fr 1fr;gap:28px;margin-bottom:32px}
.dv-foot .dv-brand{font-size:18px}
.dv-foot-brand p{font-size:13px;color:var(--text-3);max-width:24em;margin-top:12px;line-height:1.55}
.dv-foot h5{font-family:var(--mono);font-size:10.5px;letter-spacing:.08em;text-transform:uppercase;color:var(--text-3);margin-bottom:13px;font-weight:500}
.dv-foot-col a{display:block;font-size:13px;color:var(--text-2);margin-bottom:9px;transition:.15s}
.dv-foot-col a:hover{color:var(--text-1)}
.dv-foot-bot{display:flex;align-items:center;justify-content:space-between;gap:14px;padding-top:20px;border-top:1px solid var(--hairline);flex-wrap:wrap}
@media(max-width:860px){.dv-foot-grid{grid-template-columns:1fr 1fr}}

/* ============ docs layout ============ */
.dv-docs{max-width:1280px;margin:0 auto;padding:0 22px;display:grid;grid-template-columns:230px minmax(0,1fr);gap:44px;align-items:start}
.dv-sidenav{position:sticky;top:82px;padding:26px 0 40px;max-height:calc(100vh - 82px);overflow-y:auto}
.dv-sidenav .grp{margin-bottom:22px}
.dv-sidenav .glab{display:block;font-family:var(--mono);font-size:10px;letter-spacing:.07em;text-transform:uppercase;color:var(--text-3);margin-bottom:9px}
.dv-sidenav a{display:block;font-size:13.5px;color:var(--text-2);padding:6px 10px;margin-left:-10px;border-radius:8px;
  border-left:2px solid transparent;transition:.13s}
.dv-sidenav a:hover{color:var(--text-1)}
.dv-sidenav a.on{color:var(--accent-hi);background:color-mix(in oklab,var(--accent) 9%,transparent);
  border-left-color:var(--accent);border-radius:0 8px 8px 0}
@media(max-width:960px){.dv-docs{grid-template-columns:1fr}.dv-sidenav{position:static;max-height:none;padding-bottom:0;
  display:flex;gap:18px;overflow-x:auto;border-bottom:1px solid var(--hairline)}
  .dv-sidenav .grp{margin:0;flex:none;display:flex;align-items:center;gap:10px}
  .dv-sidenav .glab{margin:0}
  .dv-sidenav a{white-space:nowrap;border-left:none;margin-left:0}
  .dv-sidenav a.on{border-radius:8px}}

/* ============ article typography ============ */
.dv-article{padding:34px 0 60px;max-width:760px;min-width:0}
.dv-article .crumb{font-size:12.5px;color:var(--text-3);margin-bottom:6px}
.dv-article h1{font-size:32px;letter-spacing:-0.02em;line-height:1.12;margin-bottom:12px}
.dv-article .lead{font-size:16px;color:var(--text-2);line-height:1.6;margin-bottom:8px;max-width:38em}
.dv-article h2{font-size:21px;letter-spacing:-0.015em;margin:44px 0 12px;padding-top:10px;position:relative}
.dv-article h2 .anchor{position:absolute;left:-22px;top:10px;color:var(--text-3);opacity:0;font-weight:400;transition:.15s}
.dv-article h2:hover .anchor{opacity:1}
.dv-article h3{font-size:15.5px;font-weight:600;margin:26px 0 8px}
.dv-article p{font-size:14.5px;color:var(--text-2);line-height:1.65;margin-bottom:12px;text-wrap:pretty}
.dv-article p b,.dv-article li b{color:var(--text-1);font-weight:600}
.dv-article a.lnk{color:var(--accent-hi);border-bottom:1px solid color-mix(in oklab,var(--accent) 40%,transparent)}
.dv-article a.lnk:hover{border-bottom-color:var(--accent-hi)}
.dv-article ul,.dv-article ol{margin:0 0 14px 20px;display:flex;flex-direction:column;gap:6px}
.dv-article li{font-size:14.5px;color:var(--text-2);line-height:1.6}
.dv-article li::marker{color:var(--text-3)}
.dv-article code{font-family:var(--mono);font-size:.88em;background:var(--bg-2);border:1px solid var(--line);
  border-radius:6px;padding:1.5px 6px;color:var(--text-1);white-space:nowrap}
.dv-article hr{border:none;border-top:1px solid var(--hairline);margin:36px 0}

/* code blocks (shared docs + playground) */
.codeblock{background:var(--bg-0);border:1px solid var(--line);border-radius:var(--r-md);overflow:hidden;margin:14px 0 20px}
[data-theme="light"] .codeblock{background:oklch(0.205 0.012 310);border-color:oklch(0.32 0.018 310);color-scheme:dark}
.codehead{display:flex;align-items:center;gap:10px;padding:9px 12px;border-bottom:1px solid oklch(0.32 0.018 310 / .6)}
.codehead .fname{font-family:var(--mono);font-size:11px;color:oklch(0.63 0.016 310)}
.codehead .copybtn{margin-left:auto}
.codetabs{display:flex;gap:2px;padding:8px 8px 0;border-bottom:1px solid oklch(0.32 0.018 310 / .6)}
.codetab{font-family:var(--mono);font-size:11.5px;padding:7px 12px;border-radius:8px 8px 0 0;color:oklch(0.63 0.016 310);cursor:pointer}
.codetab.active{color:oklch(0.93 0.008 310);background:oklch(0.25 0.014 310)}
.codeblock pre{font-family:var(--mono);font-size:12.5px;line-height:1.75;padding:14px 16px;overflow-x:auto;color:oklch(0.78 0.012 310)}
.codeblock pre .k{color:oklch(0.82 0.14 305)}
.codeblock pre .s{color:oklch(0.82 0.12 162)}
.codeblock pre .c{color:oklch(0.63 0.016 310)}
.copybtn{float:right;font-family:var(--mono);font-size:10.5px;color:oklch(0.63 0.016 310);border:1px solid oklch(0.38 0.022 310);
  background:transparent;border-radius:7px;padding:3px 9px;cursor:pointer;transition:.15s}
.copybtn:hover{color:oklch(0.93 0.008 310)}

/* tables */
.dv-tbl{width:100%;border-collapse:collapse;margin:14px 0 22px;font-size:13.5px;border:1px solid var(--hairline);border-radius:var(--r-md);overflow:hidden;display:block;overflow-x:auto}
.dv-tbl table{width:100%;border-collapse:collapse}
.dv-tbl th{font-family:var(--mono);font-size:10.5px;letter-spacing:.06em;text-transform:uppercase;color:var(--text-3);
  text-align:left;font-weight:500;padding:9px 12px;background:var(--bg-1);border-bottom:1px solid var(--hairline)}
.dv-tbl td{padding:9px 12px;border-bottom:1px solid var(--hairline);color:var(--text-2);vertical-align:top;line-height:1.5}
.dv-tbl tr:last-child td{border-bottom:none}
.dv-tbl td:first-child{white-space:nowrap}

/* callouts */
.dv-note{display:flex;gap:10px;align-items:flex-start;padding:12px 14px;border-radius:11px;margin:16px 0 20px;
  font-size:13.5px;line-height:1.55;color:var(--text-2)}
.dv-note svg{flex:none;margin-top:2px}
.dv-note b{color:var(--text-1);font-weight:600}
.dv-note.info{background:color-mix(in oklab,var(--accent) 8%,transparent);border:1px solid color-mix(in oklab,var(--accent) 26%,transparent)}
.dv-note.info svg{color:var(--accent-hi)}
.dv-note.warn{background:color-mix(in oklab,var(--warn) 10%,transparent);border:1px solid color-mix(in oklab,var(--warn) 34%,transparent)}
.dv-note.warn svg{color:var(--warn-hi)}

/* prev / next */
.dv-pagenav{display:grid;grid-template-columns:1fr 1fr;gap:14px;margin-top:44px}
.dv-pagenav a{padding:14px 16px;display:flex;flex-direction:column;gap:3px;transition:.15s}
.dv-pagenav a:hover{border-color:color-mix(in oklab,var(--accent) 40%,transparent)}
.dv-pagenav .dir{font-family:var(--mono);font-size:10.5px;letter-spacing:.07em;text-transform:uppercase;color:var(--text-3)}
.dv-pagenav .ttl{font-size:14px;font-weight:600}
.dv-pagenav a.next{text-align:right;align-items:flex-end}
@media(max-width:640px){.dv-pagenav{grid-template-columns:1fr}}

/* page head for tool-pages (playground) */
.dv-phead{max-width:1280px;margin:0 auto;padding:38px 22px 30px}
.dv-phead h1.serif{font-size:clamp(30px,4vw,44px);margin:10px 0 12px}
.dv-phead h1 em{font-style:italic;color:var(--accent-hi)}
.dv-phead p{font-size:15.5px;color:var(--text-2);line-height:1.6;max-width:40em}
