/* ========================================
   DOCUMENTATION PAGE
   ======================================== */

.docs-page {
    background: var(--bg-paper);
    color: var(--ink-black);
}

/* ---- Header ---- */

.docs-header {
    padding: 6rem 0 3.5rem;
    border-bottom: 1px solid var(--border-subtle);
}

.docs-header h1 {
    font-family: var(--serif-display);
    font-size: clamp(2rem, 4vw, 3rem);
    font-weight: 500;
    letter-spacing: -0.02em;
    margin: 0.5rem 0 1rem;
}

.docs-header__lead {
    font-family: var(--serif-body);
    font-size: 1.1rem;
    color: var(--charcoal);
    max-width: 600px;
    line-height: 1.7;
    margin: 0 0 1.5rem;
}

.docs-header__meta {
    display: flex;
    align-items: center;
    gap: 1rem;
    flex-wrap: wrap;
}

.docs-header__meta-text {
    font-family: var(--sans-ui);
    font-size: 0.85rem;
    color: var(--charcoal);
}

/* ---- Badge (header) ---- */

.docs-badge {
    display: inline-block;
    font-family: var(--sans-ui);
    font-size: 0.65rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.15em;
    padding: 0.3rem 0.65rem;
    border-radius: 3px;
}

.docs-badge--info {
    background: #e8f0fe;
    color: #2d4bac;
    border: 1px solid #c5d4f8;
}

/* ---- Layout ---- */

.docs-layout {
    padding: 4rem 0 6rem;
}

.docs-wrapper {
    display: grid;
    grid-template-columns: 230px 1fr;
    gap: 4rem;
    align-items: start;
}

/* ---- Sidebar ---- */

.docs-sidebar {
    position: sticky;
    top: 100px;
}

.docs-nav__group {
    margin-bottom: 1.75rem;
}

.docs-nav__label {
    display: block;
    font-family: var(--sans-ui);
    font-size: 0.625rem;
    text-transform: uppercase;
    letter-spacing: 0.18em;
    color: var(--muted-taupe);
    font-weight: 700;
    margin-bottom: 0.6rem;
}

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

.docs-nav__group li {
    margin-bottom: 0.15rem;
}

.docs-nav__link {
    font-family: var(--sans-ui);
    font-size: 0.825rem;
    color: var(--charcoal);
    text-decoration: none;
    display: block;
    padding: 0.25rem 0 0.25rem 0.75rem;
    border-left: 2px solid transparent;
    transition: color 0.18s ease, border-color 0.18s ease;
    line-height: 1.4;
}

.docs-nav__link:hover,
.docs-nav__link.is-active {
    color: var(--ink-black);
    border-left-color: var(--ink-black);
}

/* ---- Content area ---- */

.docs-content {
    min-width: 0;
}

.docs-section {
    scroll-margin-top: 110px;
}

/* Section group tag */
.docs-section__tag {
    font-family: var(--sans-ui);
    font-size: 0.625rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.18em;
    color: var(--muted-taupe);
    margin-bottom: 0.6rem;
}

.docs-section h2 {
    font-family: var(--serif-display);
    font-size: 1.6rem;
    font-weight: 500;
    letter-spacing: -0.01em;
    margin-top: 0;
    margin-bottom: 1rem;
}

.docs-section h3 {
    font-family: var(--sans-ui);
    font-size: 0.8rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.1em;
    margin-top: 2rem;
    margin-bottom: 0.6rem;
    color: var(--charcoal);
    display: flex;
    align-items: center;
    gap: 0.5rem;
}

.docs-section p {
    font-family: var(--serif-body);
    font-size: 1rem;
    line-height: 1.75;
    color: var(--charcoal);
    margin-bottom: 1rem;
}

.docs-divider {
    border: none;
    border-top: 1px solid var(--border-subtle);
    margin: 3rem 0;
}

/* ---- Endpoint header ---- */

.docs-endpoint-header {
    display: flex;
    align-items: center;
    gap: 0.75rem;
    margin-bottom: 1rem;
    padding: 0.75rem 1rem;
    background: #f9f8f4;
    border: 1px solid var(--border-subtle);
    border-radius: 4px;
}

/* HTTP Method badges */

.docs-method {
    font-family: var(--sans-ui);
    font-size: 0.7rem;
    font-weight: 700;
    letter-spacing: 0.08em;
    padding: 0.25rem 0.55rem;
    border-radius: 3px;
    flex-shrink: 0;
}

.docs-method--post {
    background: #dbeafe;
    color: #1e40af;
}

.docs-method--get {
    background: #d1fae5;
    color: #065f46;
}

.docs-endpoint-path {
    font-family: 'JetBrains Mono', 'Fira Code', 'Courier New', monospace;
    font-size: 0.875rem;
    color: var(--ink-black);
    background: none;
    border: none;
    padding: 0;
}

/* Content-type label */
.docs-content-type {
    font-family: var(--sans-ui);
    font-size: 0.7rem;
    font-weight: 400;
    text-transform: none;
    letter-spacing: 0;
    color: var(--muted-taupe);
}

/* ---- Concept grid ---- */

.docs-concept-grid {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 1.5rem;
    margin-top: 1rem;
}

.docs-concept {
    padding: 1.25rem 1.5rem;
    border: 1px solid var(--border-subtle);
    border-radius: 4px;
    background: #fdfcfa;
}

.docs-concept h3 {
    font-family: var(--sans-ui);
    font-size: 0.8rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.1em;
    color: var(--ink-black);
    margin-top: 0;
    margin-bottom: 0.5rem;
}

.docs-concept p {
    font-family: var(--sans-ui);
    font-size: 0.875rem;
    line-height: 1.65;
    color: var(--charcoal);
    margin: 0;
}

/* ---- Issue type tiles ---- */

.docs-issue-types {
    display: grid;
    grid-template-columns: repeat(3, 1fr);
    gap: 1rem;
    margin-bottom: 2rem;
}

.docs-issue-type {
    padding: 1rem 1.25rem;
    border: 1px solid var(--border-subtle);
    border-radius: 4px;
}

.docs-issue-type p {
    font-family: var(--sans-ui);
    font-size: 0.825rem;
    line-height: 1.55;
    color: var(--charcoal);
    margin: 0.5rem 0 0;
}

.docs-issue-badge {
    display: inline-block;
    font-family: var(--sans-ui);
    font-size: 0.65rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.12em;
    padding: 0.25rem 0.55rem;
    border-radius: 3px;
}

.docs-issue-badge--duplicate {
    background: #fee2e2;
    color: #991b1b;
}

.docs-issue-badge--validation {
    background: #fef3c7;
    color: #92400e;
}

.docs-issue-badge--replacement {
    background: #ede9fe;
    color: #4c1d95;
}

/* ---- Status code badges ---- */

.docs-status {
    font-family: 'JetBrains Mono', 'Fira Code', 'Courier New', monospace;
    font-size: 0.8em;
    padding: 0.15em 0.45em;
    border-radius: 3px;
    font-weight: 600;
}

.docs-status--4xx {
    background: #fef3c7;
    color: #92400e;
    border: 1px solid #fde68a;
}

.docs-status--5xx {
    background: #fee2e2;
    color: #991b1b;
    border: 1px solid #fecaca;
}

/* ---- Lists ---- */

.docs-list {
    font-family: var(--serif-body);
    font-size: 1rem;
    line-height: 1.75;
    color: var(--charcoal);
    padding-left: 1.5rem;
    margin-bottom: 1rem;
}

.docs-list li {
    margin-bottom: 0.4rem;
}

/* ---- Code blocks ---- */

.docs-code {
    background: #f4f2ee;
    border: 1px solid var(--border-subtle);
    border-radius: 4px;
    padding: 1.25rem 1.5rem;
    font-family: 'JetBrains Mono', 'Fira Code', 'Courier New', monospace;
    font-size: 0.82rem;
    line-height: 1.65;
    overflow-x: auto;
    margin: 1rem 0 1.5rem;
    color: #2d2d2d;
}

/* ---- Inline code ---- */

.docs-section code {
    font-family: 'JetBrains Mono', 'Fira Code', 'Courier New', monospace;
    font-size: 0.85em;
    background: #f4f2ee;
    border: 1px solid var(--border-subtle);
    border-radius: 3px;
    padding: 0.15em 0.4em;
    color: #2d2d2d;
}

.docs-code code {
    background: none;
    border: none;
    padding: 0;
    font-size: inherit;
}

/* ---- Tables ---- */

.docs-table {
    width: 100%;
    border-collapse: collapse;
    font-family: var(--sans-ui);
    font-size: 0.875rem;
    margin-bottom: 1.5rem;
}

.docs-table th {
    text-align: left;
    font-weight: 700;
    font-size: 0.7rem;
    text-transform: uppercase;
    letter-spacing: 0.1em;
    color: var(--muted-taupe);
    border-bottom: 1px solid var(--border-subtle);
    padding: 0.5rem 1rem 0.5rem 0;
}

.docs-table td {
    padding: 0.6rem 1rem 0.6rem 0;
    border-bottom: 1px solid var(--border-subtle);
    color: var(--charcoal);
    vertical-align: top;
}

.docs-table tr:last-child td {
    border-bottom: none;
}

/* ---- Callouts ---- */

.docs-callout {
    font-family: var(--sans-ui);
    font-size: 0.875rem;
    line-height: 1.65;
    padding: 1rem 1.25rem;
    border-left: 3px solid;
    margin: 1.5rem 0;
    border-radius: 0 4px 4px 0;
}

.docs-callout--info {
    background: #eff6ff;
    border-color: #3b82f6;
    color: #1e3a6e;
}

.docs-callout--warning {
    background: #fffbeb;
    border-color: #f59e0b;
    color: #78350f;
}

/* ---- Responsive ---- */

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

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

@media (max-width: 900px) {
    .docs-wrapper {
        grid-template-columns: 1fr;
        gap: 2rem;
    }

    .docs-sidebar {
        position: static;
        border-bottom: 1px solid var(--border-subtle);
        padding-bottom: 2rem;
    }

    .docs-nav__group {
        display: inline-block;
        margin-right: 2rem;
        margin-bottom: 1rem;
        vertical-align: top;
    }

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

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