/* Документация /docs — рабочая поверхность, а не плакат.
 *
 * Лендинг уходит в сценический слой (латунь, чек, 3D). Документацию читают,
 * когда что-то не работает, — поэтому здесь только системные токены: сталь,
 * поверхности, волосяные линии. Латунь оставлена ровно на ссылках в тексте,
 * чтобы связь с сайтом не терялась.
 *
 * Разметка генерится tools/build-docs.py. CSP запрещает inline-стили —
 * любое оформление приезжает только отсюда.
 */

.docs-body {
  /* Шапка на документации прибита: навигация нужна на любой глубине текста. */
  --head: 66px;
}

.docs-body .nav {
  position: sticky;
  top: 0;
  z-index: 40;
}

.nav-sec {
  margin-left: 14px;
  padding-left: 14px;
  border-left: 1px solid var(--line);
  font-size: 13px;
  color: var(--text-2);
  letter-spacing: 0.04em;
}

.nav-in .btn { margin-left: auto; }

/* ======================= каркас ======================= */

.docs-shell {
  max-width: var(--page);
  margin: 0 auto;
  padding: 0 var(--gutter);
  display: grid;
  grid-template-columns: 250px minmax(0, 1fr);
  gap: clamp(28px, 4vw, 56px);
  align-items: start;
}

.side {
  position: sticky;
  top: var(--head);
  max-height: calc(100svh - var(--head));
  overflow-y: auto;
  padding: 28px 0 40px;
  /* Полоса-разделитель тянется во всю высоту колонки, а не только текста. */
  border-right: 1px solid var(--line-soft);
  padding-right: 18px;
  /* Системная полоса приезжает светлой и широкой — на тёмной колонке она
     читается как элемент интерфейса, которым не является. */
  scrollbar-width: thin;
  scrollbar-color: var(--line) transparent;
}

.side::-webkit-scrollbar { width: 8px; }
.side::-webkit-scrollbar-track { background: transparent; }

.side::-webkit-scrollbar-thumb {
  background: var(--line);
  border-radius: var(--r-pill);
  border: 2px solid var(--bg);
}

.side::-webkit-scrollbar-thumb:hover { background: var(--surface-2); }

.docs-main {
  min-width: 0;
  display: grid;
  grid-template-columns: minmax(0, 1fr) 200px;
  gap: clamp(24px, 3vw, 48px);
  padding: 28px 0 96px;
}

.docs-art {
  min-width: 0;
  max-width: 74ch;
}

/* ======================= поиск ======================= */

.search input {
  width: 100%;
  padding: 10px 12px;
  background: var(--surface);
  border: 1px solid var(--line);
  border-radius: var(--r-sm);
  color: var(--text-1);
  font: inherit;
  font-size: 14px;
  transition: border-color var(--t-base) var(--ease);
}

.search input::placeholder { color: var(--text-3); }

.search input:focus {
  outline: none;
  border-color: var(--accent-deep);
}

/* Крестик очистки в Safari/Chrome красится только так. */
.search input::-webkit-search-cancel-button {
  filter: invert(0.6);
}

.results {
  margin-top: 10px;
  display: grid;
  gap: 2px;
}

.results a {
  display: block;
  padding: 9px 10px;
  border-radius: var(--r-sm);
  background: var(--surface);
  border: 1px solid transparent;
  transition: border-color var(--t-fast) var(--ease);
}

.results a:hover,
.results a:focus-visible,
.results a.pick {
  border-color: var(--accent-deep);
  outline: none;
}

.results .r-t {
  display: block;
  font-size: 14px;
  color: var(--text-1);
}

.results .r-s {
  display: block;
  margin-top: 1px;
  font-size: 11px;
  letter-spacing: 0.05em;
  text-transform: uppercase;
  color: var(--text-3);
}

.results .r-x {
  display: block;
  margin-top: 4px;
  font-size: 12px;
  line-height: 1.45;
  color: var(--text-2);
}

/* Совпавшее слово подсвечиваем, иначе выдача читается как каша. */
.results mark {
  background: var(--brass-glow);
  color: var(--brass);
  border-radius: 2px;
}

.results .none {
  padding: 10px;
  font-size: 13px;
  color: var(--text-3);
}

/* ======================= меню разделов ======================= */

.side-h {
  margin: 22px 0 8px;
  font-size: 11px;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--text-3);
}

.side-nav ul {
  list-style: none;
  margin: 0;
  padding: 0;
  display: grid;
  gap: 1px;
}

.side-nav a {
  display: block;
  padding: 6px 10px;
  margin-left: -10px;
  border-radius: var(--r-sm);
  font-size: 14px;
  line-height: 1.35;
  color: var(--text-2);
  transition: color var(--t-fast) var(--ease), background var(--t-fast) var(--ease);
}

.side-nav a:hover { color: var(--text-1); background: var(--surface); }

.side-nav a.on {
  color: var(--text-1);
  background: var(--surface-2);
  box-shadow: inset 2px 0 0 var(--accent);
}

.menu-btn { display: none; }

/* ======================= текст ======================= */

.docs-art h1 {
  font-size: clamp(28px, 3.4vw, 40px);
  line-height: 1.12;
  margin: 0 0 18px;
}

.docs-art .lead {
  font-size: 17px;
  color: var(--text-2);
  margin-bottom: 32px;
}

.docs-art h2 {
  font-size: clamp(20px, 2vw, 25px);
  margin: 52px 0 12px;
  padding-top: 20px;
  border-top: 1px solid var(--line-soft);
  scroll-margin-top: calc(var(--head) + 16px);
}

/* Подзаголовки — наборным шрифтом, а не акцидентным. Unbounded держит
   плакатный h1 и ритм h2, но на третьем уровне их в тексте десятки, и
   акцидентный шрифт начинает спорить с содержанием вместо того, чтобы
   его размечать. */
.docs-art h3 {
  font-family: var(--font-body);
  font-size: 17px;
  font-weight: 600;
  letter-spacing: 0;
  margin: 30px 0 8px;
  color: var(--text-1);
  scroll-margin-top: calc(var(--head) + 16px);
}

.docs-art h4 {
  font-family: var(--font-body);
  font-weight: 600;
  font-size: 15px;
  margin: 22px 0 6px;
  color: var(--text-2);
  scroll-margin-top: calc(var(--head) + 16px);
}

.docs-art p,
.docs-art li {
  color: var(--text-2);
  font-size: 15.5px;
  line-height: 1.65;
}

.docs-art p { margin: 0 0 14px; }

.docs-art strong { color: var(--text-1); font-weight: 600; }

.docs-art ul,
.docs-art ol {
  margin: 0 0 16px;
  padding-left: 22px;
  display: grid;
  gap: 7px;
}

.docs-art a {
  color: var(--brass);
  text-decoration: underline;
  text-underline-offset: 2px;
  text-decoration-thickness: 1px;
}

.docs-art a:hover { color: var(--text-1); }

/* Якорь у заголовка — проявляется на наведении, чтобы не сорить в наборе.
   На тач-экранах наведения нет, там он просто не нужен: ссылку шлют с десктопа. */
.anchor {
  margin-left: 8px;
  color: var(--text-3);
  text-decoration: none;
  opacity: 0;
  transition: opacity var(--t-fast) var(--ease);
}

h2:hover .anchor,
h3:hover .anchor,
.anchor:focus-visible { opacity: 1; }

.docs-art hr {
  margin: 36px 0;
  border: 0;
  border-top: 1px solid var(--line-soft);
}

.docs-art blockquote {
  margin: 18px 0;
  padding: 14px 16px;
  background: var(--surface);
  border-left: 2px solid var(--brass-deep);
  border-radius: 0 var(--r-sm) var(--r-sm) 0;
}

.docs-art blockquote p { margin: 0; font-size: 15px; }

/* Метка врезки. «Скоро» — не украшение: она отделяет описанное от
   доступного, и читатель не должен искать кнопку, которой пока нет. */
.note-l {
  margin: 0 0 4px !important;
  font-size: 11px !important;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  font-weight: 600;
}

.note.soon { border-left-color: var(--accent-deep); }
.note.soon .note-l { color: var(--accent); }

.note.warn { border-left-color: var(--warning); }
.note.warn .note-l { color: var(--warning); }

.docs-art code {
  padding: 1px 5px;
  background: var(--surface-2);
  border: 1px solid var(--line);
  border-radius: var(--r-xs);
  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
  font-size: 0.88em;
  color: var(--text-1);
}

.docs-art pre {
  margin: 18px 0;
  padding: 14px 16px;
  background: var(--surface);
  border: 1px solid var(--line);
  border-radius: var(--r-md);
  overflow-x: auto;
}

.docs-art pre code {
  padding: 0;
  background: none;
  border: 0;
  font-size: 13px;
  line-height: 1.6;
  color: var(--text-2);
}

/* Схема — тот же блок, но с пометкой материала: это не команда для копипасты. */
.docs-art pre.diagram {
  background: var(--bg);
  border-style: dashed;
}

/* ======================= таблицы ======================= */

/* Обёртка нужна, чтобы на телефоне ехала таблица, а не вся страница. */
.tw {
  margin: 18px 0;
  overflow-x: auto;
  border: 1px solid var(--line);
  border-radius: var(--r-md);
}

.docs-art table {
  width: 100%;
  border-collapse: collapse;
  font-size: 14.5px;
}

.docs-art th,
.docs-art td {
  padding: 10px 14px;
  text-align: left;
  border-bottom: 1px solid var(--line-soft);
  vertical-align: top;
}

.docs-art th {
  font-size: 12px;
  letter-spacing: 0.05em;
  text-transform: uppercase;
  color: var(--text-3);
  font-weight: 500;
  background: var(--surface);
  white-space: nowrap;
}

.docs-art td { color: var(--text-2); }

.docs-art tbody tr:last-child td { border-bottom: 0; }

/* ======================= оглавление страницы ======================= */

.toc {
  position: sticky;
  top: calc(var(--head) + 28px);
  padding-left: 16px;
  border-left: 1px solid var(--line-soft);
  align-self: start;
}

.toc-h {
  margin: 0 0 8px;
  font-size: 11px;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--text-3);
}

.toc ul {
  list-style: none;
  margin: 0;
  padding: 0;
  display: grid;
  gap: 6px;
}

.toc a {
  font-size: 13px;
  line-height: 1.4;
  color: var(--text-3);
  transition: color var(--t-fast) var(--ease);
}

.toc a:hover { color: var(--text-1); }
.toc a.on { color: var(--accent); }

/* ======================= указатель разделов ======================= */

.cards {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
  gap: 16px;
}

.card {
  padding: 18px 20px 20px;
  background: var(--surface);
  border: 1px solid var(--line);
  border-radius: var(--r-lg);
}

.card h2 {
  margin: 0 0 10px;
  padding: 0;
  border: 0;
  font-size: 16px;
  color: var(--text-1);
}

.card ul {
  list-style: none;
  margin: 0;
  padding: 0;
  display: grid;
  gap: 6px;
}

.card a {
  font-size: 14px;
  color: var(--text-2);
  text-decoration: none;
}

.card a:hover { color: var(--brass); }

/* ======================= адаптив ======================= */

@media (max-width: 1080px) {
  /* Оглавление уходит первым: колонка с текстом важнее. */
  .docs-main { grid-template-columns: minmax(0, 1fr); }
  .toc { display: none; }
}

@media (max-width: 800px) {
  .docs-shell { grid-template-columns: minmax(0, 1fr); }

  .menu-btn {
    display: inline-block;
    margin-left: auto;
    margin-right: 10px;
    padding: 7px 12px;
    background: var(--surface);
    border: 1px solid var(--line);
    border-radius: var(--r-pill);
    color: var(--text-2);
    font: inherit;
    font-size: 13px;
    cursor: pointer;
  }

  .nav-in .btn { margin-left: 0; }
  .nav-sec { display: none; }
}

/* В шапке документации на одну кнопку больше, чем на лендинге («Разделы»),
   и втроём они уже не встают в строку — логотип переносился на две строки.
   Ниже этой ширины оставляем знак: он и так ведёт на главную. */
@media (max-width: 480px) {
  .docs-body .brand-name { display: none; }

  /* Боковая колонка на телефоне — раскрываемый блок под шапкой, не оверлей:
     поиск должен оставаться доступным одним касанием, без ловушки фокуса. */
  .side {
    position: static;
    max-height: none;
    border-right: 0;
    border-bottom: 1px solid var(--line-soft);
    padding: 16px 0 20px;
  }

  .side-nav { display: none; }
  .side-nav.open { display: block; }
}

/* Экранным читалкам подпись нужна, глазам — нет. */
.vh {
  position: absolute;
  width: 1px;
  height: 1px;
  overflow: hidden;
  clip-path: inset(50%);
  white-space: nowrap;
}