.api-docs {
    display: grid;
    grid-template-columns: 300px 1fr;
    gap: 0;
    min-height: calc(100vh - var(--sa-header-h));
    margin-top: var(--sa-header-h);
    background: var(--sa-bg);
    color: var(--sa-ink);
}

.api-docs .sidebar {
    background: var(--sa-bg-soft);
    color: var(--sa-ink-soft);
    border-right: 1px solid var(--sa-border);
    padding: var(--sa-space-3) var(--sa-space-2);
    overflow-y: auto;
    position: sticky;
    top: var(--sa-header-h);
    height: calc(100vh - var(--sa-header-h));
}

.api-docs .sidebar h2 {
    margin: 0 0 var(--sa-space-2);
    padding-left: 12px;
    font-size: 12px;
    text-transform: uppercase;
    letter-spacing: 0.14em;
    color: var(--sa-muted);
    font-weight: 700;
}

.api-docs .sidebar-toggle {
    display: none;
    align-items: center;
    gap: 8px;
    background: var(--sa-bg);
    color: var(--sa-ink);
    border: 1px solid var(--sa-border);
    padding: 12px 16px;
    font-weight: 500;
    width: 100%;
    border-radius: var(--sa-radius-sm);
    margin-bottom: var(--sa-space-2);
}

.api-docs .menu ul {
    list-style: none;
    padding: 0;
    margin: 0;
}

.api-docs .menu li {
    margin: 2px 0;
}

.api-docs .menu a {
    color: var(--sa-ink-soft);
    text-decoration: none;
    display: flex;
    align-items: center;
    gap: 8px;
    padding: 9px 12px;
    border-radius: var(--sa-radius-sm);
    font-size: 14.5px;
    font-weight: 400;
    transition: background .15s ease, color .15s ease;
}

.api-docs .menu a:hover {
    background: var(--sa-bg);
    color: var(--sa-ink);
}

/* Активний розділ — біла «пігулка» з тонким фірмовим індикатором зліва */
.api-docs .menu a.active {
    background: var(--sa-bg);
    color: var(--sa-ink);
    font-weight: 500;
    box-shadow: inset 3px 0 0 0 var(--sa-brand);
}

/* Пункти-групи верхнього рівня — версальні, зі стрілкою, як у макеті */
.api-docs .menu > ul > li > a {
    text-transform: uppercase;
    letter-spacing: 0.06em;
    font-size: 13px;
    font-weight: 500;
    color: var(--sa-ink);
}

.api-docs .menu li.has-children > a::after {
    content: "";
    margin-left: auto;
    width: 7px;
    height: 7px;
    border-right: 2px solid var(--sa-muted);
    border-bottom: 2px solid var(--sa-muted);
    transform: rotate(-45deg);
    transition: transform var(--sa-dur-2) var(--sa-ease);
}

.api-docs .menu li.has-children.open > a::after {
    transform: rotate(45deg);
}

/* Бейджі методів — приглушені: світлий нейтральний фон і стриманий колір тексту */
.api-docs .method-badge {
    display: inline-block;
    font-family: var(--sa-font-mono);
    font-size: 10px;
    font-weight: 700;
    padding: 3px 7px;
    border-radius: 5px;
    letter-spacing: 0.06em;
    text-transform: uppercase;
    color: var(--sa-ink-soft);
    background: var(--sa-bg-alt);
    flex-shrink: 0;
    min-width: 46px;
    text-align: center;
}

.api-docs .method-badge.get { background: rgba(63, 174, 140, 0.12); color: var(--sa-success-ink); }
.api-docs .method-badge.post { background: rgba(107, 114, 128, 0.12); color: var(--sa-ink-soft); }
.api-docs .method-badge.put { background: rgba(198, 156, 109, 0.16); color: var(--sa-sand-ink); }
.api-docs .method-badge.patch { background: rgba(198, 156, 109, 0.16); color: var(--sa-sand-ink); }
.api-docs .method-badge.delete { background: rgba(224, 82, 82, 0.10); color: var(--sa-danger-ink); }

.api-docs .submenu {
    display: none;
    margin-left: 12px;
    border-left: 1px solid var(--sa-border);
    padding-left: 8px;
}

.api-docs .menu li.open > .submenu {
    display: block;
}

.api-docs .content {
    max-width: none;
    padding: 0;
    min-width: 0;
}

/* Секція розкладається на текст + праву колонку з кодом (як у макеті) */
.api-docs .content > section {
    display: grid;
    grid-template-columns: minmax(0, 1fr);
    border-bottom: 1px solid var(--sa-border);
    padding: 0;
}

.api-docs .content > section.has-aside {
    grid-template-columns: minmax(0, 1fr) 460px;
}

.api-docs .content > section > h1,
.api-docs .content > section > h2,
.api-docs .content > section > .method-badge,
.api-docs .content > section > .doc-endpoint,
.api-docs .content > section > .doc-body {
    grid-column: 1;
    padding: 0 var(--sa-space-4);
}

/* секції без правої колонки задають вертикальні відступи самі */
.api-docs .content > section:not(.has-aside) {
    padding: var(--sa-space-4) 0;
}

/* Перший розділ не притискається до шапки сайту */
.api-docs .content > section:first-child:not(.has-aside) {
    padding-top: var(--sa-space-5);
}

.api-docs .content > section:first-child .doc-main {
    padding-top: var(--sa-space-5);
}

.api-docs .content > section:first-child .doc-aside {
    padding-top: var(--sa-space-5);
}

.api-docs .doc-main {
    grid-column: 1;
    padding: var(--sa-space-4);
}

.api-docs .doc-main > h1,
.api-docs .doc-main > h2,
.api-docs .doc-main > .method-badge,
.api-docs .doc-main > .doc-endpoint,
.api-docs .doc-main > .doc-body {
    padding: 0;
}

.api-docs .doc-aside {
    grid-column: 2;
    background: var(--sa-bg-soft);
    border-left: 1px solid var(--sa-border);
    padding: var(--sa-space-4) var(--sa-space-3);
    align-self: stretch;
}

/* вміст панелі «липне» при прокручуванні, а фон тягнеться на всю висоту секції */
.api-docs .doc-aside-inner {
    position: sticky;
    top: calc(var(--sa-header-h) + 20px);
}

.api-docs .doc-aside-label {
    font-size: 11px;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.2em;
    color: var(--sa-muted);
    margin-bottom: var(--sa-space-2);
}

.api-docs h1 {
    font-size: 36px;
    font-weight: 700;
    letter-spacing: -0.02em;
    color: var(--sa-ink);
    margin-top: 0;
    margin-bottom: var(--sa-space-2);
}

.api-docs h2, .api-docs h3 {
    margin-top: 0;
    letter-spacing: -0.02em;
}

.api-docs .doc-endpoint {
    display: inline-flex;
    align-items: center;
    gap: 8px;
    font-family: var(--sa-font-mono);
    font-size: 14px;
    background: var(--sa-bg-soft);
    border: 1px solid var(--sa-border);
    color: var(--sa-ink);
    padding: 8px 14px;
    border-radius: var(--sa-radius-sm);
    margin: var(--sa-space-1) 0 var(--sa-space-2);
}

.api-docs .doc-body {
    color: var(--sa-ink-soft);
    font-size: 15.5px;
    line-height: 1.7;
}

/* Довжина рядка тексту. У документації праву колонку тримає код,
   а в інструкції користувача текст інакше розтягувався б на весь екран
   і читався б важко. */
.api-docs .content > section:not(.has-aside) > .doc-body,
.api-docs .content > section:not(.has-aside) > h1,
.api-docs .content > section:not(.has-aside) > h2,
.api-docs .content > section:not(.has-aside) > p {
    max-width: 900px;
}

.api-docs .doc-body > p,
.api-docs .doc-body > ul,
.api-docs .doc-body > ol {
    margin-bottom: var(--sa-space-2);
}

.api-docs .doc-body li {
    margin-bottom: 6px;
}

/* Заголовки всередині статті — менші за заголовок розділу,
   щоб рівні вкладеності відрізнялись */
.api-docs .doc-body h1,
.api-docs .doc-body h2 {
    font-size: 24px;
    margin: var(--sa-space-3) 0 var(--sa-space-1);
    color: var(--sa-ink);
}

.api-docs .doc-body h3,
.api-docs .doc-body h4 {
    font-size: 18px;
    margin: var(--sa-space-3) 0 var(--sa-space-1);
    color: var(--sa-ink);
}

/* Код у рядку — в кольорах системи, як на контентних сторінках сайту */
.api-docs .doc-body :not(pre) > code {
    background: var(--sa-bg-soft);
    color: var(--sa-ink);
    padding: 2px 6px;
    border-radius: 5px;
    font-family: var(--sa-font-mono);
    font-size: 0.9em;
}

.api-docs .doc-body a {
    color: var(--sa-brand);
    font-weight: 500;
}

.api-docs .doc-body table {
    width: 100%;
    border-collapse: collapse;
    margin-bottom: var(--sa-space-2);
    font-size: 14.5px;
}

.api-docs .doc-body table th,
.api-docs .doc-body table td {
    border: 1px solid var(--sa-border);
    padding: 9px 12px;
    text-align: left;
}

.api-docs .doc-body table th {
    background: var(--sa-bg-soft);
    color: var(--sa-ink);
    font-weight: 500;
}

.api-docs .doc-body img {
    max-width: 100%;
    height: auto;
    border: 1px solid var(--sa-border-soft);
    border-radius: var(--sa-radius-md);
    margin: var(--sa-space-2) 0;
}

.api-docs .doc-body pre,
.api-docs .doc-aside pre,
.api-docs .api-pre {
    position: relative;
    background: var(--sa-bg);
    color: var(--sa-ink);
    border: 1px solid var(--sa-border);
    /* верхній відступ лишає місце кнопці копіювання, щоб вона не лягала на код */
    padding: 40px 18px 16px;
    border-radius: var(--sa-radius-md);
    overflow-x: auto;
    font-family: var(--sa-font-mono);
    font-size: 13px;
    line-height: 1.65;
    margin-bottom: var(--sa-space-2);
    white-space: pre-wrap;
    word-break: break-word;
}

.api-docs .doc-body pre code,
.api-docs .api-pre code {
    display: block;
    white-space: pre;
}

/* Кнопка копіювання лишається видимою й без наведення — на сенсорних
   екранах події hover немає, і раніше вона була недосяжною */
.api-docs .copy-btn {
    position: absolute;
    top: 8px;
    right: 8px;
    background: var(--sa-bg);
    color: var(--sa-muted);
    border: 1px solid var(--sa-border);
    padding: 4px 9px;
    font-size: 11px;
    font-weight: 600;
    border-radius: 6px;
    cursor: pointer;
    opacity: .6;
    transition: opacity var(--sa-dur-2) var(--sa-ease), color var(--sa-dur-2) var(--sa-ease), border-color var(--sa-dur-2) var(--sa-ease);
}

.api-docs pre:hover .copy-btn,
.api-docs .copy-btn:focus-visible {
    opacity: 1;
}

.api-docs .copy-btn:hover {
    opacity: 1;
    color: var(--sa-ink);
    border-color: var(--sa-border-strong);
}

.api-docs .search-box {
    position: relative;
    margin-bottom: var(--sa-space-2);
}

.api-docs .search-box input {
    width: 100%;
    box-sizing: border-box;
    padding: 10px 12px;
    border: 1px solid var(--sa-border);
    border-radius: var(--sa-radius-sm);
    background: var(--sa-bg);
    color: var(--sa-ink);
    font-size: 14px;
}

.api-docs .search-box .search-empty {
    margin-top: 8px;
    font-size: 12px;
    color: var(--sa-muted);
}

@media (max-width: 992px) {
    .api-docs {
        grid-template-columns: 1fr;
    }

    .api-docs .sidebar {
        position: fixed;
        top: var(--sa-header-h);
        left: 0;
        width: 82%;
        max-width: 320px;
        height: calc(100vh - var(--sa-header-h));
        z-index: 20;
        box-shadow: var(--sa-shadow-lg);
        transform: translateX(-100%);
        transition: transform .2s ease;
    }

    .api-docs .sidebar.is-open {
        transform: translateX(0);
    }

    .api-docs .sidebar-toggle {
        display: flex;
    }

    .api-docs .content {
        padding: 0;
        max-width: 100%;
    }

    /* На вузьких екранах права колонка з кодом стає звичайним блоком під текстом */
    .api-docs .content > section.has-aside {
        grid-template-columns: minmax(0, 1fr);
    }

    .api-docs .doc-aside {
        grid-column: 1;
        grid-row: auto;
        position: static;
        border-left: none;
        border-top: 1px solid var(--sa-border);
        padding: var(--sa-space-3) var(--sa-space-2);
    }
}

@media (max-width: 600px) {
    .api-docs .content > section > h1,
    .api-docs .content > section > h2,
    .api-docs .content > section > .method-badge,
    .api-docs .content > section > .doc-endpoint,
    .api-docs .content > section > .doc-body {
        padding-left: var(--sa-space-2);
        padding-right: var(--sa-space-2);
    }

    .api-docs h1 {
        font-size: 30px;
    }
}

/* -------------------------------------------------------------------------
   Ієрархія заголовків сторінок /docs і /guide.
   Раніше кожен розділ був окремим <h1> — на сторінці їх виходило 28 і 39.
   Тепер один <h1> на сторінку, розділи — <h2>, підрозділи — <h3>.
   ------------------------------------------------------------------------- */
.api-docs .content > h1.content-page-title {
    padding: var(--sa-space-4) var(--sa-space-4) 0;
    margin-bottom: 0;
    max-width: 900px;
}

.api-docs .content > section > h2 {
    font-size: 30px;
    font-weight: 700;
    letter-spacing: -0.02em;
    color: var(--sa-ink);
    margin-bottom: var(--sa-space-2);
}

.api-docs .content > section > h3 {
    font-size: 23px;
    font-weight: 500;
    letter-spacing: -0.01em;
    color: var(--sa-ink);
    margin-bottom: var(--sa-space-2);
}

/* Ті самі правила розкладки, що вже діють для h1/h2 секцій */
.api-docs .content > section > h3 {
    grid-column: 1;
    padding: 0 var(--sa-space-4);
}

.api-docs .content > section:not(.has-aside) > h3 {
    max-width: 900px;
}

@media (max-width: 900px) {
    .api-docs .content > section > h2 {
        font-size: 26px;
    }

    .api-docs .content > section > h3 {
        font-size: 20px;
    }
}