/* docs.css — стили сайта документации мерчанта (docs.${PUBLIC_DOMAIN}).
 *
 * Не копия services/api-gateway/.../static/css/cab-admin.css — отдельный
 * файл под другую задачу (длинный текст, а не приборная панель), но те же
 * цветовые токены и те же имена шрифтов, чтобы документация и кабинеты
 * читались одним продуктом, а не двумя разными сайтами. Значения токенов
 * взяты оттуда же намеренно: сверяться при правке цвета.
 *
 * Шрифты — Onest/Inter/JetBrains Mono теми же именами и с тем же порядком
 * фолбэков, что в кабинетах, но БЕЗ @font-face и без файлов шрифтов: сборка
 * кабинетных шрифтов (scripts/build-cabinet-fonts.py) тянет их из
 * node_modules, а в этом проекте нет Node и не должно появиться ради
 * девяти страниц документации. Если шрифты стоят у читателя в системе —
 * подхватятся; если нет — упадёт на системный sans-serif, ничего не
 * сломается.
 */

:root{
  --bg:#0A0B10; --elev:#0C0D13; --panel:#16171F; --panel-2:#1F202A; --sunk:#121319; --field:#1A1B24;
  --glow:radial-gradient(1300px 700px at 84% -12%, rgba(124,120,248,.16), transparent 56%), radial-gradient(1050px 580px at -3% 4%, rgba(88,128,214,.09), transparent 52%);
  --hover:rgba(233,236,245,.05);
  --line:rgba(233,236,245,.09); --line-2:rgba(233,236,245,.16); --hi:rgba(255,255,255,.055);
  --text:#ECEEF3; --text-2:rgba(236,238,243,.72); --text-3:rgba(236,238,243,.50); --micro:rgba(236,238,243,.60);
  --act:#6D6AF2; --act-2:#8E8BF7; --act-ink:#fff; --act-soft:rgba(109,106,242,.20); --act-glow:rgba(109,106,242,.45);
  --ok:#42C98A; --warn:#E6B45C; --bad:#E9788A; --info:#5AA9C9;
  --shadow-card:0 1px 2px rgba(0,0,0,.3), 0 10px 26px -18px rgba(0,0,0,.55);
  --shadow-pop:0 1px 2px rgba(0,0,0,.4), 0 24px 54px -22px rgba(0,0,0,.72);
  --disp:'Onest','Inter',sans-serif; --sans:'Inter',-apple-system,'Segoe UI',sans-serif;
  --mono:'JetBrains Mono',ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;
  --r-lg:16px; --r-md:12px; --r-sm:10px; --r-xs:8px;
}
:root[data-theme="light"]{
  --bg:#EEF1F5; --elev:#F7F9FC; --panel:#FFFFFF; --panel-2:#F4F6FA; --sunk:#E7EAF0; --field:#F1F3F7;
  --glow:none;
  --hover:rgba(17,20,30,.045);
  --line:rgba(17,20,30,.09); --line-2:rgba(17,20,30,.14); --hi:rgba(255,255,255,.6);
  --text:#14161D; --text-2:rgba(20,22,29,.72); --text-3:rgba(20,22,29,.50); --micro:rgba(20,22,29,.56);
  --act:#5A56E6; --act-2:#4A46D8; --act-ink:#fff; --act-soft:rgba(90,86,230,.14); --act-glow:rgba(90,86,230,.32);
  --ok:#0F9E63; --warn:#B07C24; --bad:#D64560; --info:#3C7FA0;
  --shadow-card:0 1px 2px rgba(20,22,29,.05), 0 4px 10px -4px rgba(20,22,29,.08), 0 14px 32px -18px rgba(20,22,29,.10);
  --shadow-pop:0 1px 3px rgba(20,22,29,.12), 0 24px 50px -20px rgba(20,22,29,.24);
}

*{box-sizing:border-box;margin:0;padding:0}
html{scroll-behavior:smooth}
@media (prefers-reduced-motion:reduce){*{transition:none!important;animation:none!important;scroll-behavior:auto}}
body{
  background:var(--glow,none),var(--bg);background-attachment:fixed;
  color:var(--text);font-family:var(--sans);font-size:15.5px;line-height:1.65;
  -webkit-font-smoothing:antialiased;text-rendering:optimizeLegibility;
  min-height:100vh;
}
a{color:var(--act);text-decoration:none}
a:hover{text-decoration:underline}
:focus-visible{outline:2px solid var(--act);outline-offset:2px}

/* ---------- каркас: сайдбар | статья | оглавление ---------- */
.shell{
  display:grid;
  grid-template-columns:260px minmax(0,1fr) 240px;
  gap:0;
  max-width:1440px;
  margin:0 auto;
  min-height:100vh;
}

.side{
  border-right:1px solid var(--line);
  padding:20px 16px 32px;
  position:sticky;
  top:0;
  align-self:start;
  height:100vh;
  overflow-y:auto;
  background:var(--elev);
}
.side .brand{
  display:flex;align-items:baseline;gap:6px;
  font-family:var(--disp);font-weight:800;font-size:17px;letter-spacing:-.01em;
  padding:6px 8px 18px;
}
.side .brand small{font-family:var(--mono);font-weight:600;font-size:11px;color:var(--text-3);letter-spacing:.04em}
.side nav{display:flex;flex-direction:column;gap:2px}
.side .nav-item{
  display:block;padding:8px 10px;border-radius:var(--r-sm);
  color:var(--text-2);font-size:13.5px;line-height:1.35;
  transition:background .14s,color .14s;
}
.side .nav-item:hover{background:var(--hover);color:var(--text);text-decoration:none}
.side .nav-item.on{background:var(--act-soft);color:var(--act);font-weight:600}
.side .side-foot{
  margin-top:20px;padding-top:16px;border-top:1px solid var(--line);
  display:flex;flex-direction:column;gap:10px;
}
.theme-btn{
  display:inline-flex;align-items:center;gap:8px;
  font-family:var(--sans);font-size:12.5px;font-weight:600;color:var(--text-2);
  background:var(--panel);border:1px solid var(--line);border-radius:999px;
  padding:7px 13px;cursor:pointer;box-shadow:inset 0 1px 0 var(--hi);
  transition:color .14s,border-color .14s;
}
.theme-btn:hover{color:var(--text);border-color:var(--line-2)}
.theme-btn .ic-dark{display:none}
:root[data-theme="light"] .theme-btn .ic-light{display:none}
:root[data-theme="light"] .theme-btn .ic-dark{display:inline}

/* ---------- контент ---------- */
.content{min-width:0;padding:0 40px}
.topbar{
  display:none; /* только на мобильном, см. медиа-запрос ниже */
  align-items:center;justify-content:space-between;
  padding:14px 16px;border-bottom:1px solid var(--line);
  position:sticky;top:0;z-index:30;
  background:color-mix(in srgb,var(--bg) 88%,transparent);
  backdrop-filter:blur(14px) saturate(1.4);
}
.topbar .brand{font-family:var(--disp);font-weight:800;font-size:15px}
.nav-toggle{
  width:36px;height:36px;border-radius:var(--r-sm);border:1px solid var(--line);
  background:var(--panel);color:var(--text);display:flex;align-items:center;justify-content:center;
}

article{max-width:760px;margin:0 auto;padding:44px 0 80px}

article h1{
  font-family:var(--disp);font-weight:800;font-size:30px;letter-spacing:-.02em;
  line-height:1.2;margin:0 0 18px;
}
article h2{
  font-family:var(--disp);font-weight:700;font-size:21px;letter-spacing:-.01em;
  margin:40px 0 14px;padding-top:6px;
  border-top:1px solid var(--line);
}
article h1 + h2, article > .lead + h2{border-top:none;padding-top:0}
article h3{font-family:var(--disp);font-weight:700;font-size:16.5px;margin:28px 0 10px}
article h4{font-family:var(--disp);font-weight:600;font-size:14.5px;margin:22px 0 8px;color:var(--text-2)}
article h2 .heading-anchor,article h3 .heading-anchor,article h4 .heading-anchor{
  opacity:0;margin-left:8px;font-weight:400;color:var(--text-3);font-size:.85em;
  transition:opacity .12s;
}
article h2:hover .heading-anchor,article h3:hover .heading-anchor,article h4:hover .heading-anchor{opacity:1}

article p{margin:0 0 16px}
article ul,article ol{margin:0 0 16px;padding-left:1.4em}
article li{margin:0 0 7px}
article li:last-child{margin-bottom:0}
article strong{font-weight:700;color:var(--text)}
article hr{border:none;border-top:1px solid var(--line);margin:32px 0}

article code{
  font-family:var(--mono);font-size:.87em;
  background:var(--field);border:1px solid var(--line);border-radius:5px;
  padding:.15em .4em;color:var(--act-2);
  word-break:break-word;
}
:root[data-theme="light"] article code{color:var(--act)}

article blockquote{
  margin:0 0 20px;padding:16px 18px;border-radius:var(--r-md);
  background:var(--panel);border:1px solid var(--line);border-left:3px solid var(--line-2);
}
article blockquote h2,article blockquote h3{
  margin-top:0;font-size:15px;border-top:none;padding-top:0;
  display:flex;align-items:center;gap:8px;
}
article blockquote > *:last-child{margin-bottom:0}
/* Предупреждение: заголовок блока начинается с ⚠️ — тот же приём, что и в
   исходном markdown, здесь просто получает акцентную рамку. Определяем по
   наличию эмодзи не через CSS (не умеет), а классом не размечаем нарочно:
   правило работает по контенту, не по обвесу — markdown остаётся источником
   истины, css лишь подсвечивает то, что уже написано текстом. */
article blockquote:has(h2 :first-child),
article blockquote:has(h3 :first-child){
  border-left-color:var(--warn);
  background:color-mix(in srgb, var(--warn) 7%, var(--panel));
}

.table-wrap{overflow-x:auto;margin:0 0 20px;border:1px solid var(--line);border-radius:var(--r-md)}
article table{width:100%;border-collapse:collapse;font-size:13.5px}
article th,article td{
  text-align:left;padding:10px 14px;border-bottom:1px solid var(--line);
  vertical-align:top;
}
article thead th{
  background:var(--panel-2);font-family:var(--sans);font-weight:600;
  color:var(--text-2);font-size:12px;text-transform:uppercase;letter-spacing:.04em;
  white-space:nowrap;
}
article tbody tr:last-child td{border-bottom:none}
article tbody tr:hover{background:var(--hover)}
article td code,article th code{white-space:nowrap}

/* ---------- блок кода + кнопка "копировать" ---------- */
.code-block{
  margin:0 0 20px;border:1px solid var(--line);border-radius:var(--r-md);
  overflow:hidden;background:var(--sunk);box-shadow:var(--shadow-card);
}
.code-head{
  display:flex;align-items:center;justify-content:space-between;gap:10px;
  padding:8px 12px;border-bottom:1px solid var(--line);
  background:var(--panel-2);
}
.code-lang{
  font-family:var(--mono);font-size:11px;text-transform:uppercase;letter-spacing:.08em;
  color:var(--micro);
}
.copy-btn{
  font-family:var(--sans);font-size:12px;font-weight:600;color:var(--text-2);
  background:var(--panel);border:1px solid var(--line);border-radius:var(--r-xs);
  padding:5px 11px;cursor:pointer;transition:color .14s,border-color .14s,background .14s;
}
.copy-btn:hover{color:var(--text);border-color:var(--line-2)}
.copy-btn.is-copied{color:var(--ok);border-color:color-mix(in srgb,var(--ok) 40%,transparent)}
.code-block pre{
  margin:0;padding:14px 16px;overflow-x:auto;
  font-family:var(--mono);font-size:13px;line-height:1.6;
}
.code-block code{
  background:none;border:none;padding:0;color:var(--text);
  font-size:inherit;font-family:inherit;
}

/* ---------- пейджер назад/вперёд ---------- */
.pager{
  display:grid;grid-template-columns:1fr 1fr;gap:14px;
  margin-top:36px;padding-top:24px;border-top:1px solid var(--line);
}
.pager a{
  display:flex;flex-direction:column;gap:4px;
  padding:14px 16px;border:1px solid var(--line);border-radius:var(--r-md);
  background:var(--panel);box-shadow:var(--shadow-card);color:var(--text);
  transition:border-color .14s;
}
.pager a:hover{border-color:var(--act);text-decoration:none}
.pager .pager-dir{font-size:11px;color:var(--text-3);text-transform:uppercase;letter-spacing:.06em}
.pager .pager-title{font-family:var(--disp);font-weight:600;font-size:14px}
.pager .pager-next{grid-column:2;text-align:right;align-items:flex-end}
.pager-empty{visibility:hidden}

/* ---------- оглавление страницы ---------- */
.toc{
  border-left:1px solid var(--line);
  padding:44px 20px 40px 24px;
  position:sticky;top:0;align-self:start;height:100vh;overflow-y:auto;
}
.toc-title{
  font-family:var(--mono);font-size:11px;text-transform:uppercase;letter-spacing:.1em;
  color:var(--micro);margin-bottom:12px;
}
.toc nav{display:flex;flex-direction:column;gap:6px;font-size:13px}
.toc a{color:var(--text-2);line-height:1.4}
.toc a:hover{color:var(--act);text-decoration:none}
.toc .toc-h3{padding-left:14px;font-size:12.5px;color:var(--text-3)}

/* ---------- скроллбар (webkit) — тоньше системного, в цвет темы ---------- */
.side::-webkit-scrollbar,.toc::-webkit-scrollbar,.table-wrap::-webkit-scrollbar,
.code-block pre::-webkit-scrollbar{height:8px;width:8px}
.side::-webkit-scrollbar-thumb,.toc::-webkit-scrollbar-thumb,
.table-wrap::-webkit-scrollbar-thumb,.code-block pre::-webkit-scrollbar-thumb{
  background:var(--line-2);border-radius:999px;
}

/* ---------- 404 ---------- */
.error-page{
  max-width:520px;margin:14vh auto 0;padding:0 20px;text-align:center;
}
.error-page .code{font-family:var(--mono);font-size:13px;color:var(--text-3);margin-bottom:10px}
.error-page h1{font-family:var(--disp);font-size:26px;margin-bottom:14px}
.error-page p{color:var(--text-2);margin-bottom:22px}

/* ============================================================
   Мобильная раскладка — обязательное требование задачи.
   Ломаем grid на один столбец, прячем оглавление страницы (для длинного
   текста на телефоне оно менее полезно, чем сама статья), сайдбар уходит
   за кнопку-гамбургер и выезжает поверх контента по клику.
   ============================================================ */
@media (max-width:1180px){
  .shell{grid-template-columns:260px minmax(0,1fr)}
  .toc{display:none}
}

@media (max-width:860px){
  .shell{display:block}
  .topbar{display:flex}
  .side{
    position:fixed;inset:0 30% 0 0;z-index:40;
    transform:translateX(-100%);transition:transform .18s ease;
    box-shadow:var(--shadow-pop);
  }
  .side.is-open{transform:none}
  .content{padding:0 16px}
  article{padding:28px 0 64px}
  article h1{font-size:24px}
  .pager{grid-template-columns:1fr}
  .pager .pager-next{grid-column:1;text-align:left;align-items:flex-start}
}

@media (max-width:480px){
  body{font-size:15px}
  .content{padding:0 14px}
}
