/* ============================================================
   SIMcloud API Documentation — api-docs.css
   Single stylesheet for all documentation pages.
   ============================================================ */

/* --- Box-sizing reset (scoped) --- */
body.api-docs-page *,
body.api-docs-page *::before,
body.api-docs-page *::after {
    box-sizing: border-box;
}

/* --- Design tokens & base --- */
body.api-docs-page {
    overflow-x: hidden; /* prevent horizontal page scroll on mobile */

    /* Colour palette */
    --c-accent:         #4f7a61;
    --c-accent-dark:    #3c5f4b;
    --c-accent-soft:    #edf4f0;
    --c-danger:         #b94040;
    --c-danger-soft:    #fdf0f0;
    --c-border:         #d9e2e8;
    --c-border-mid:     #c2cdd6;
    --c-surface:        #ffffff;
    --c-bg:             #f3f6f9;
    --c-text:           #1e2b35;
    --c-text-2:         #3d4f5c;
    --c-muted:          #617585;
    --c-code-bg:        #f0f3f6;
    --c-pre-bg:         #ffffff;

    /* Radius scale */
    --r-sm:  0.3rem;
    --r-md:  0.55rem;
    --r-lg:  0.875rem;

    /* Elevation */
    --shadow-sm:  0 1px 2px rgba(30, 43, 53, 0.07);
    --shadow-md:  0 1px 3px rgba(30, 43, 53, 0.08),
                  0 4px 12px rgba(30, 43, 53, 0.05);

    /* Typography */
    --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
                 "Helvetica Neue", Arial, sans-serif;
    --font-mono: "SFMono-Regular", "SF Mono", Menlo, Monaco, Consolas,
                 "Courier New", monospace;

    font-family: var(--font-sans);
    font-size: 15px;
    line-height: 1.7;
    color: var(--c-text);
    background: var(--c-bg);

    /* Page layout */
    max-width: 1080px;
    margin: 0 auto;
    padding: 2rem 2rem 5rem;
}

/* ============================================================
   Typography
   ============================================================ */

body.api-docs-page h1 {
    font-size: 1.875rem;
    font-weight: 700;
    letter-spacing: -0.025em;
    line-height: 1.2;
    color: var(--c-text);
    border-bottom: 2px solid var(--c-border);
    padding-bottom: 0.75rem;
    margin: 0 0 1.75rem;
}

body.api-docs-page h2 {
    font-size: 1.2rem;
    font-weight: 700;
    letter-spacing: -0.015em;
    color: var(--c-text);
    border-bottom: 1px solid var(--c-border);
    padding-bottom: 0.4rem;
    margin: 2.5rem 0 1rem;
}

body.api-docs-page h3 {
    font-size: 1rem;
    font-weight: 700;
    color: var(--c-text);
    margin: 2rem 0 0.5rem;
}

body.api-docs-page h4 {
    font-size: 0.75rem;
    font-weight: 700;
    color: var(--c-muted);
    text-transform: uppercase;
    letter-spacing: 0.08em;
    margin: 1.5rem 0 0.5rem;
}

body.api-docs-page p {
    margin: 0 0 1rem;
    color: var(--c-text-2);
}

body.api-docs-page a {
    color: var(--c-accent-dark);
    text-decoration: underline;
    text-decoration-thickness: 1px;
    text-underline-offset: 2px;
}

body.api-docs-page a:hover {
    color: var(--c-accent);
}

body.api-docs-page ul,
body.api-docs-page ol {
    padding-left: 1.5rem;
    margin: 0 0 1rem;
    color: var(--c-text-2);
}

body.api-docs-page li {
    margin-bottom: 0.3rem;
}

/* ============================================================
   Code
   ============================================================ */

/* Inline code */
body.api-docs-page code {
    font-family: var(--font-mono);
    font-size: 0.845em;
    background: var(--c-code-bg);
    color: var(--c-text);
    padding: 0.15em 0.45em;
    border-radius: var(--r-sm);
    border: 1px solid var(--c-border);
}

/* Code blocks */
body.api-docs-page pre {
    background: var(--c-pre-bg);
    border: 1px solid var(--c-border);
    border-radius: var(--r-lg);
    padding: 1.125rem 1.25rem;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
    margin: 0 0 1.5rem;
    box-shadow: var(--shadow-md);
}

body.api-docs-page pre code {
    background: none;
    border: none;
    padding: 0;
    font-size: 0.855rem;
    line-height: 1.65;
    color: var(--c-text);
}

/* ============================================================
   Tables
   ============================================================ */

body.api-docs-page table {
    width: 100%;
    background: var(--c-surface);
    border-collapse: collapse;
    border: 1px solid var(--c-border);
    border-radius: var(--r-lg);
    margin: 0 0 1.5rem;
    overflow: hidden;
    box-shadow: var(--shadow-md);
    font-size: 0.9rem;
    table-layout: fixed;
}

body.api-docs-page th {
    background: #f7f9fb;
    color: var(--c-text);
    font-size: 0.75rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.06em;
    padding: 0.75rem 1rem;
    text-align: left;
    border-bottom: 1px solid var(--c-border);
    white-space: nowrap;
}

body.api-docs-page td {
    padding: 0.75rem 1rem;
    text-align: left;
    vertical-align: top;
    border-bottom: 1px solid #edf1f4;
    color: var(--c-text-2);
    overflow-wrap: anywhere;
}

body.api-docs-page tr:last-child td {
    border-bottom: none;
}

body.api-docs-page tbody tr:hover td {
    background: #fafbfc;
}

/* ============================================================
   Note / callout
   ============================================================ */

body.api-docs-page .note {
    background: var(--c-surface);
    border: 1px solid var(--c-border);
    border-left: 4px solid var(--c-accent);
    border-radius: var(--r-lg);
    padding: 1rem 1.25rem;
    margin: 1rem 0 1.75rem;
    box-shadow: var(--shadow-sm);
    color: var(--c-text-2);
}

body.api-docs-page .note ol,
body.api-docs-page .note ul {
    margin-bottom: 0;
}

/* ============================================================
   HTTP method badge
   ============================================================ */

body.api-docs-page .method {
    display: inline-flex;
    align-items: center;
    font-family: var(--font-mono);
    font-size: 0.7rem;
    font-weight: 700;
    letter-spacing: 0.06em;
    padding: 0.2rem 0.55rem;
    border-radius: var(--r-sm);
    margin-right: 0.5rem;
    vertical-align: middle;
    background: var(--c-accent-soft);
    color: var(--c-accent-dark);
    border: 1px solid #b8d5c5;
}

/* ============================================================
   Required marker
   ============================================================ */

body.api-docs-page .required {
    color: var(--c-danger);
    font-weight: 700;
    font-size: 0.85em;
}

/* ============================================================
   Breadcrumbs
   ============================================================ */

body.api-docs-page .breadcrumbs {
    display: flex;
    align-items: center;
    gap: 0.4rem;
    font-size: 0.725rem;
    font-weight: 700;
    letter-spacing: 0.07em;
    text-transform: uppercase;
    color: var(--c-muted);
    margin-bottom: 1rem;
}

body.api-docs-page .breadcrumbs a {
    color: var(--c-accent-dark);
    text-decoration: none;
}

body.api-docs-page .breadcrumbs a:hover {
    text-decoration: underline;
}

/* ============================================================
   Navigation — horizontal tab bar
   Desktop: flex row in a card, border-bottom active indicator.
   Tablet / mobile: same card but scrollable, hidden scrollbar.
   ============================================================ */

body.api-docs-page .doc-nav {
    display: flex;
    align-items: stretch;
    background: var(--c-surface);
    border: 1px solid var(--c-border);
    border-radius: var(--r-lg);
    box-shadow: var(--shadow-sm);
    margin-bottom: 2.25rem;
    padding: 0 0.25rem;
    overflow-x: auto;
    overflow-y: hidden;
    -webkit-overflow-scrolling: touch;
    touch-action: pan-x;           /* tell browser: horizontal swipe = scroll nav */
    scrollbar-width: none;         /* Firefox */
    -ms-overflow-style: none;      /* IE/Edge */
}

body.api-docs-page .doc-nav::-webkit-scrollbar {
    display: none;                 /* Chrome/Safari/Opera */
}

body.api-docs-page .doc-nav a {
    flex: 0 0 auto;
    display: inline-flex;
    align-items: center;
    padding: 0.9rem 1.05rem;
    color: var(--c-muted);
    font-size: 0.875rem;
    font-weight: 600;
    text-decoration: none;
    white-space: nowrap;
    border-bottom: 2px solid transparent;
    /* Reset any browser/cascaded values */
    border-radius: 0;
    background: transparent;
    transition: color 0.15s ease, border-color 0.15s ease,
                background-color 0.15s ease;
}

body.api-docs-page .doc-nav a:hover {
    color: var(--c-text);
    background: rgba(79, 122, 97, 0.04);
    text-decoration: none;
}

body.api-docs-page .doc-nav a.current {
    color: var(--c-text);
    border-bottom-color: var(--c-accent);
    font-weight: 700;
}

/* ============================================================
   Service card grid (index page)
   ============================================================ */

body.api-docs-page .service-grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(230px, 1fr));
    gap: 1.125rem;
    margin-top: 1.5rem;
}

body.api-docs-page .service-card {
    background: var(--c-surface);
    border: 1px solid var(--c-border);
    border-top: 3px solid var(--c-accent);
    border-radius: var(--r-lg);
    padding: 1.25rem 1.375rem;
    box-shadow: var(--shadow-md);
    transition: box-shadow 0.15s ease, transform 0.15s ease;
}

body.api-docs-page .service-card:hover {
    box-shadow: 0 4px 16px rgba(30, 43, 53, 0.1),
                0 1px 4px rgba(30, 43, 53, 0.06);
    transform: translateY(-1px);
}

body.api-docs-page .service-card h3 {
    font-size: 0.975rem;
    margin: 0 0 0.5rem;
    border: none;
    padding: 0;
}

body.api-docs-page .service-card p {
    font-size: 0.875rem;
    margin-bottom: 0.875rem;
}

body.api-docs-page .service-card a {
    font-size: 0.875rem;
    font-weight: 700;
}

/* ============================================================
   Hamburger toggle — hidden on desktop
   ============================================================ */

body.api-docs-page .doc-nav-toggle {
    display: none;
}

/* ============================================================
   Responsive
   ============================================================ */

@media (max-width: 767px) {
    body.api-docs-page {
        padding: 1.25rem 1.125rem 3.5rem;
    }

    body.api-docs-page h1 {
        font-size: 1.5rem;
    }

    body.api-docs-page h2 {
        font-size: 1.1rem;
        margin-top: 2rem;
    }

    /* --- Hamburger button --- */
    body.api-docs-page .doc-nav-toggle {
        display: flex;
        align-items: center;
        justify-content: space-between;
        width: 100%;
        padding: 0.875rem 1.125rem;
        background: var(--c-surface);
        border: 1px solid var(--c-border);
        border-radius: var(--r-lg);
        margin-bottom: 2.25rem;
        cursor: pointer;
        font-family: var(--font-sans);
        box-shadow: var(--shadow-sm);
        transition: border-radius 0.15s ease, margin-bottom 0.15s ease,
                    border-color 0.15s ease;
    }

    body.api-docs-page .doc-nav-toggle.is-open {
        border-radius: var(--r-lg) var(--r-lg) 0 0;
        border-bottom-color: #eef1f4;
        margin-bottom: 0;
    }

    body.api-docs-page .doc-nav-toggle__label {
        font-size: 0.9rem;
        font-weight: 700;
        color: var(--c-text);
    }

    body.api-docs-page .doc-nav-toggle__icon {
        width: 18px;
        display: flex;
        flex-direction: column;
        gap: 4px;
        flex-shrink: 0;
    }

    body.api-docs-page .doc-nav-toggle__icon span {
        display: block;
        height: 2px;
        background: var(--c-muted);
        border-radius: 2px;
        transition: transform 0.22s ease, opacity 0.22s ease;
        transform-origin: center;
    }

    /* Animate to × */
    body.api-docs-page .doc-nav-toggle.is-open .doc-nav-toggle__icon span:nth-child(1) {
        transform: translateY(6px) rotate(45deg);
    }
    body.api-docs-page .doc-nav-toggle.is-open .doc-nav-toggle__icon span:nth-child(2) {
        opacity: 0;
        transform: scaleX(0);
    }
    body.api-docs-page .doc-nav-toggle.is-open .doc-nav-toggle__icon span:nth-child(3) {
        transform: translateY(-6px) rotate(-45deg);
    }

    /* --- Nav: hidden by default, drops down when open --- */
    body.api-docs-page .doc-nav {
        display: none;
        flex-direction: column;
        border-top: none;
        border-radius: 0 0 var(--r-lg) var(--r-lg);
        margin-bottom: 1.75rem;
        padding: 0.375rem 0;
        overflow: visible;
        touch-action: auto;
    }

    body.api-docs-page .doc-nav.is-open {
        display: flex;
    }

    body.api-docs-page .doc-nav a {
        padding: 0.875rem 1.25rem;
        font-size: 0.9rem;
        border-bottom: none;
        border-left: 3px solid transparent;
        white-space: normal;
    }

    body.api-docs-page .doc-nav a:hover {
        background: #f5f8f6;
    }

    body.api-docs-page .doc-nav a.current {
        background: var(--c-accent-soft);
        border-bottom-color: transparent;
        border-left-color: var(--c-accent);
        color: var(--c-accent-dark);
        font-weight: 700;
    }

    body.api-docs-page .doc-nav a:last-child {
        border-radius: 0 0 var(--r-lg) var(--r-lg);
    }

    /* Tables: horizontal scroll */
    body.api-docs-page table {
        display: block;
        overflow-x: auto;
        -webkit-overflow-scrolling: touch;
        white-space: nowrap;
    }

    body.api-docs-page th,
    body.api-docs-page td {
        min-width: 140px;
    }

    /* Code blocks: wrap */
    body.api-docs-page pre code {
        white-space: pre-wrap;
        word-break: break-word;
    }

    body.api-docs-page .service-grid {
        grid-template-columns: repeat(2, 1fr);
    }
}

@media (max-width: 479px) {
    body.api-docs-page {
        padding: 1rem 1rem 3rem;
    }

    body.api-docs-page h1 {
        font-size: 1.35rem;
    }

    body.api-docs-page .service-grid {
        grid-template-columns: 1fr;
    }
}