/* ==========================================================================
   API Documentation — layered on top of admin.css (same Sara777 tokens)
   ========================================================================== */

body { background: var(--white); }

.docs {
    display: grid;
    grid-template-columns: 268px minmax(0, 1fr);
    align-items: start;
    max-width: 1340px;
    margin: 0 auto;
}

/* ------------------------------- Side nav -------------------------------- */
.docs-nav {
    position: sticky;
    top: 0;
    height: 100vh;
    overflow-y: auto;
    border-right: 1px solid var(--border);
    padding: 22px 16px 40px;
    background: var(--grey-25);
}

.docs-nav__brand { display: block; margin-bottom: 6px; }
.docs-nav__logo { height: 26px; width: auto; margin-bottom: 7px; }
.docs-nav__title {
    font-size: 10px;
    font-weight: 600;
    letter-spacing: .09em;
    text-transform: uppercase;
    color: var(--grey-400);
    line-height: 1;
}

/* ------------------------------- Search ---------------------------------- */
.docs-search {
    position: relative;
    display: flex;
    align-items: center;
    margin-top: 14px;
}

.docs-search__input {
    width: 100%;
    padding: 7px 30px 7px 29px;
    border: 1px solid var(--border);
    border-radius: 7px;
    background: var(--white);
    font-family: inherit;
    font-size: 12.5px;
    color: var(--text);
    line-height: 1.4;
}
.docs-search__input::placeholder { color: var(--grey-400); }
.docs-search__input:focus {
    outline: none;
    border-color: var(--brand);
    box-shadow: 0 0 0 3px var(--brand-soft);
}
/* The browser's own clear button would sit on top of ours. */
.docs-search__input::-webkit-search-cancel-button { display: none; }

.docs-search__icon {
    position: absolute;
    left: 9px;
    width: 13px; height: 13px;
    color: var(--grey-400);
    pointer-events: none;
}

.docs-search__key {
    position: absolute;
    right: 8px;
    min-width: 16px;
    padding: 1px 4px;
    border: 1px solid var(--border);
    border-radius: 4px;
    background: var(--grey-25);
    font-family: var(--mono);
    font-size: 10px;
    color: var(--grey-400);
    text-align: center;
    pointer-events: none;
}
.docs-search__input:focus ~ .docs-search__key { opacity: 0; }

.docs-search__clear {
    position: absolute;
    right: 6px;
    display: flex;
    padding: 3px;
    border: 0;
    border-radius: 5px;
    background: none;
    color: var(--grey-400);
    cursor: pointer;
}
.docs-search__clear:hover { background: var(--grey-50); color: var(--text); }
.docs-search__clear svg { width: 13px; height: 13px; }

.docs-search__empty {
    margin: 18px 8px 0;
    font-size: 12.5px;
    color: var(--text-muted);
    line-height: 1.5;
}

.docs-nav__link mark {
    padding: 0 1px;
    border-radius: 3px;
    background: var(--brand-soft);
    color: var(--text);
    font-weight: 600;
}

.docs-nav__group { margin-top: 20px; }
.docs-nav__label {
    font-size: 10.5px; font-weight: 600; letter-spacing: .07em;
    text-transform: uppercase; color: var(--grey-400);
    padding: 0 8px 6px;
}

.docs-nav__link {
    display: flex; align-items: center; gap: 8px;
    padding: 6px 8px;
    border-radius: 6px;
    font-size: 13px;
    color: var(--text-muted);
    line-height: 1.4;
}
.docs-nav__link:hover { background: var(--brand-soft); color: var(--text); }
.docs-nav__link.is-top { font-weight: 550; color: var(--text); }

.verb {
    flex: 0 0 auto;
    font-family: var(--mono);
    font-size: 9.5px;
    font-weight: 700;
    letter-spacing: .03em;
    padding: 2px 5px;
    border-radius: 4px;
    border: 1px solid var(--border-strong);
    background: var(--white);
    color: var(--text-muted);
    min-width: 42px;
    text-align: center;
}
.verb--get { border-color: var(--grey-300); }
.verb--post { background: var(--brand); color: var(--ink); border-color: var(--brand); }
.verb--put { background: var(--ink); color: var(--white); border-color: var(--ink); }
.verb--delete { background: var(--white); color: var(--ink); border-color: var(--ink); border-style: dashed; }

/* -------------------------------- Body ----------------------------------- */
.docs-body { padding: 40px 44px 90px; min-width: 0; }

.docs-hero { padding-bottom: 30px; border-bottom: 1px solid var(--border); margin-bottom: 34px; }
.docs-hero h1 { font-size: 31px; letter-spacing: -.03em; font-weight: 680; }
.docs-hero p { font-size: 15px; color: var(--text-muted); margin-top: 10px; max-width: 760px; line-height: 1.65; }

.base-url {
    display: flex; align-items: center; gap: 10px; flex-wrap: wrap;
    margin-top: 20px;
    padding: 12px 14px;
    border: 1px solid var(--brand-line);
    border-radius: var(--radius);
    background: var(--brand-soft);
}
.base-url__label { font-size: 11px; font-weight: 600; letter-spacing: .05em; text-transform: uppercase; color: var(--text-subtle); }
.base-url__value { font-family: var(--mono); font-size: 13.5px; font-weight: 600; }

.sec { margin-bottom: 52px; scroll-margin-top: 20px; }
.sec__title { font-size: 22px; font-weight: 660; letter-spacing: -.024em; }
.sec__desc { font-size: 14px; color: var(--text-muted); margin-top: 7px; max-width: 760px; line-height: 1.65; }

.h3 { font-size: 15px; font-weight: 620; margin: 26px 0 10px; letter-spacing: -.012em; }

/* ------------------------------- Endpoint -------------------------------- */
.ep {
    border: 1px solid var(--border);
    border-radius: var(--radius-lg);
    margin-top: 20px;
    overflow: hidden;
    scroll-margin-top: 18px;
    background: var(--white);
}

.ep__head {
    padding: 16px 20px;
    border-bottom: 1px solid var(--border);
    background: var(--grey-25);
}
.ep__name { font-size: 16px; font-weight: 640; letter-spacing: -.016em; }

.ep__route {
    display: flex; align-items: center; gap: 9px; flex-wrap: wrap;
    margin-top: 9px;
}
.ep__path {
    font-family: var(--mono);
    font-size: 13px;
    background: var(--white);
    border: 1px solid var(--border-strong);
    border-radius: 6px;
    padding: 4px 9px;
    word-break: break-all;
}
.ep__desc { font-size: 13.5px; color: var(--text-muted); margin-top: 11px; line-height: 1.65; max-width: 780px; }

.ep__body { padding: 20px; }

.ep__meta { display: flex; gap: 7px; flex-wrap: wrap; margin-top: 10px; }

/* -------------------------- Behaviour callouts --------------------------- */
.behave { display: grid; gap: 12px; grid-template-columns: repeat(2, minmax(0, 1fr)); margin-bottom: 22px; }
.behave__box {
    border: 1px solid var(--border-strong);
    border-radius: var(--radius);
    padding: 13px 15px;
    background: var(--grey-25);
}
.behave__box--on { border-left: 3px solid var(--brand); }
.behave__box--off { border-left: 3px solid var(--grey-400); }
.behave__head { font-size: 11.5px; font-weight: 700; letter-spacing: .05em; text-transform: uppercase; margin-bottom: 6px; }
.behave__text { font-size: 13px; color: var(--text-muted); line-height: 1.6; }

/* ------------------------------ Param table ------------------------------ */
.params { width: 100%; border-collapse: collapse; font-size: 13px; }
.params th {
    text-align: left;
    padding: 9px 12px;
    font-size: 10.5px; font-weight: 600; letter-spacing: .06em; text-transform: uppercase;
    color: var(--text-subtle);
    border-bottom: 1px solid var(--border-strong);
    white-space: nowrap;
}
.params td { padding: 11px 12px; border-bottom: 1px solid var(--grey-100); vertical-align: top; }
.params tr:last-child td { border-bottom: 0; }
.params__name { font-family: var(--mono); font-weight: 600; white-space: nowrap; }
.params__type { font-family: var(--mono); font-size: 12px; color: var(--text-subtle); white-space: nowrap; }
.params__rules { font-family: var(--mono); font-size: 11.5px; color: var(--grey-700); line-height: 1.6; }
.params__desc { color: var(--text-muted); line-height: 1.6; min-width: 220px; }

.req {
    font-size: 10.5px; font-weight: 700; letter-spacing: .04em;
    padding: 2px 6px; border-radius: 4px;
    white-space: nowrap;
}
.req--yes { background: var(--brand); color: var(--ink); }
.req--no { background: var(--grey-100); color: var(--text-subtle); }
.req--maybe { background: var(--white); border: 1px solid var(--grey-300); color: var(--text-muted); }

/* ------------------------------- Responses ------------------------------- */
.resp { margin-top: 14px; }
.resp__head { display: flex; align-items: center; gap: 9px; margin-bottom: 7px; flex-wrap: wrap; }
.status {
    font-family: var(--mono); font-size: 11.5px; font-weight: 700;
    padding: 2px 8px; border-radius: 5px;
    background: var(--ink); color: var(--white);
}
.status--err { background: var(--white); color: var(--ink); border: 1px solid var(--ink); }
.resp__label { font-size: 13px; font-weight: 550; }

.pre {
    position: relative;
    font-family: var(--mono);
    font-size: 12px;
    line-height: 1.65;
    background: var(--grey-50);
    border: 1px solid var(--border);
    border-radius: var(--radius-sm);
    padding: 14px 16px;
    overflow-x: auto;
    white-space: pre;
    margin: 0;
    color: var(--grey-800);
}
.pre__copy {
    position: absolute; top: 8px; right: 8px;
    height: 24px; padding: 0 9px;
    font-size: 11px; font-weight: 600;
    border: 1px solid var(--border-strong);
    border-radius: 5px;
    background: var(--white);
    color: var(--text-muted);
    cursor: pointer;
}
.pre__copy:hover { background: var(--brand); color: var(--ink); border-color: var(--brand); }

/* --------------------------------- Lists --------------------------------- */
.notes { margin: 0; padding-left: 19px; font-size: 13px; color: var(--text-muted); line-height: 1.75; }
.notes li { margin-bottom: 4px; }
.notes code, .inline-code {
    font-family: var(--mono); font-size: 12px;
    background: var(--grey-100);
    border-radius: 4px; padding: 1px 5px;
}

.err-chips { display: flex; gap: 6px; flex-wrap: wrap; }
.err-chip {
    font-family: var(--mono); font-size: 11.5px;
    border: 1px solid var(--border-strong);
    border-radius: var(--radius-full);
    padding: 2px 9px;
    color: var(--text-muted);
    background: var(--white);
}

/* ------------------------------- Flow steps ------------------------------ */
.flow { display: grid; gap: 10px; }
.flow__step {
    display: flex; gap: 13px;
    padding: 13px 15px;
    border: 1px solid var(--border);
    border-radius: var(--radius);
    background: var(--white);
}
.flow__num {
    width: 24px; height: 24px; flex: 0 0 24px;
    border-radius: 50%;
    background: var(--brand); color: var(--ink);
    display: grid; place-items: center;
    font-size: 11.5px; font-weight: 700;
}
.flow__title { font-size: 13.5px; font-weight: 600; }
.flow__text { font-size: 12.5px; color: var(--text-muted); margin-top: 3px; line-height: 1.6; }

/* ------------------------------ Status strip ----------------------------- */
.live {
    display: flex; align-items: center; gap: 11px; flex-wrap: wrap;
    padding: 13px 16px;
    border: 1px solid var(--brand-line);
    border-radius: var(--radius);
    margin-bottom: 26px;
    background: var(--brand-soft);
}
.live__dot {
    width: 8px; height: 8px; border-radius: 50%;
    background: var(--brand); flex: 0 0 8px;
    box-shadow: 0 0 0 3px rgba(250, 176, 43, .3);
}
.live__text { font-size: 13px; }

/* Parameter and error tables carry five columns, which cannot fit on a phone,
   so each row becomes a labelled card instead of scrolling sideways. */
@media (max-width: 720px) {
    .params,
    .params tbody,
    .params tr,
    .params td {
        display: block;
        width: 100%;
    }

    .params thead { display: none; }

    .params tr {
        padding: 14px 0;
        border-bottom: 1px solid var(--border);
    }
    .params tr:last-child { border-bottom: 0; }

    .params td {
        display: flex;
        gap: 10px;
        padding: 3px 0;
        border: 0;
    }

    .params td::before {
        content: attr(data-label);
        flex: 0 0 74px;
        font-size: 10px;
        font-weight: 600;
        letter-spacing: .05em;
        text-transform: uppercase;
        color: var(--text-subtle);
        padding-top: 2px;
    }

    .params td.params__name {
        display: block;
        font-size: 14px;
        padding-bottom: 6px;
    }
    .params td.params__name::before { display: none; }

    .params__desc { min-width: 0; }
}

/* The toggle only exists once the nav stacks above the page. */
.docs-nav__toggle { display: none; }

@media (max-width: 1040px) {
    .docs { grid-template-columns: minmax(0, 1fr); }
    .docs-nav {
        position: static; height: auto;
        border-right: 0; border-bottom: 1px solid var(--border);
        padding: 18px 16px;
    }
    .docs-body { padding: 28px 18px 70px; }
    .behave { grid-template-columns: minmax(0, 1fr); }

    /* Listing every endpoint first would bury the page under a long scroll. */
    .docs-nav__toggle {
        display: flex;
        align-items: center;
        gap: 8px;
        width: 100%;
        margin-top: 12px;
        padding: 9px 12px;
        border: 1px solid var(--border-strong);
        border-radius: var(--radius-sm);
        background: var(--white);
        color: var(--text);
        font-family: inherit;
        font-size: 13.5px;
        font-weight: 600;
        cursor: pointer;
    }
    .docs-nav__toggle svg { width: 15px; height: 15px; flex: 0 0 15px; }
    .docs-nav__caret { margin-left: auto; transition: transform .2s var(--ease); }

    .docs-nav__groups { display: none; }

    body.nav-open .docs-nav__groups { display: block; }
    body.nav-open .docs-nav__caret { transform: rotate(180deg); }
}

@media (max-width: 560px) {
    .docs-hero h1 { font-size: 25px; }
    .params__rules { font-size: 11px; }
    .ep__body { padding: 16px 14px; }
}
