/* docs.kosa8.com — same palette as kosa8.com, different job.
   The marketing site persuades; this one gets read for twenty minutes at a
   time, so the measure is narrower, the line height taller, and nothing
   animates. Loads no fonts and no third-party anything, so the strict CSP in
   _headers holds. */
:root {
  --bg: #0B0E11;
  --panel: #12161B;
  --panel-2: #171C22;
  --line: #222A32;
  --line-2: #2C3641;
  --ink: #DDE4EA;
  --ink-2: #A7B2BC;
  --muted: #77838D;
  --amber: #FFB454;
  --cyan: #56C7DB;
  --ok: #7FD962;
  --warn: #E8825A;
  --mono: ui-monospace, "SF Mono", "Cascadia Code", Menlo, Consolas, monospace;
  --sans: "Avenir Next", "Segoe UI", -apple-system, BlinkMacSystemFont, Helvetica, sans-serif;
  --side: 17rem;
  --top: 3.4rem;
}
* { box-sizing: border-box; }
html { background: var(--bg); -webkit-text-size-adjust: 100%; scroll-behavior: smooth; }
body { margin: 0; background: var(--bg); color: var(--ink); font-family: var(--sans);
       line-height: 1.7; font-size: 1rem; -webkit-font-smoothing: antialiased; }
a { color: var(--cyan); text-decoration: none; }
a:hover { text-decoration: underline; text-underline-offset: 3px; }
code { font-family: var(--mono); font-size: .88em; }
.skip { position: absolute; left: -999px; }
.skip:focus { left: 1rem; top: .5rem; background: var(--amber); color: #14100A;
              padding: .4rem .8rem; border-radius: 4px; z-index: 100; }

/* ---- top bar ---- */
.topbar { position: sticky; top: 0; z-index: 40; display: flex; align-items: center;
          gap: 1rem; height: var(--top); padding: 0 1.1rem; background: rgba(11,14,17,.92);
          backdrop-filter: blur(8px); border-bottom: 1px solid var(--line); }
.brand { font-family: var(--mono); font-weight: 700; color: var(--ink); font-size: 1.05rem;
         letter-spacing: -.02em; white-space: nowrap; }
.brand b { color: var(--amber); }
.brand span { color: var(--muted); font-weight: 400; }
.brand:hover { text-decoration: none; }
#search { flex: 1; max-width: 30rem; background: var(--panel); color: var(--ink);
          border: 1px solid var(--line-2); border-radius: 7px; padding: .45rem .8rem;
          font-family: var(--sans); font-size: .9rem; }
#search:focus { outline: none; border-color: var(--amber); }
.topnav { margin-left: auto; display: flex; gap: 1.1rem; font-family: var(--mono);
          font-size: .78rem; }
.topnav a { color: var(--muted); }
.topnav a:hover { color: var(--amber); text-decoration: none; }
#menu { display: none; background: none; border: 1px solid var(--line-2); color: var(--ink);
        border-radius: 6px; font-size: 1rem; padding: .2rem .55rem; cursor: pointer; }

/* ---- search results ---- */
#results { position: fixed; top: var(--top); left: 0; right: 0; z-index: 50;
           max-height: 70vh; overflow-y: auto; background: var(--panel);
           border-bottom: 1px solid var(--line-2); box-shadow: 0 20px 50px rgba(0,0,0,.55); }
#results[hidden] { display: none; }
#results .wrapin { max-width: 44rem; margin: 0 auto; padding: .6rem 1.1rem 1rem; }
#results a { display: block; padding: .55rem .7rem; border-radius: 6px; color: var(--ink); }
#results a:hover, #results a.sel { background: var(--panel-2); text-decoration: none; }
#results code { color: var(--amber); }
#results .d { color: var(--muted); font-size: .85rem; display: block; }
#results .none { color: var(--muted); padding: .6rem .7rem; font-size: .9rem; }

/* ---- layout ---- */
.shell { display: grid; grid-template-columns: var(--side) minmax(0, 1fr); }
#sidebar { border-right: 1px solid var(--line); padding: 1.4rem 0 4rem;
           position: sticky; top: var(--top); height: calc(100vh - var(--top));
           overflow-y: auto; }
.side .sect { margin-bottom: 1.5rem; }
.side h4 { margin: 0 0 .45rem; padding: 0 1.2rem; font-size: .68rem; letter-spacing: .12em;
           text-transform: uppercase; color: var(--muted); font-family: var(--mono);
           font-weight: 600; }
.side a { display: block; padding: .2rem 1.2rem; color: var(--ink-2); font-size: .89rem;
          border-left: 2px solid transparent; }
.side a:hover { color: var(--ink); text-decoration: none; background: var(--panel); }
.side a.cur { color: var(--amber); border-left-color: var(--amber); background: var(--panel); }
.side code { font-size: .84rem; }

#content { padding: 2.4rem 2.6rem 6rem; max-width: 52rem; min-width: 0; }
@media (max-width: 900px) {
  .shell { grid-template-columns: 1fr; }
  #sidebar { display: none; position: static; height: auto; border-right: 0;
             border-bottom: 1px solid var(--line); }
  #sidebar.open { display: block; }
  #menu { display: block; }
  .topnav { display: none; }
  #content { padding: 1.6rem 1.2rem 4rem; }
}

/* ---- prose ---- */
h1 { font-size: clamp(1.7rem, 3.4vw, 2.3rem); line-height: 1.18; letter-spacing: -.028em;
     margin: 0 0 .8rem; font-weight: 600; }
h1 code { font-size: .82em; color: var(--amber); }
h2 { font-size: 1.35rem; margin: 2.6rem 0 .7rem; letter-spacing: -.02em; font-weight: 600;
     padding-top: .6rem; border-top: 1px solid var(--line); }
h3 { font-size: 1.02rem; margin: 1.8rem 0 .5rem; font-weight: 600; }
p { color: var(--ink-2); margin: 0 0 .95rem; }
.lede { font-size: 1.1rem; color: var(--ink); margin-bottom: 1.4rem; }
.crumb { font-family: var(--mono); font-size: .74rem; color: var(--muted); margin-bottom: .6rem; }
ul, ol { color: var(--ink-2); padding-left: 1.2rem; margin: 0 0 1rem; }
li { margin-bottom: .35rem; }
strong, b { color: var(--ink); }
p code, li code, td code { background: var(--panel-2); border: 1px solid var(--line);
                           border-radius: 4px; padding: .06rem .32rem; color: var(--ink); }

/* ---- code blocks ---- */
pre { background: #0A0D10; border: 1px solid var(--line-2); border-radius: 8px;
      padding: .9rem 1rem; overflow-x: auto; font-family: var(--mono); font-size: .8rem;
      line-height: 1.7; color: var(--ink); margin: 0 0 1.1rem; white-space: pre; }
pre.usage { border-color: var(--amber); color: var(--amber); }
pre.snippet { background: var(--panel-2); }
.term { position: relative; }
.c-dim { color: var(--muted); } .c-amb { color: var(--amber); }
.c-cyn { color: var(--cyan); } .c-ok { color: var(--ok); } .c-bad { color: var(--warn); }

/* ---- tables ---- */
.scroll { overflow-x: auto; margin-bottom: 1.2rem; }
table { border-collapse: collapse; width: 100%; font-size: .88rem; }
th, td { text-align: left; padding: .5rem .7rem; border-bottom: 1px solid var(--line);
         vertical-align: top; }
th { font-family: var(--mono); font-size: .7rem; letter-spacing: .07em; text-transform: uppercase;
     color: var(--muted); font-weight: 600; white-space: nowrap; }
td:first-child { white-space: nowrap; }

/* ---- cards ---- */
.cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr));
         gap: .7rem; margin: 1rem 0 1.6rem; }
.card { display: block; background: var(--panel); border: 1px solid var(--line);
        border-radius: 9px; padding: .85rem 1rem; color: var(--ink); }
.card:hover { border-color: var(--amber); text-decoration: none; }
.card code { color: var(--amber); font-size: .86rem; }
.card span { display: block; color: var(--muted); font-size: .84rem; margin-top: .2rem;
             line-height: 1.5; }

/* ---- callouts ---- */
.note, .warn-box { border-left: 3px solid var(--cyan); background: var(--panel);
                   padding: .8rem 1rem; border-radius: 0 8px 8px 0; margin: 0 0 1.2rem; }
.note p:last-child, .warn-box p:last-child { margin-bottom: 0; }
.warn-box { border-left-color: var(--warn); }
.note b, .warn-box b { display: block; margin-bottom: .25rem; font-size: .85rem;
                       letter-spacing: .04em; text-transform: uppercase;
                       font-family: var(--mono); }
.note b { color: var(--cyan); } .warn-box b { color: var(--warn); }

/* ---- steps ---- */
.steps { counter-reset: s; margin: 1.2rem 0; }
.step { counter-increment: s; position: relative; padding-left: 2.4rem; margin-bottom: 1.6rem; }
.step::before { content: counter(s); position: absolute; left: 0; top: .05rem; width: 1.7rem;
                height: 1.7rem; border-radius: 50%; border: 1px solid var(--line-2);
                display: grid; place-items: center; font-family: var(--mono); font-size: .74rem;
                color: var(--muted); }
.step h3 { margin-top: 0; }

/* ---- screenshots ---- */
figure { margin: 1.2rem 0 1.6rem; }
figure img { width: 100%; height: auto; border: 1px solid var(--line-2); border-radius: 9px;
             display: block; }
figcaption { color: var(--muted); font-size: .82rem; margin-top: .5rem; font-family: var(--mono); }