/* ============================================================
   BLOK REFERENCYJNY (.docblock) — format dokumentacji, nie bloga
   Wzorzec pod cytowania w AI Search: jawna struktura (definicja,
   parametry, przykład, ograniczenia), gęsto, bez narracji.
   Pierwsze zdanie jest samowystarczalne i nadaje się na
   description — fan-out queries pokrywają się z description
   częściej niż z title.
   ============================================================ */
.docblock{border:1px solid var(--rule);border-left:4px solid var(--accent);background:var(--card);margin:26px 0}
.docblock > .dh{display:flex;flex-wrap:wrap;gap:6px 14px;align-items:baseline;
  padding:11px 18px;border-bottom:1px solid var(--rule);background:var(--paper-2)}
.docblock > .dh h3{font-size:19px;margin:0}
.docblock > .dh .kind{font-family:var(--display);font-weight:900;font-size:11px;letter-spacing:.13em;text-transform:uppercase;color:var(--accent)}
.docblock > .dh .upd{font-family:var(--body);font-size:14px;color:var(--ink-3);margin-left:auto}
.docblock .db{padding:16px 18px 18px}
/* definicja: jedno samowystarczalne zdanie, bez wstępu */
.docblock .def{font-size:17.5px;line-height:1.5;margin:0 0 16px;color:var(--ink)}
.docblock .def b{font-weight:700}
/* sekcje bloku — etykiety zamiast nagłówków narracyjnych */
.docblock section{margin-top:16px}
.docblock section > h4{font-family:var(--display);font-weight:900;font-size:11.5px;letter-spacing:.13em;
  text-transform:uppercase;color:var(--ink-3);margin:0 0 8px;padding-bottom:5px;border-bottom:1px solid var(--rule)}
/* parametry: definition list w dwóch kolumnach, wartości w mono */
.docblock dl.params{display:grid;grid-template-columns:minmax(120px,28%) minmax(0,1fr);gap:0;margin:0;font-size:15.5px}
.docblock dl.params dt{font-family:var(--mono);font-size:13.5px;color:var(--ink);padding:7px 12px 7px 0;border-bottom:1px solid var(--rule-soft)}
.docblock dl.params dd{margin:0;padding:7px 0;border-bottom:1px solid var(--rule-soft);color:var(--ink-2)}
@media(max-width:600px){
  .docblock dl.params{grid-template-columns:1fr}
  .docblock dl.params dt{border-bottom:0;padding-bottom:0}
  .docblock dl.params dd{padding-top:2px}
}
.docblock ul.dense{list-style:none;margin:0;padding:0;font-size:15.5px}
.docblock ul.dense li{padding-left:18px;position:relative;margin-bottom:6px;color:var(--ink-2)}
.docblock ul.dense li::before{content:"·";position:absolute;left:4px;color:var(--accent);font-weight:700}
.docblock ul.dense li b{color:var(--ink);font-weight:700}
/* ograniczenia: to samo, ale oznaczone ochrą jako „uważaj” */
.docblock section.limits > h4{color:var(--ochre)}
.docblock section.limits ul.dense li::before{content:"!";color:var(--ochre);font-family:var(--mono);font-size:13px}
.docblock pre{margin:0}
.docblock .src{font-family:var(--body);font-size:14px;color:var(--ink-3);margin:16px 0 0;padding-top:12px;border-top:1px solid var(--rule)}