/* ==========================================================================
   Документация /docs/ — 3-колоночный лэйаут (сайдбар • контент • TOC).
   Дизайн-токены берём из app/config/variables.css. Неймспейс .docs-*,
   чтобы произвольные class/id из контента статей не конфликтовали с лэйаутом.
   ========================================================================== */

:root {
    --docs-sidebar-w: 264px;
    --docs-toc-w: 240px;
    --docs-gap: clamp(20px, 2.5vw, 40px);
    --docs-header-h: 62px; /* фолбэк; реальная высота шапки задаётся docs.js (clamp/vw) */
    --docs-sticky-top: 110px; /* фолбэк; пересчитывается в docs.js: шапка + крошки */
    --docs-border: rgba(0, 0, 0, 0.08);
    --docs-muted: rgba(0, 0, 0, 0.6); /* темнее сайтового --black-50 ради контраста WCAG AA */
    --docs-accent: var(--brand-primary, #0063f7);
    --docs-surface: #ffffff;
    --docs-radius: var(--radius-16, 14px);
}

.page-docs {
    background-color: var(--bf-background-site, #f5f5f5);
}

/* Глобальный .wrapper имеет overflow:hidden, что ломает position:sticky
   у сайдбара/TOC. На docs-страницах разрешаем overflow, чтобы фиксация
   работала — скроллится только контент статьи. */
.page-docs .wrapper {
    overflow: visible;
}

/* Хлебные крошки фиксируются вплотную под видимой шапкой (.header__middle
   заканчивается на 75px). padding-bottom стыкует фон крошек с сайдбаром/TOC
   (top: 110px) — без «дырок» со скроллящимся контентом ни сверху, ни снизу. */
.page-docs .breadcrumbs {
    position: sticky;
    top: var(--docs-header-h, 62px);
    z-index: 50;
    padding: 12px 0;
    background-color: var(--bf-background-site, #f5f5f5);
    margin: 0;

    .breadcrumbs__list {
        padding: 0;
    }
}

/* Глобальный base.css добавляет li::before "•" и margin:24px 0; глушим их для
   служебных списков (сайдбар, TOC, карточки). В теле статьи маркеры остаются. */
.docs-nav li::before,
.docs-toc__list li::before,
.docs-list li::before {
    content: none;
    display: none;
}

.docs-nav li,
.docs-toc__list li,
.docs-list li {
    margin: 0;
}

/* ---------- Каркас ---------- */
.docs {
    /* .wrapper — flex-column min-height:100vh; растягиваем контент, чтобы на
       коротких страницах футер прижимался к низу экрана (без «дырки»). */
    flex: 1 0 auto;
    padding: clamp(16px, 3vw, 40px) 0 clamp(48px, 6vw, 96px);
}

.docs__container {
    display: grid;
    grid-template-columns: var(--docs-sidebar-w) minmax(0, 1fr) var(--docs-toc-w);
    gap: var(--docs-gap);
    align-items: start;
}

.docs__main {
    min-width: 0; /* позволяет содержимому переноситься, а не распирать грид */
}

/* ---------- Сайдбар ---------- */
.docs__sidebar {
    position: sticky;
    top: var(--docs-sticky-top);
    max-height: calc(100vh - var(--docs-sticky-top) - 16px);
    overflow-y: auto;
    overscroll-behavior: contain;
    padding-right: 4px;
}

.docs-nav__list {
    list-style: none;
    margin: 0;
    padding: 0;
}

.docs-nav__group {
    margin-bottom: 6px;
}

.docs-nav__section {
    display: block;
    padding: 8px 12px;
    border-radius: 10px;
    font-family: var(--second-family, "Montserrat", sans-serif);
    font-weight: 600;
    font-size: 15px;
    line-height: 1.3;
    color: var(--color-text--black, #000);
    text-decoration: none;
    transition: background-color 0.15s ease, color 0.15s ease;
}

.docs-nav__section:hover {
    background-color: rgba(0, 99, 247, 0.06);
    color: var(--docs-accent);
}

.docs-nav__section.is-active {
    color: var(--docs-accent);
    background-color: rgba(0, 99, 247, 0.08);
}

.docs-nav__articles {
    list-style: none;
    margin: 2px 0 8px;
    padding: 0 0 0 12px;
    border-left: 1px solid var(--docs-border);
}

.docs-nav__article {
    display: block;
    padding: 6px 12px;
    border-radius: 8px;
    font-size: 14px;
    line-height: 1.35;
    color: var(--docs-muted);
    text-decoration: none;
    transition: color 0.15s ease, background-color 0.15s ease;
}

.docs-nav__article:hover {
    color: var(--docs-accent);
    background-color: rgba(0, 99, 247, 0.05);
}

.docs-nav__article.is-current {
    color: var(--docs-accent);
    font-weight: 600;
    background-color: rgba(0, 99, 247, 0.08);
}

.docs-nav__empty {
    color: var(--docs-muted);
    font-size: 14px;
    padding: 8px 12px;
}

/* ---------- Поиск ---------- */
.docs-search {
    position: relative;
    display: flex;
    align-items: center;
    margin-bottom: 16px;
}

.docs-search__input {
    width: 100%;
    padding: 10px 40px 10px 14px;
    border: 1px solid var(--docs-border);
    border-radius: 12px;
    background-color: var(--docs-surface);
    font-family: var(--font-family, "Inter", sans-serif);
    font-size: 14px;
    color: var(--color-text--black, #000);
    outline: none;
    transition: border-color 0.15s ease, box-shadow 0.15s ease;
}

.docs-search__input:focus {
    border-color: var(--docs-accent);
    /*box-shadow: 0 0 0 3px rgba(0, 99, 247, 0.12);*/
}

.docs-search__btn {
    position: absolute;
    right: 6px;
    display: inline-flex;
    align-items: center;
    justify-content: center;
    width: 30px;
    height: 30px;
    border: none;
    border-radius: 8px;
    background: transparent;
    color: var(--docs-muted);
    cursor: pointer;
    transition: color 0.15s ease;
}

.docs-search__btn:hover {
    color: var(--docs-accent);
}

/* ---------- Контент ---------- */
.docs-hero {
    margin-bottom: clamp(24px, 4vw, 40px);
}

.docs-hero__title {
    font-family: var(--second-family, "Montserrat", sans-serif);
    font-weight: 700;
    font-size: clamp(28px, 3vw, 44px);
    line-height: 1.15;
    margin: 0 0 10px;
    color: var(--color-text--black, #000);
}

.docs-hero__subtitle {
    font-size: clamp(16px, 1.4vw, 19px);
    line-height: 1.5;
    color: var(--docs-muted);
    margin: 0;
    max-width: 60ch;
}

/* Карточки разделов (index) */
.docs-cards {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
    gap: clamp(12px, 1.5vw, 20px);
}

.docs-card {
    display: flex;
    flex-direction: column;
    gap: 6px;
    padding: 20px;
    border: 1px solid var(--docs-border);
    border-radius: var(--docs-radius);
    background-color: var(--docs-surface);
    text-decoration: none;
    transition: transform 0.15s ease, box-shadow 0.2s ease, border-color 0.15s ease;
}

.docs-card:hover {
    transform: translateY(-2px);
    box-shadow: var(--shadow, 0 0 25px rgba(0, 0, 0, 0.06));
    border-color: rgba(0, 99, 247, 0.3);
}

.docs-card__title {
    font-family: var(--second-family, "Montserrat", sans-serif);
    font-weight: 600;
    font-size: 18px;
    line-height: 1.3;
    color: var(--color-text--black, #000);
}

.docs-card__desc {
    font-size: 14px;
    line-height: 1.45;
    color: var(--docs-muted);
}

.docs-card__count {
    margin-top: auto;
    font-size: 13px;
    color: var(--docs-accent);
    font-weight: 500;
}

/* Список статей (section/search) */
.docs-list {
    list-style: none;
    margin: 0;
    padding: 0;
    display: flex;
    flex-direction: column;
    gap: 10px;
}

.docs-list__link {
    display: flex;
    flex-direction: column;
    gap: 4px;
    padding: 16px 18px;
    border: 1px solid var(--docs-border);
    border-radius: 12px;
    background-color: var(--docs-surface);
    text-decoration: none;
    transition: border-color 0.15s ease, box-shadow 0.2s ease;
}

.docs-list__link:hover {
    border-color: rgba(0, 99, 247, 0.3);
    box-shadow: var(--shadow, 0 0 25px rgba(0, 0, 0, 0.05));
}

.docs-list__title {
    font-weight: 600;
    font-size: 16px;
    color: var(--color-text--black, #000);
}

.docs-list__desc {
    font-size: 14px;
    color: var(--docs-muted);
    line-height: 1.45;
}

.docs-list__crumb {
    font-size: 12px;
    color: var(--docs-accent);
    text-transform: uppercase;
    letter-spacing: 0.03em;
}

.docs-empty {
    color: var(--docs-muted);
    padding: 8px 0;
}

.docs-search__summary {
    margin: 0 0 16px;
    font-size: 14px;
    color: var(--docs-muted);
}

.docs-search__summary strong {
    color: var(--color-text--black, #000);
    font-weight: 600;
}

/* ---------- Тело статьи (типографика безопасного HTML) ---------- */
.docs-article {
    background-color: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: var(--docs-radius);
    padding: clamp(20px, 3vw, 40px);
}

.docs-article__title {
    font-family: var(--second-family, "Montserrat", sans-serif);
    font-weight: 700;
    font-size: clamp(24px, 2.6vw, 36px);
    line-height: 1.2;
    margin: 0 0 20px;
    color: var(--color-text--black, #000);
}

.docs-section__intro {
    font-size: 17px;
    line-height: 1.5;
    color: var(--docs-muted);
    margin: 0 0 24px;
}

.docs-article__body {
    font-size: 16px;
    line-height: 1.65;
    color: var(--color-text--black-85, rgba(0, 0, 0, 0.85));
}

.docs-article__body h2 {
    font-family: var(--second-family, "Montserrat", sans-serif);
    font-weight: 700;
    font-size: 24px;
    line-height: 1.25;
    margin: 36px 0 14px;
    scroll-margin-top: 112px;
    color: var(--color-text--black, #000);
}

.docs-article__body h3 {
    font-weight: 600;
    font-size: 20px;
    line-height: 1.3;
    margin: 28px 0 12px;
    scroll-margin-top: 112px;
    color: var(--color-text--black, #000);
}

.docs-article__body h4 {
    font-weight: 600;
    font-size: 17px;
    margin: 22px 0 10px;
    scroll-margin-top: 112px;
}

.docs-article__body p {
    margin: 0 0 16px;
}

.docs-article__body ul,
.docs-article__body ol {
    margin: 0 0 16px;
    padding-left: 24px;
}

.docs-article__body li {
    margin-bottom: 6px;
}

.docs-article__body a {
    color: var(--docs-accent);
    text-decoration: underline;
    text-underline-offset: 2px;
}

.docs-article__body img {
    max-width: 100%;
    height: auto;
    border-radius: 10px;
    border: 1px solid var(--docs-border);
    margin: 12px 0;
    cursor: zoom-in;
}

.docs-article__body figure {
    margin: 16px 0;
}

.docs-article__body figcaption {
    font-size: 13px;
    color: var(--docs-muted);
    margin-top: 6px;
    text-align: center;
}

.docs-article__body blockquote {
    margin: 16px 0;
    padding: 12px 18px;
    border-left: 3px solid var(--docs-accent);
    background-color: rgba(0, 99, 247, 0.04);
    border-radius: 0 8px 8px 0;
    color: var(--color-text--black-85, rgba(0, 0, 0, 0.85));
}

.docs-article__body code {
    font-family: "SFMono-Regular", Consolas, "Liberation Mono", monospace;
    font-size: 0.9em;
    padding: 2px 6px;
    border-radius: 6px;
    background-color: rgba(0, 0, 0, 0.05);
}

.docs-article__body pre {
    margin: 16px 0;
    padding: 16px;
    border-radius: 10px;
    background-color: #0d1117;
    color: #e6edf3;
    overflow-x: auto;
}

.docs-article__body pre code {
    padding: 0;
    background: transparent;
    color: inherit;
}

.docs-article__body table {
    width: 100%;
    border-collapse: collapse;
    margin: 16px 0;
    font-size: 14px;
}

.docs-article__body th,
.docs-article__body td {
    border: 1px solid var(--docs-border);
    padding: 8px 12px;
    text-align: left;
}

.docs-article__body th {
    background-color: rgba(0, 0, 0, 0.03);
    font-weight: 600;
}

/* ---------- Предыдущая / следующая ---------- */
.docs-prevnext {
    display: flex;
    justify-content: space-between;
    gap: 16px;
    margin-top: 40px;
    padding-top: 24px;
    border-top: 1px solid var(--docs-border);
}

.docs-prevnext__link {
    display: flex;
    flex-direction: column;
    gap: 4px;
    flex: 1;
    max-width: 48%;
    padding: 14px 18px;
    border: 1px solid var(--docs-border);
    border-radius: 12px;
    text-decoration: none;
    transition: border-color 0.15s ease, box-shadow 0.2s ease;
}

.docs-prevnext__link:hover {
    border-color: rgba(0, 99, 247, 0.3);
    box-shadow: var(--shadow, 0 0 25px rgba(0, 0, 0, 0.05));
}

.docs-prevnext__link--next {
    text-align: right;
    margin-left: auto;
}

.docs-prevnext__dir {
    font-size: 13px;
    color: var(--docs-muted);
}

.docs-prevnext__title {
    font-weight: 600;
    color: var(--docs-accent);
}

.docs-prevnext__spacer {
    flex: 1;
    max-width: 48%;
}

/* ---------- Пагинация поиска ---------- */
.docs-pager {
    display: flex;
    align-items: center;
    justify-content: center;
    gap: 16px;
    margin-top: 24px;
}

.docs-pager__link {
    color: var(--docs-accent);
    text-decoration: none;
    font-weight: 500;
}

.docs-pager__status {
    color: var(--docs-muted);
    font-size: 14px;
}

/* ---------- TOC «на этой странице» ---------- */
.docs__aside {
    position: sticky;
    top: var(--docs-sticky-top);
    max-height: calc(100vh - var(--docs-sticky-top) - 16px);
    overflow-y: auto;
}

.docs-toc__title {
    font-size: 13px;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.04em;
    color: var(--docs-muted);
    margin: 0 0 12px;
}

.docs-toc__list {
    list-style: none;
    margin: 0;
    padding: 0;
    border-left: 1px solid var(--docs-border);
}

.docs-toc__item a {
    display: block;
    padding: 4px 0 4px 14px;
    margin-left: -1px;
    border-left: 2px solid transparent;
    font-size: 13px;
    line-height: 1.4;
    color: var(--docs-muted);
    text-decoration: none;
    transition: color 0.15s ease, border-color 0.15s ease;
}

.docs-toc__item--h3 a {
    padding-left: 26px;
    font-size: 12.5px;
}

.docs-toc__item a:hover {
    color: var(--docs-accent);
}

.docs-toc__item.is-active a {
    color: var(--docs-accent);
    border-left-color: var(--docs-accent);
    font-weight: 500;
}

/* ---------- Кнопка мобильного сайдбара ---------- */
.docs__sidebar-toggle {
    display: none;
    align-items: center;
    gap: 10px;
    width: 100%;
    margin-bottom: 16px;
    padding: 12px 16px;
    border: 1px solid var(--docs-border);
    border-radius: 12px;
    background-color: var(--docs-surface);
    font-family: var(--second-family, "Montserrat", sans-serif);
    font-weight: 600;
    font-size: 15px;
    color: var(--color-text--black, #000);
    cursor: pointer;
}

.docs__sidebar-toggle-icon,
.docs__sidebar-toggle-icon::before,
.docs__sidebar-toggle-icon::after {
    display: block;
    width: 18px;
    height: 2px;
    background-color: currentColor;
    position: relative;
}

.docs__sidebar-toggle-icon::before,
.docs__sidebar-toggle-icon::after {
    content: "";
    position: absolute;
    left: 0;
}

.docs__sidebar-toggle-icon::before { top: -6px; }
.docs__sidebar-toggle-icon::after { top: 6px; }

.docs__overlay {
    display: none;
    position: fixed;
    inset: 0;
    z-index: 105; /* выше фиксированной шапки сайта (z-index:100) */
    background-color: rgba(0, 0, 0, 0.4);
}

.docs__overlay.is-visible {
    display: block;
}

/* Кнопка закрытия внутри drawer (видна только на мобильных).
   В потоке, прижата вправо — чтобы не перекрывать поле поиска. */
.docs__sidebar-close {
    display: none;
    width: 36px;
    height: 36px;
    margin: -4px -4px 6px auto;
    border: none;
    border-radius: 8px;
    background: transparent;
    font-size: 28px;
    line-height: 1;
    color: var(--color-text--black, #000);
    cursor: pointer;
}

.docs__sidebar-close:hover {
    color: var(--docs-accent);
}

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

/* Планшет: убираем правый TOC, сайдбар остаётся слева */
@media (max-width: 1100px) {
    .docs__container {
        grid-template-columns: var(--docs-sidebar-w) minmax(0, 1fr);
    }
    .docs__aside {
        display: none;
    }
}

/* Мобильный: одна колонка, сайдбар — выезжающий drawer */
@media (max-width: 768px) {
    /* На мобильных крошки переносятся в несколько строк и занимают много
       места — скрываем их (навигация доступна через сайдбар-drawer). */
    .page-docs .breadcrumbs {
        display: none;
    }

    .docs__container {
        grid-template-columns: minmax(0, 1fr);
    }

    .docs__sidebar-toggle {
        display: inline-flex;
    }

    .docs__sidebar-close {
        display: block;
    }

    .docs__sidebar {
        position: fixed;
        top: 0;
        left: 0;
        z-index: 110; /* выше шапки сайта (z-index:100) и overlay (105) */
        width: min(86vw, 320px);
        max-height: 100vh;
        height: 100vh;
        margin: 0;
        padding: 20px 16px;
        background-color: var(--docs-surface);
        box-shadow: 4px 0 24px rgba(0, 0, 0, 0.12);
        transform: translateX(-105%);
        transition: transform 0.25s ease;
    }

    .docs__sidebar.is-open {
        transform: translateX(0);
    }

    .docs-cards {
        grid-template-columns: 1fr;
    }

    .docs-prevnext {
        flex-direction: column;
    }

    .docs-prevnext__link,
    .docs-prevnext__link--next {
        max-width: 100%;
        text-align: left;
    }
}

/* === Lightbox: просмотр картинок статьи на весь экран (docs.js) === */
.docs-lightbox {
    position: fixed;
    inset: 0;
    z-index: 110; /* выше шапки сайта (100) и оверлея сайдбара (105) */
    display: flex;
    align-items: center;
    justify-content: center;
    padding: 4vmin;
    background: rgba(0, 0, 0, 0.85);
    opacity: 0;
    transition: opacity 0.2s ease;
}

.docs-lightbox[hidden] {
    display: none;
}

.docs-lightbox.is-open {
    opacity: 1;
}

.docs-lightbox__img {
    max-width: 92vw;
    max-height: 92vh;
    border-radius: 10px;
    box-shadow: 0 12px 48px rgba(0, 0, 0, 0.5);
    transform: scale(0.98);
    transform-origin: center center;
    transition: transform 0.18s ease;
    cursor: zoom-in;
    touch-action: none; /* тач-зум/панорамирование не должны скроллить фон */
    will-change: transform;
    user-select: none;
    -webkit-user-drag: none;
}

.docs-lightbox.is-open .docs-lightbox__img {
    transform: scale(1);
}

/* Приближённое состояние: курсор-«рука» для перетаскивания (панорамирования). */
.docs-lightbox__img.is-zoomed {
    cursor: grab;
}

.docs-lightbox__img.is-zoomed:active {
    cursor: grabbing;
}

.docs-lightbox__close {
    position: absolute;
    top: 12px;
    right: 12px;
    width: 48px;
    height: 48px;
    display: flex;
    align-items: center;
    justify-content: center;
    padding: 0;
    background: transparent;
    border: none;
    cursor: pointer;
}

/* Крестик как в .popup__close-icon проекта: круг + две диагональные линии. */
.docs-lightbox__close-icon {
    position: relative;
    width: 30px;
    height: 30px;
    border-radius: 100px;
    background: #ffffff26;
    transition: background 0.3s ease;
}

.docs-lightbox__close-icon::before,
.docs-lightbox__close-icon::after {
    content: "";
    position: absolute;
    inset: 0;
    width: 15px;
    height: 2px;
    margin: auto;
    background: #fff;
}

.docs-lightbox__close-icon::before {
    transform: rotate(-45deg);
}

.docs-lightbox__close-icon::after {
    transform: rotate(45deg);
}

.docs-lightbox__close:hover .docs-lightbox__close-icon {
    background: #ffffff40;
}

/* Блокировка прокрутки фона, пока открыт lightbox. */
body.docs-lightbox-lock {
    overflow: hidden;
}

@media (prefers-reduced-motion: reduce) {
    .docs-lightbox,
    .docs-lightbox__img {
        transition: none;
    }

    .docs-lightbox__img {
        transform: none;
    }
}