/* ============================================================
   API REFERENCE
   Dense technical content. Reads like documentation, not marketing:
   generous measure, tabular data, monospace for anything you'd type.
   ============================================================ */

.api-ref {
    max-width: 900px;
    margin: 0 auto;
    padding: var(--space-12) var(--space-5) var(--space-20);
}

.api-ref__crumbs {
    font-size: var(--fs-sm);
    color: var(--color-text-muted);
    margin-bottom: var(--space-6);
}

.api-ref__crumbs a { color: var(--color-link); }

.api-ref__title {
    font-family: var(--font-display);
    font-size: var(--fs-h1);
    line-height: var(--lh-tight);
    letter-spacing: var(--ls-tight);
    color: var(--color-heading);
    margin: 0 0 var(--space-4);
}

.api-ref__lead {
    font-size: 1.0625rem;
    line-height: var(--lh-body);
    color: var(--color-text-muted);
    margin: 0 0 var(--space-10);
}

.api-ref__h2 {
    font-family: var(--font-display);
    font-size: var(--fs-h2);
    color: var(--color-heading);
    margin: var(--space-12) 0 var(--space-5);
}

/* ----- key facts ----- */

.api-ref__facts {
    display: grid;
    grid-template-columns: minmax(8rem, 10rem) 1fr;
    gap: var(--space-3) var(--space-6);
    margin: 0 0 var(--space-10);
    padding: var(--space-6);
    background: var(--color-surface-alt);
    border: var(--border);
    border-radius: var(--radius-lg);
}

.api-ref__facts dt {
    font-size: var(--fs-sm);
    font-weight: var(--fw-medium);
    color: var(--color-text-muted);
}

.api-ref__facts dd {
    margin: 0;
    font-size: var(--fs-sm);
    color: var(--color-text);
}

/* ----- group index ----- */

.api-groups {
    list-style: none;
    margin: 0;
    padding: 0;
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
    gap: var(--space-4);
}

.api-groups__item {
    padding: var(--space-5);
    border: var(--border);
    border-radius: var(--radius-lg);
    background: var(--color-surface);
    transition: border-color .15s ease;
}

.api-groups__item:hover { border-color: var(--color-primary); }

.api-groups__link {
    display: flex;
    align-items: baseline;
    justify-content: space-between;
    gap: var(--space-3);
    text-decoration: none;
}

.api-groups__name {
    font-family: var(--font-display);
    font-size: var(--fs-h4);
    color: var(--color-heading);
}

.api-groups__count {
    font-size: var(--fs-overline);
    color: var(--color-text-muted);
    white-space: nowrap;
}

.api-groups__sample {
    margin: var(--space-2) 0 0;
    font-family: var(--font-mono);
    font-size: 0.6875rem;
    line-height: 1.5;
    color: var(--color-text-muted);
    overflow-wrap: anywhere;
}

/* ----- table of contents ----- */

.api-toc {
    margin: 0 0 var(--space-12);
    padding: var(--space-5) var(--space-6);
    background: var(--color-surface-alt);
    border-radius: var(--radius-lg);
}

.api-toc__title {
    font-family: var(--font-display);
    font-size: var(--fs-h4);
    margin: 0 0 var(--space-3);
    color: var(--color-heading);
}

.api-toc ul { list-style: none; margin: 0; padding: 0; }
.api-toc li { margin: 0 0 var(--space-2); }

.api-toc a {
    display: flex;
    align-items: center;
    gap: var(--space-3);
    text-decoration: none;
    font-size: var(--fs-sm);
}

.api-toc code {
    color: var(--color-text);
    overflow-wrap: anywhere;
}

/* ----- operations ----- */

.api-op {
    padding: var(--space-8) 0;
    border-top: var(--border);
    scroll-margin-top: var(--space-16);
}

.api-op__title {
    font-family: var(--font-display);
    font-size: var(--fs-h3);
    line-height: var(--lh-snug);
    margin: 0 0 var(--space-3);
    color: var(--color-heading);
}

.api-op__title a { color: inherit; text-decoration: none; }
.api-op__title a:hover { color: var(--color-link); }

.api-op__endpoint {
    display: flex;
    align-items: center;
    gap: var(--space-3);
    flex-wrap: wrap;
    margin: 0 0 var(--space-4);
}

.api-op__endpoint code {
    font-size: var(--fs-sm);
    overflow-wrap: anywhere;
}

.api-op__heading {
    font-size: var(--fs-overline);
    font-weight: var(--fw-semibold);
    letter-spacing: var(--ls-wide);
    text-transform: uppercase;
    color: var(--color-text-muted);
    margin: var(--space-6) 0 var(--space-3);
}

/* ----- method chips ----- */

.api-method {
    display: inline-block;
    padding: 3px var(--space-2);
    font-family: var(--font-mono);
    font-size: 0.6875rem;
    font-weight: var(--fw-bold);
    letter-spacing: .04em;
    color: #fff;
    border-radius: var(--radius-sm);
    background: var(--pb-grey-500);
    min-width: 52px;
    text-align: center;
}

.api-method--get    { background: var(--pb-blue-600); }
.api-method--post   { background: var(--pb-paid); }
.api-method--put,
.api-method--patch  { background: var(--pb-pending); }
.api-method--delete { background: var(--pb-overdue); }

/* ----- data tables ----- */

.api-table-wrap { overflow-x: auto; margin: 0 0 var(--space-4); }

.api-table {
    width: 100%;
    border-collapse: collapse;
    font-size: var(--fs-sm);
}

.api-table th {
    text-align: left;
    font-weight: var(--fw-semibold);
    color: var(--color-text-muted);
    font-size: var(--fs-overline);
    letter-spacing: var(--ls-wide);
    text-transform: uppercase;
    padding: var(--space-2) var(--space-3);
    border-bottom: 1px solid var(--color-border-strong);
    white-space: nowrap;
}

.api-table td {
    padding: var(--space-3);
    border-bottom: var(--border);
    vertical-align: top;
    color: var(--color-text);
}

.api-table code { font-size: 0.8125rem; overflow-wrap: anywhere; }

.api-type {
    font-family: var(--font-mono);
    font-size: 0.75rem;
    color: var(--color-text-muted);
    white-space: nowrap;
}

.api-required {
    display: inline-block;
    margin-left: var(--space-1);
    font-size: 0.625rem;
    font-weight: var(--fw-semibold);
    letter-spacing: .04em;
    text-transform: uppercase;
    color: var(--pb-overdue-text);
}

.api-responses { margin: 0; padding-left: var(--space-5); font-size: var(--fs-sm); }
.api-responses li { margin-bottom: var(--space-1); }

.api-note {
    font-size: var(--fs-sm);
    color: var(--color-text-muted);
    margin: 0 0 var(--space-3);
}

.api-ref__footnote {
    margin-top: var(--space-12);
    padding-top: var(--space-6);
    border-top: var(--border);
    font-size: var(--fs-sm);
    color: var(--color-text-muted);
}

.api-ref code {
    font-family: var(--font-mono);
    background: var(--color-surface-sunken);
    padding: 2px 5px;
    border-radius: 4px;
}

@media (max-width: 640px) {
    .api-ref__facts { grid-template-columns: 1fr; gap: var(--space-1) 0; }
    .api-ref__facts dd { margin-bottom: var(--space-3); }
    .api-toc a { align-items: flex-start; flex-direction: column; gap: var(--space-1); }
}