/* Оформление сайта документации.

   Своё, а не токены продукта: документация переживает продукт и не должна
   ломаться от того, что в школе поменяли `--brand`. Ширина колонки текста — 68
   символов, как `--size-readable`: цифра взята не с потолка, за ней читать тяжело.

   Проверяется на 360 — массовая логическая ширина у бюджетных Android, а не 375.
   Таблицы на телефоне прокручиваются внутри своей рамки, а не ломают страницу. */

:root {
  --bg: #ffffff;
  --bg-soft: #f6f7f9;
  --bg-code: #f1f3f6;
  --fg: #14181f;
  --fg-body: #3e4756;
  --fg-muted: #5a6472;
  --line: #e3e6eb;
  --line-strong: #c2c9d4;
  --accent: #1b3fa0;
  --accent-soft: #eef2fe;
  --warn-bg: #fbf1e0;
  --warn-fg: #6b4400;
  --gen-bg: #e8f5ee;
  --gen-fg: #0a5e3d;
  --radius: 8px;
  --mono: "JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
  --sans: -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans", "Liberation Sans", Arial, sans-serif;
}

@media (prefers-color-scheme: dark) {
  :root {
    --bg: #161b22;
    --bg-soft: #1d242d;
    --bg-code: #1d242d;
    --fg: #e6eaf0;
    --fg-body: #d6dde7;
    --fg-muted: #a3aebe;
    --line: #2a323d;
    --line-strong: #414c5a;
    --accent: #7ea2ff;
    --accent-soft: #1b2334;
    --warn-bg: #2a2114;
    --warn-fg: #efc077;
    --gen-bg: #12281f;
    --gen-fg: #6fd3a6;
  }
}

* { box-sizing: border-box; }

html { -webkit-text-size-adjust: 100%; }

body {
  margin: 0;
  background: var(--bg);
  color: var(--fg-body);
  font: 16px/1.6 var(--sans);
}

a { color: var(--accent); text-decoration-thickness: 1px; text-underline-offset: 2px; }
a:hover { text-decoration-thickness: 2px; }

:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; border-radius: 3px; }

.skip {
  position: absolute; left: -9999px; top: 0;
  background: var(--bg); padding: 8px 12px; z-index: 100;
}
.skip:focus { left: 8px; top: 8px; }

.visually-hidden {
  position: absolute; width: 1px; height: 1px; overflow: hidden;
  clip-path: inset(50%); white-space: nowrap;
}

/* ------------------------------------------------------------- шапка */

.top {
  position: sticky; top: 0; z-index: 20;
  display: flex; align-items: center; gap: 12px;
  padding: 10px 16px;
  background: var(--bg);
  border-bottom: 1px solid var(--line);
}
.brand { font-weight: 600; color: var(--fg); text-decoration: none; white-space: nowrap; }
.search { flex: 1; min-width: 0; display: flex; }
.search input {
  width: 100%; max-width: 420px;
  padding: 7px 11px;
  font: inherit; font-size: 15px;
  color: var(--fg);
  background: var(--bg-soft);
  border: 1px solid var(--line-strong);
  border-radius: var(--radius);
}
.version {
  font-size: 13px; color: var(--fg-muted);
  border: 1px solid var(--line); border-radius: 999px;
  padding: 3px 10px; white-space: nowrap;
}

/* ------------------------------------------------------------ каркас */

.shell {
  display: grid;
  grid-template-columns: 250px minmax(0, 1fr) 220px;
  gap: 32px;
  max-width: 1360px;
  margin: 0 auto;
  padding: 24px 16px 64px;
  align-items: start;
}

.side { position: sticky; top: 64px; max-height: calc(100vh - 80px); overflow-y: auto; }

.nav a { display: block; text-decoration: none; color: var(--fg-body); }
.nav-home { padding: 6px 8px; border-radius: 6px; font-weight: 500; }
.nav-group > summary {
  cursor: pointer; padding: 6px 8px; border-radius: 6px;
  font-weight: 600; color: var(--fg); font-size: 15px;
}
.nav-group > summary:hover { background: var(--bg-soft); }
.nav ul { list-style: none; margin: 2px 0 8px; padding: 0 0 0 8px; border-left: 1px solid var(--line); }
.nav li a { padding: 5px 8px; border-radius: 6px; font-size: 15px; color: var(--fg-muted); }
.nav li a:hover { background: var(--bg-soft); color: var(--fg); }
.nav .is-current { background: var(--accent-soft); color: var(--accent); font-weight: 500; }
.nav .dot { color: var(--fg-muted); }

main { min-width: 0; }

.crumbs { margin: 0 0 12px; font-size: 14px; color: var(--fg-muted); }
.crumbs a { color: var(--fg-muted); }
.crumbs .sep { padding: 0 6px; }

.status {
  margin: 0 0 20px; padding: 8px 12px;
  border-radius: var(--radius); font-size: 14px;
}
.status.draft { background: var(--warn-bg); color: var(--warn-fg); }
.status.generated { background: var(--gen-bg); color: var(--gen-fg); }
.status code { background: transparent; }

.page-foot { margin-top: 48px; padding-top: 16px; border-top: 1px solid var(--line); font-size: 14px; }

.toc { position: sticky; top: 64px; font-size: 14px; }
.toc-title { margin: 0 0 8px; font-weight: 600; color: var(--fg); font-size: 13px; text-transform: uppercase; letter-spacing: .04em; }
.toc ul { list-style: none; margin: 0; padding: 0; border-left: 1px solid var(--line); }
.toc li { margin: 0; }
.toc a { display: block; padding: 4px 10px; color: var(--fg-muted); text-decoration: none; }
.toc a:hover { color: var(--accent); }
.toc .lvl-3 a { padding-left: 22px; font-size: 13px; }

/* ------------------------------------------------------------- текст */

.prose { max-width: 68ch; }
.prose > *:first-child { margin-top: 0; }

.prose h1 { font-size: 30px; line-height: 1.2; color: var(--fg); margin: 0 0 20px; letter-spacing: -.02em; }
.prose h2 { font-size: 22px; line-height: 1.25; color: var(--fg); margin: 40px 0 12px; letter-spacing: -.01em; }
.prose h3 { font-size: 17px; line-height: 1.3; color: var(--fg); margin: 28px 0 8px; }
.prose h4 { font-size: 15px; color: var(--fg); margin: 20px 0 6px; }
.prose p, .prose li { font-size: 16px; }
.prose ul, .prose ol { padding-left: 22px; }
.prose li { margin: 4px 0; }
.prose strong { color: var(--fg); }

.anchor {
  margin-left: 8px; color: var(--line-strong); text-decoration: none;
  opacity: 0; font-weight: 400;
}
h2:hover .anchor, h3:hover .anchor, h4:hover .anchor, .anchor:focus { opacity: 1; }

.prose blockquote {
  margin: 20px 0; padding: 12px 16px;
  background: var(--bg-soft);
  border-left: 3px solid var(--line-strong);
  border-radius: 0 var(--radius) var(--radius) 0;
}
.prose blockquote p { margin: 6px 0; font-size: 15px; }

code {
  font-family: var(--mono); font-size: .9em;
  background: var(--bg-code); padding: 1px 5px; border-radius: 4px;
  overflow-wrap: break-word;
}

pre {
  background: var(--bg-code);
  border: 1px solid var(--line);
  border-radius: var(--radius);
  padding: 14px 16px;
  overflow-x: auto;
  font-size: 13.5px; line-height: 1.55;
}
pre code { background: transparent; padding: 0; font-size: inherit; }

/* Широкое содержимое прокручивается внутри своей рамки. Страница по горизонтали
   не едет никогда — это и есть требование «перестраивается, а не сжимается». */
.table-wrap, .prose table { display: block; max-width: 100%; overflow-x: auto; }
.prose table { border-collapse: collapse; margin: 20px 0; font-size: 14px; white-space: nowrap; }
.prose table th, .prose table td {
  border: 1px solid var(--line); padding: 7px 10px; text-align: left; vertical-align: top;
}
.prose table th { background: var(--bg-soft); color: var(--fg); font-weight: 600; }
.prose table td small { color: var(--fg-muted); }

.prose hr { border: 0; border-top: 1px solid var(--line); margin: 40px 0; }

/* ------------------------------------------------------------- подвал */

.bottom {
  border-top: 1px solid var(--line);
  padding: 24px 16px 48px;
  font-size: 14px; color: var(--fg-muted);
}
.bottom p { max-width: 1360px; margin: 6px auto; }
.bottom .warn { color: var(--warn-fg); }

/* --------------------------------------------------------- поиск (JS) */

.search-results { margin: 0 0 24px; padding: 0; list-style: none; }
.search-empty { color: var(--fg-muted); }
mark { background: var(--accent-soft); color: inherit; padding: 0 2px; border-radius: 3px; }

/* ------------------------------------------------------------ экраны */

@media (max-width: 1100px) {
  .shell { grid-template-columns: 230px minmax(0, 1fr); }
  .toc { display: none; }
}

@media (max-width: 860px) {
  .shell { grid-template-columns: minmax(0, 1fr); gap: 20px; padding: 16px 16px 48px; }
  /* На телефоне меню — компактная прокручиваемая коробка, а не полотно
     на весь экран. Раскрытый раздел иначе уносит текст страницы за нижний
     край: на 360 в развёрнутом «Оформлении» до заголовка было два экрана. */
  .side {
    position: static;
    max-height: 190px; overflow-y: auto;
    border: 1px solid var(--line); border-radius: var(--radius); padding: 8px;
    background: var(--bg-soft);
  }
  .prose h1 { font-size: 26px; }
  .prose h2 { font-size: 20px; margin-top: 32px; }
  .top { padding: 8px 12px; gap: 8px; }
  .version { display: none; }
}

@media (max-width: 400px) {
  body { font-size: 15px; }
  .brand { font-size: 15px; }
  .prose h1 { font-size: 23px; }
  pre { font-size: 12.5px; padding: 12px; }
}

@media (prefers-reduced-motion: reduce) {
  * { animation: none !important; transition: none !important; }
}

/* Вложенный уровень навигации — страницы справочника под своим разделом. */
.nav-sub { margin: 2px 0 4px; padding-left: 10px; }
.nav-sub li a { font-size: 14px; }

/* Плашка раздела: то, что читателю надо знать ДО текста страницы. */
.status.notice {
  background: var(--warn-bg); color: var(--warn-fg);
  border-left: 3px solid currentColor;
  font-weight: 500;
}

/* «Этого ещё нет в продукте» — не то же самое, что «не написано»: другое
   состояние, другой цвет. Первое — факт о продукте, второе — наш долг. */
.status.absent { background: var(--bg-soft); color: var(--fg-muted); border-left: 3px solid var(--line-strong); }

/* Пометка «фраза выведена из имени» — приглушённая: она про происхождение
   строки, а не про операцию, и не должна спорить с самой строкой. */
.prose small { color: var(--fg-muted); font-size: 13px; }