/* KB / explanatory article pattern — breadcrumb, article head, prose, sticky TOC, prev/next nav.
   Requires tokens/tokens.css, tokens/core.css, components/components.css loaded first.
   Prototyped and visually verified in Claude Design before being written here — see README.md.

   Prefix: `kb-` (knowledge-base pattern). Composes with the shared `.wrap`/`.callout` from
   components.css — do not redefine those here. */

.kb-header {
  border-bottom: 1px solid var(--border-subtle);
}

.kb-header-inner {
  display: flex;
  align-items: center;
  justify-content: space-between;
  height: 64px;
}

.kb-brand {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  font-size: var(--font-md);
  font-weight: var(--weight-semibold);
  color: var(--text-primary);
  text-decoration: none;
}

.kb-brand img {
  width: 28px;
  height: 28px;
  flex-shrink: 0;
  display: block;
}

/* Breadcrumbs: shared .breadcrumbs / .kb-breadcrumbs live in components/components.css */

/* Две колонки: оглавление СЛЕВА, статья справа — как у `bridge-waf-static`.
   Прежде было наоборот (статья 680px, оглавление 240px справа), и владелец
   назвал это расхождением с эталоном 2026-08-28. Числа перенесены с WAF
   дословно: 216px под оглавление, `clamp` на промежуток.

   Оглавление ставится в первую колонку правилом сетки, а не порядком в
   разметке: в разметке оно идёт ПОСЛЕ статьи, и так и должно быть —
   читатель без стилей получает сперва текст, а потом список разделов. */
.kb-layout {
  display: grid;
  grid-template-columns: 216px minmax(0, 1fr);
  gap: clamp(32px, 5vw, 72px);
  padding: var(--space-8) 0 clamp(56px, 8vw, 112px);
}

/* Шапка статьи — НАД сеткой, во всю ширину, как у WAF. Прежде она лежала
   внутри правой колонки, и заголовок начинался с отступом в ширину
   оглавления: у эталона он начинается с левого края, на одной вертикали с
   «ON THIS PAGE». Это и было «интерфейс на внутренних другой». */
.kb-article-head {
  padding-block: clamp(40px, 6vw, 88px) clamp(24px, 3vw, 40px);
}

.kb-article-head {
  margin-bottom: var(--space-8);
}

.kb-kicker {
  display: block;
  margin-bottom: var(--space-3);
  color: var(--accent-hover);
  font-size: var(--font-xs);
  font-weight: var(--weight-semibold);
  letter-spacing: 0.08em;
  text-transform: uppercase;
}

.kb-article-head h1 {
  margin: 0 0 var(--space-4);
  /* Коды ошибок и длинные имена — один неразрывный токен: подчёркивание
     переносов не даёт. Без этого заголовок вылезает из колонки и наезжает
     на оглавление. Проверено на ERR_CERT_AUTHORITY_INVALID. */
  overflow-wrap: break-word;
  /* Размеры перенесены с `bridge-waf-static` (`.kb-head h1`): заголовок
     внутренней страницы там заметно крупнее нашего прежнего `--font-4xl`,
     и именно это владелец увидел как «интерфейс другой». `text-wrap:
     balance` и `max-width` не украшение: без них длинный заголовок
     ломается на строку из одного слова.

     21ch → 30ch — решение владельца 2026-08-31: заголовки WAF короче
     наших, и дословный потолок ломал наши в три строки («AEO and GEO:
     the one difference that actually matters» — 52 знака). На 30ch
     самый длинный держится в двух строках. */
  font-size: clamp(30px, 4.4vw, 46px);
  font-weight: 600;
  letter-spacing: -0.03em;
  line-height: 1.14;
  text-wrap: balance;
  max-width: 30ch;
}

.kb-meta {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  color: var(--text-muted);
  font-size: var(--font-sm);
}

.kb-meta .dot {
  width: 3px;
  height: 3px;
  border-radius: 50%;
  background: var(--text-muted);
}

/* ---- Prose ---- */

.kb-prose {
  color: var(--text-secondary);
  font-size: var(--font-md);
  line-height: var(--leading-relaxed);
}

.kb-prose > * + * {
  margin-top: var(--space-5);
}

.kb-prose h2 {
  margin: var(--space-10) 0 var(--space-3);
  color: var(--text-primary);
  font-size: var(--font-xl);
  font-weight: var(--weight-semibold);
  line-height: var(--leading-snug);
  scroll-margin-top: var(--space-8);
}

.kb-prose h3 {
  margin: var(--space-8) 0 var(--space-2);
  color: var(--text-primary);
  font-size: var(--font-lg);
  font-weight: var(--weight-semibold);
  scroll-margin-top: var(--space-8);
}

.kb-prose ul,
.kb-prose ol {
  padding-left: var(--space-6);
}

.kb-prose li + li {
  margin-top: var(--space-2);
}

/* Подчёркивание — фразовым ссылкам, не поверхностям. Карточки раздела
   («In this section», «Continue in this section») и пейджер сами по себе
   ссылки и рендерятся внутри `.kb-prose`; без исключения правило
   подчёркивает каждое слово их описания, и блок читается как стена.

   Дефект ловили дважды. `bridge-ssl-static` починил его у себя в 2026-м
   и оставил комментарий «rendered the section cards as a wall of
   underlined text»; починка осталась локальной, и он повторился на
   `bridge-seo-static`, как только там появились карточки. Теперь правка
   стоит в комплекте — чтобы третьего раза не было. `B-56`.

   На уже разложенные сайты это НЕ доедет: `build.py` копию CSS в
   репозитории сайта не трогает, раскладку делает только `bootstrap.py`.
   `bridge-indexnow-static` дефект несёт до отдельной правки. */
.kb-prose a:not(.nav-card):not(.kb-pager-link) {
  /* `--accent-text` — акцент в роли ТЕКСТА. Сайт, разведший роли, задаёт
     его отдельно: `--accent` может быть затемнён ради подписи кнопки, и
     тогда тот же цвет текстом проваливает AA (у `bridge-seo-static` было
     3.18 при норме 4.5). Откат на `--accent` держит прежнее поведение
     байт в байт для сайтов, где `--accent-text` не объявлен. B-60. */
  /* Ссылка в прозе — ТИХАЯ, как у WAF (`kb.css:172`): цвет обычного
     текста и волосяная линия снизу; акцент появляется только при
     наведении. Прежде она шла акцентным цветом с подчёркиванием, а в
     источниках вдобавок обёрнута в жирный — три сигнала на одну ссылку.
     На странице, где их пять, абзац превращался в поле цветных слов.

     Контраст от этого не страдает: цвет ссылки равен цвету текста,
     который проходит с запасом. Различает её линия, а не яркость. */
  color: var(--text);
  text-decoration: none;
  border-bottom: 1px solid var(--line);
}

.kb-prose a:not(.nav-card):not(.kb-pager-link):hover {
  color: var(--accent-hover);
  border-bottom-color: var(--accent-hover);
}

.kb-prose code {
  padding: 0.15em 0.4em;
  border-radius: var(--radius-sm);
  background: var(--bg-panel-soft);
  color: var(--text-primary);
  font-size: 0.88em;
}

/* Code block: shared .code-block / .kb-code-block live in components/components.css */

/* ---- Sticky in-page TOC ---- */

.kb-toc {
  align-self: start;
  position: sticky;
  top: 84px;
}

/* Подпись блока карточек раздела. Та же роль, что у `.kb-toc-label`
   («On this page»), и до 2026-08-28 у неё не было НИ ОДНОГО правила:
   сборщик выпускал `<p class="kb-cards-label">In this section</p>`, а
   стиля к нему не существовало ни в комплекте, ни у трёх сайтов из
   четырёх. Подпись рисовалась обычным абзацем — то есть выглядела как
   первая строка текста, а не как заголовок группы.

   Оформлена ПО СВОЕМУ образцу, а не по `bridge-ssl-static`, где та же
   подпись идёт моноширинным: `AGENTS.md` этого домена запрещает
   моноширинный на пути конверсии (решение владельца 2026-08-25).
   Совпадает с `.kb-toc-label`, потому что роль одна. */
.kb-cards-label {
  margin: 0 0 var(--space-3);
  color: var(--text-muted);
  font-size: var(--font-xs);
  font-weight: var(--weight-semibold);
  letter-spacing: 0.06em;
  text-transform: uppercase;
}

.kb-toc-label {
  margin-bottom: var(--space-3);
  color: var(--text-muted);
  font-size: var(--font-xs);
  font-weight: var(--weight-semibold);
  letter-spacing: 0.06em;
  text-transform: uppercase;
}

.kb-toc ol {
  margin: 0;
  padding: 0;
  list-style: none;
  border-left: 1px solid var(--border-subtle);
}

.kb-toc li a {
  display: block;
  padding: var(--space-1) 0 var(--space-1) var(--space-4);
  margin-left: -1px;
  border-left: 1px solid transparent;
  color: var(--text-muted);
  font-size: var(--font-sm);
  text-decoration: none;
}

.kb-toc li a:hover {
  color: var(--text-secondary);
}

/* Нумерация с ведущим нулём — приём сети (`bridge-waf-static/kb.css:67`).
   Оглавление из пяти пунктов без номеров читается как список ссылок; с
   номерами — как оглавление, то есть как обещание структуры. Номер
   покрашен цветом волосяной линии: он считается, но не спорит с текстом. */
.kb-toc ol { counter-reset: toc; }
.kb-toc li { counter-increment: toc; }

.kb-toc a::before {
  content: counter(toc, decimal-leading-zero);
  margin-inline-end: var(--space-2);
  font-size: 10px;
  font-weight: var(--weight-regular);
  /* `--dim`, а не `--line`. У WAF номер идёт цветом волосяной линии, и я
     перенёс значение дословно — на наших поверхностях оно дало 1.28 и 1.3,
     то есть номер физически не прочесть. Довод, ради которого нумерация и
     заводилась («список ссылок против оглавления»), при невидимом номере
     не работает: получается не оглавление, а невидимое украшение.

     Замер этого не ловил: текст псевдоэлемента не узел, и обход его не
     видел. Слепое пятно закрыто в `scripts/contrast-audit.mjs`. */
  color: var(--dim);
}

.kb-toc li.is-active a::before { color: var(--accent-text); }

.kb-toc li.is-active a {
  border-left-color: var(--accent);
  color: var(--text-primary);
  font-weight: var(--weight-medium);
}

/* ---- Prev/next footer nav ---- */

.kb-footer-nav {
  display: flex;
  justify-content: space-between;
  gap: var(--space-4);
  margin-top: var(--space-12);
  padding-top: var(--space-6);
  border-top: 1px solid var(--border-subtle);
}

.kb-footer-nav a {
  display: flex;
  flex-direction: column;
  gap: var(--space-1);
  max-width: 260px;
  color: var(--text-primary);
  font-size: var(--font-sm);
  font-weight: var(--weight-medium);
  text-decoration: none;
}

.kb-footer-nav a:hover {
  color: var(--accent-hover);
}

.kb-footer-nav .dir {
  color: var(--text-muted);
  font-size: var(--font-xs);
  font-weight: var(--weight-regular);
  text-transform: uppercase;
  letter-spacing: 0.04em;
}

.kb-footer-nav .next {
  text-align: right;
  margin-left: auto;
}

@media (max-width: 900px) {
  .kb-layout {
    grid-template-columns: 1fr;
  }

  .kb-toc {
    display: none;
  }
}