/* ==========================================================================
   TrustLink Escrow — Public API Documentation Stylesheet (api-docs.css)
   Strictly scoped under .api-docs-page to prevent style leaks.
   Adheres to docs/DESIGN_GUIDELINES.md design tokens & mobile-first rules.
   ========================================================================== */

/* Hidden Attribute Protection */
.api-docs-page [hidden] {
    display: none !important;
}

/* Universal Media Containment */
.api-docs-page img,
.api-docs-page svg,
.api-docs-page video,
.api-docs-page canvas {
    max-width: 100%;
}

/* --- Accessible Skip Link --- */
.api-docs-page .skip-link {
    position: absolute;
    top: -100px;
    left: 16px;
    background: #2563EB;
    color: #FFFFFF;
    padding: 12px 20px;
    border-radius: 8px;
    font-weight: 600;
    z-index: 100000;
    transition: top 0.2s ease;
    text-decoration: none;
}
.api-docs-page .skip-link:focus {
    top: 16px;
    outline: 2px solid #FFFFFF;
}

/* --- Offline Banner (In-Flow beneath Navbar) --- */
.api-docs-page .api-docs-offline-banner {
    margin: 100px auto 0;
    max-width: 1200px;
    width: calc(100% - 32px);
    background-color: #FFFBEB;
    border: 1px solid #FCD34D;
    color: #92400E;
    padding: 12px 20px;
    border-radius: 12px;
    font-size: 0.9rem;
    font-weight: 500;
    display: flex;
    align-items: center;
    justify-content: center;
    gap: 8px;
    text-align: center;
    box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.03);
    box-sizing: border-box;
}

/* --- Base Body & Typography --- */
.api-docs-page {
    background-color: #F8FAFC;
    color: #475569;
    font-family: 'Inter', system-ui, -apple-system, sans-serif;
    line-height: 1.7;
    margin: 0;
    padding: 0;
    min-height: 100vh;
}

.api-docs-page h1,
.api-docs-page h2,
.api-docs-page h3,
.api-docs-page h4 {
    font-family: 'Outfit', sans-serif;
    color: #0F172A;
    margin-top: 0;
    letter-spacing: -0.02em;
    overflow-wrap: break-word;
}

.api-docs-eyebrow {
    display: inline-block;
    font-size: 0.75rem;
    font-weight: 800;
    text-transform: uppercase;
    letter-spacing: 0.06em;
    color: #2563EB;
    margin-bottom: 8px;
}

/* --- 2-Column Developer Hero Section --- */
.api-docs-page .api-docs-hero {
    padding: 140px 0 60px;
    background: linear-gradient(180deg, #FFFFFF 0%, #F8FAFC 100%);
    border-bottom: 1px solid #E2E8F0;
    width: 100%;
}

.api-docs-page .api-docs-hero-grid {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 40px;
    align-items: center;
    width: 100%;
    min-width: 0;
}

.api-docs-page .hero-left-col {
    max-width: 580px;
    width: 100%;
    min-width: 0;
}

.api-docs-page .api-badge-preview {
    display: inline-block;
    font-family: 'Inter', sans-serif;
    font-size: 0.8rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    padding: 6px 14px;
    border-radius: 9999px;
    background-color: #EFF6FF;
    color: #2563EB;
    margin-bottom: 20px;
    border: 1px solid rgba(37, 99, 235, 0.2);
}

.api-docs-page .hero-title {
    font-size: clamp(2rem, 3.5vw + 1rem, 3.5rem);
    font-weight: 800;
    line-height: 1.18;
    margin-bottom: 16px;
    overflow-wrap: break-word;
}

.api-docs-page .hero-subtext {
    font-size: clamp(0.95rem, 1.2vw, 1.15rem);
    color: #475569;
    margin-bottom: 28px;
    overflow-wrap: break-word;
}

.api-docs-page .hero-actions {
    display: flex;
    align-items: center;
    gap: 16px;
    flex-wrap: wrap;
    margin-bottom: 32px;
    width: 100%;
}

/* Base URL Card Component */
.api-docs-page .api-base-url-card {
    display: flex;
    align-items: center;
    background-color: #FFFFFF;
    border: 1px solid #E2E8F0;
    border-radius: 12px;
    padding: 10px 16px;
    box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.03);
    gap: 12px;
    max-width: 100%;
    width: 100%;
    min-width: 0;
    box-sizing: border-box;
    flex-wrap: wrap;
}

.api-docs-page .base-url-label {
    font-size: 0.75rem;
    font-weight: 700;
    text-transform: uppercase;
    color: #64748B;
    letter-spacing: 0.04em;
    flex-shrink: 0;
}

.api-docs-page .base-url-code {
    font-family: 'JetBrains Mono', 'Fira Code', monospace;
    font-size: 0.88rem;
    color: #2563EB;
    font-weight: 600;
    overflow-wrap: anywhere;
    word-break: break-all;
    min-width: 0;
    flex: 1;
}

.api-docs-page .btn-copy-url {
    background: #F1F5F9;
    border: 1px solid #E2E8F0;
    color: #0F172A;
    padding: 6px 12px;
    border-radius: 8px;
    font-size: 0.85rem;
    font-weight: 600;
    cursor: pointer;
    display: inline-flex;
    align-items: center;
    gap: 6px;
    transition: all 0.2s ease;
    flex-shrink: 0;
}
.api-docs-page .btn-copy-url:hover {
    background: #E2E8F0;
}

/* Hero Right Column: Code Preview Panel */
.api-docs-page .hero-right-col {
    width: 100%;
    min-width: 0;
}

.api-docs-page .api-docs-hero-code-card {
    background-color: #0F172A;
    border: 1px solid #1E293B;
    border-radius: 16px;
    box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.12);
    overflow: hidden;
    width: 100%;
    min-width: 0;
    box-sizing: border-box;
}

.api-docs-page .hero-code-header {
    background-color: #1E293B;
    padding: 12px 18px;
    display: flex;
    align-items: center;
    justify-content: space-between;
    border-bottom: 1px solid rgba(255, 255, 255, 0.08);
    flex-wrap: wrap;
    gap: 8px;
}

.api-docs-page .hero-code-lang {
    font-family: 'Outfit', sans-serif;
    font-size: 0.85rem;
    font-weight: 700;
    color: #3B82F6;
}

.api-docs-page .hero-code-endpoint {
    font-family: 'JetBrains Mono', monospace;
    font-size: 0.8rem;
    color: #94A3B8;
    overflow-wrap: anywhere;
    word-break: break-all;
}

.api-docs-page .btn-copy-hero-code {
    background: rgba(255, 255, 255, 0.1);
    border: 1px solid rgba(255, 255, 255, 0.15);
    color: #E2E8F0;
    padding: 4px 10px;
    border-radius: 6px;
    font-size: 0.78rem;
    font-weight: 600;
    cursor: pointer;
    display: inline-flex;
    align-items: center;
    gap: 4px;
    transition: background 0.15s ease;
    flex-shrink: 0;
}
.api-docs-page .btn-copy-hero-code:hover {
    background: rgba(255, 255, 255, 0.2);
}

.api-docs-page .api-docs-hero-code-card pre {
    margin: 0;
    padding: 18px;
    font-family: 'JetBrains Mono', monospace;
    font-size: 0.84rem;
    color: #E2E8F0;
    line-height: 1.6;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
    max-width: 100%;
    box-sizing: border-box;
}

/* --- Developer Notice Section --- */
.api-docs-page .api-notice-section {
    padding: 24px 0 12px;
    width: 100%;
}

.api-docs-page .api-notice-card {
    background-color: #EFF6FF;
    border: 1px solid #BFDBFE;
    border-radius: 12px;
    padding: 20px 24px;
    display: flex;
    align-items: flex-start;
    gap: 16px;
    width: 100%;
    box-sizing: border-box;
}

.api-docs-page .notice-icon {
    color: #2563EB;
    flex-shrink: 0;
    margin-top: 2px;
}

.api-docs-page .notice-text strong {
    color: #1E40AF;
    font-size: 1rem;
    display: block;
    margin-bottom: 4px;
}

.api-docs-page .notice-text p {
    color: #1E3A8A;
    margin: 0;
    font-size: 0.92rem;
    line-height: 1.6;
    overflow-wrap: break-word;
}

/* --- Main Layout Container & Toolbar --- */
.api-docs-page .api-docs-container {
    max-width: 1200px;
    width: 100%;
    margin: 0 auto;
    padding: 24px 24px 60px;
    box-sizing: border-box;
}

.api-docs-page .api-docs-toolbar {
    margin-bottom: 28px;
    display: flex;
    align-items: center;
    gap: 16px;
    flex-wrap: wrap;
    width: 100%;
}

/* Client-Side Search Engine Component */
.api-docs-page .api-docs-search {
    position: relative;
    flex-grow: 1;
    max-width: 600px;
    width: 100%;
}

.api-docs-page .search-input-inner {
    position: relative;
    display: flex;
    align-items: center;
    width: 100%;
}

.api-docs-page .search-icon {
    position: absolute;
    left: 16px;
    color: #64748B;
    pointer-events: none;
}

.api-docs-page .api-search-input {
    width: 100%;
    padding: 14px 44px 14px 44px;
    font-size: 0.95rem;
    font-family: 'Inter', sans-serif;
    border: 1px solid #E2E8F0;
    border-radius: 12px;
    background-color: #FFFFFF;
    color: #0F172A;
    box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.03);
    transition: all 0.2s ease;
    box-sizing: border-box;
}

.api-docs-page .api-search-input:focus {
    outline: none;
    border-color: #2563EB;
    box-shadow: 0 0 0 3px rgba(37, 99, 235, 0.15);
}

.api-docs-page .btn-clear-search {
    position: absolute;
    right: 14px;
    background: transparent;
    border: none;
    color: #64748B;
    cursor: pointer;
    padding: 4px;
    display: flex;
    align-items: center;
    justify-content: center;
    border-radius: 50%;
}
.api-docs-page .btn-clear-search:hover {
    color: #0F172A;
    background-color: #F1F5F9;
}

/* Autocomplete Search Results Dropdown */
.api-docs-page .search-results-dropdown {
    position: absolute;
    top: calc(100% + 8px);
    left: 0;
    right: 0;
    background-color: #FFFFFF;
    border: 1px solid #E2E8F0;
    border-radius: 12px;
    box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
    z-index: 100;
    max-height: 360px;
    overflow-y: auto;
    padding: 8px 0;
}

.api-docs-page .search-result-item {
    padding: 12px 20px;
    display: block;
    text-decoration: none;
    border-bottom: 1px solid #F1F5F9;
    transition: background 0.15s ease;
    cursor: pointer;
}
.api-docs-page .search-result-item:last-child {
    border-bottom: none;
}
.api-docs-page .search-result-item:hover,
.api-docs-page .search-result-item.selected {
    background-color: #EFF6FF;
}

.api-docs-page .search-result-title {
    font-weight: 600;
    color: #0F172A;
    font-size: 0.95rem;
    display: block;
    margin-bottom: 2px;
}

.api-docs-page .search-result-snippet {
    font-size: 0.85rem;
    color: #64748B;
    white-space: nowrap;
    overflow: hidden;
    text-overflow: ellipsis;
    display: block;
}

.api-docs-page .search-no-results {
    padding: 20px;
    text-align: center;
    color: #64748B;
    font-size: 0.9rem;
}

/* Mobile TOC Toggle Button */
.api-docs-page .api-docs-toc-toggle {
    display: none;
    background: #FFFFFF;
    border: 1px solid #E2E8F0;
    padding: 12px 18px;
    border-radius: 12px;
    font-weight: 600;
    font-size: 0.9rem;
    color: #0F172A;
    cursor: pointer;
    align-items: center;
    gap: 8px;
    box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.03);
    min-height: 44px;
}

/* --- 2-Column Responsive Documentation Shell --- */
.api-docs-page .api-docs-shell {
    display: flex;
    gap: 40px;
    align-items: flex-start;
    width: 100%;
    min-width: 0;
}

/* Left Sticky Navigation Sidebar */
.api-docs-page .api-docs-toc {
    width: 240px;
    flex-shrink: 0;
    position: sticky;
    top: 100px;
    max-height: calc(100vh - 120px);
    overflow-y: auto;
    background-color: #FFFFFF;
    border: 1px solid #E2E8F0;
    border-radius: 16px;
    padding: 20px;
    box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.03);
    box-sizing: border-box;
}

.api-docs-page .sidebar-heading {
    font-size: 0.8rem;
    font-weight: 700;
    text-transform: uppercase;
    color: #64748B;
    letter-spacing: 0.05em;
    margin-bottom: 16px;
}

.api-docs-page .toc-nav {
    display: flex;
    flex-direction: column;
    gap: 4px;
}

.api-docs-page .toc-item {
    display: block;
    padding: 8px 12px;
    border-radius: 8px;
    font-size: 0.9rem;
    font-weight: 500;
    color: #475569;
    text-decoration: none;
    transition: all 0.15s ease;
}

.api-docs-page .toc-item:hover {
    color: #2563EB;
    background-color: #EFF6FF;
}

.api-docs-page .toc-item.active {
    color: #2563EB;
    background-color: #EFF6FF;
    font-weight: 700;
    border-left: 3px solid #2563EB;
    padding-left: 9px;
}

/* Main Content Reading Column */
.api-docs-page .api-docs-content {
    flex: 1;
    min-width: 0;
    width: 100%;
    max-width: 100%;
}

.api-docs-page .doc-section {
    background-color: #FFFFFF;
    border: 1px solid #E2E8F0;
    border-radius: 16px;
    padding: 32px;
    margin-bottom: 32px;
    box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.03);
    scroll-margin-top: 110px;
    width: 100%;
    max-width: 100%;
    min-width: 0;
    box-sizing: border-box;
    overflow-wrap: break-word;
}

.api-docs-page .doc-section h2 {
    font-size: 1.6rem;
    font-weight: 700;
    border-bottom: 1px solid #F1F5F9;
    padding-bottom: 12px;
    margin-bottom: 20px;
    overflow-wrap: break-word;
}

.api-docs-page .doc-section h3 {
    font-size: 1.2rem;
    font-weight: 600;
    margin-top: 28px;
    margin-bottom: 14px;
    overflow-wrap: break-word;
}

.api-docs-page .doc-section p {
    font-size: 0.98rem;
    margin-bottom: 16px;
    color: #475569;
    overflow-wrap: break-word;
}

.api-docs-page .doc-section ul,
.api-docs-page .doc-section ol {
    padding-left: 24px;
    margin-bottom: 20px;
}

.api-docs-page .doc-section li {
    margin-bottom: 8px;
    color: #475569;
    overflow-wrap: break-word;
}

.api-docs-page .doc-section a {
    overflow-wrap: break-word;
}

/* Callout Boxes & Warnings */
.api-docs-page .info-callout, .api-docs-page .warning-callout {
    border-radius: 12px;
    padding: 20px 24px;
    margin: 20px 0;
    font-size: 0.95rem;
    width: 100%;
    box-sizing: border-box;
    overflow-wrap: break-word;
}

.api-docs-page .info-callout {
    background-color: #EFF6FF;
    border-left: 4px solid #2563EB;
    color: #1E3A8A;
}

.api-docs-page .info-callout strong {
    color: #1E40AF;
}

.api-docs-page .warning-callout {
    background-color: #FFFBEB;
    border-left: 4px solid #F59E0B;
    color: #92400E;
}

.api-docs-page .warning-callout strong {
    color: #B45309;
}

/* Quickstart Steps — Responsive Grid Layout */
.api-docs-page .quickstart-steps {
    list-style: none;
    padding: 0 !important;
    margin: 24px 0;
    counter-reset: step-counter;
    display: flex;
    flex-direction: column;
    gap: 24px;
    width: 100%;
}

.api-docs-page .quickstart-steps li {
    display: grid;
    grid-template-columns: 32px minmax(0, 1fr);
    gap: 16px;
    align-items: start;
    width: 100%;
    min-width: 0;
    position: relative;
    padding-left: 0 !important;
    margin-bottom: 0;
}

.api-docs-page .quickstart-steps li::before {
    counter-increment: step-counter;
    content: counter(step-counter);
    width: 32px;
    height: 32px;
    background-color: #EFF6FF;
    color: #2563EB;
    border-radius: 50%;
    display: flex;
    align-items: center;
    justify-content: center;
    font-weight: 700;
    font-size: 0.9rem;
    font-family: 'Outfit', sans-serif;
    flex-shrink: 0;
}

.api-docs-page .quickstart-steps .step-content {
    min-width: 0;
    width: 100%;
    overflow-wrap: break-word;
}

.api-docs-page .quickstart-steps .step-content strong {
    display: block;
    font-size: 1.05rem;
    color: #0F172A;
    margin-bottom: 4px;
    white-space: normal;
    overflow-wrap: break-word;
}

.api-docs-page .quickstart-steps .step-content p {
    margin: 0;
    font-size: 0.95rem;
    color: #475569;
    overflow-wrap: break-word;
}

.api-docs-page .quickstart-steps a {
    overflow-wrap: break-word;
}

.api-docs-page .quickstart-steps code {
    overflow-wrap: anywhere;
    word-break: break-all;
}

/* Endpoint Header Badge */
.api-docs-page .endpoint-header-badge {
    display: flex;
    align-items: center;
    gap: 12px;
    background-color: #0F172A;
    padding: 14px 20px;
    border-radius: 12px;
    margin-bottom: 24px;
    flex-wrap: wrap;
    width: 100%;
    box-sizing: border-box;
}

.api-docs-page .method-badge {
    font-family: 'Outfit', sans-serif;
    font-weight: 800;
    font-size: 0.85rem;
    padding: 4px 10px;
    border-radius: 6px;
    letter-spacing: 0.05em;
    flex-shrink: 0;
}

.api-docs-page .method-badge.post {
    background-color: #2563EB;
    color: #FFFFFF;
}

.api-docs-page .endpoint-path-text {
    font-family: 'JetBrains Mono', monospace;
    color: #FFFFFF;
    font-size: 1.05rem;
    font-weight: 600;
    overflow-wrap: anywhere;
    word-break: break-all;
    min-width: 0;
    flex: 1;
}

.api-docs-page .endpoint-badge-preview {
    display: inline-flex;
    align-items: center;
    font-family: 'Inter', sans-serif;
    font-size: 0.72rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.04em;
    padding: 4px 10px;
    border-radius: 6px;
    background-color: rgba(37, 99, 235, 0.15);
    color: #60A5FA;
    border: 1px solid rgba(96, 165, 250, 0.3);
    margin-left: auto;
    white-space: nowrap;
    flex-shrink: 0;
}

.api-docs-page .spec-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
    gap: 16px;
    margin: 20px 0;
    width: 100%;
}

.api-docs-page .spec-item {
    background-color: #F8FAFC;
    border: 1px solid #E2E8F0;
    padding: 12px 16px;
    border-radius: 10px;
    box-sizing: border-box;
}

.api-docs-page .spec-label {
    display: block;
    font-size: 0.75rem;
    font-weight: 700;
    text-transform: uppercase;
    color: #64748B;
}

.api-docs-page .spec-val {
    font-weight: 600;
    color: #0F172A;
    font-size: 0.95rem;
}

/* --- Tables & Schema Styling --- */
.api-docs-page .table-container {
    width: 100%;
    max-width: 100%;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
    margin: 20px 0;
    border: 1px solid #E2E8F0;
    border-radius: 12px;
    box-sizing: border-border;
}

.api-docs-page .schema-table {
    width: 100%;
    min-width: 520px;
    border-collapse: collapse;
    text-align: left;
    font-size: 0.9rem;
}

.api-docs-page .schema-table th {
    background-color: #F8FAFC;
    color: #0F172A;
    font-family: 'Outfit', sans-serif;
    font-weight: 600;
    padding: 14px 16px;
    border-bottom: 1px solid #E2E8F0;
}

.api-docs-page .schema-table td {
    padding: 14px 16px;
    border-bottom: 1px solid #F1F5F9;
    vertical-align: top;
    color: #475569;
    overflow-wrap: break-word;
}

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

.api-docs-page .schema-table code {
    font-family: 'JetBrains Mono', monospace;
    background-color: #F1F5F9;
    padding: 2px 6px;
    border-radius: 4px;
    font-size: 0.85rem;
    color: #0F172A;
    overflow-wrap: anywhere;
    word-break: break-all;
}

.api-docs-page .status-pill {
    display: inline-block;
    font-size: 0.75rem;
    font-weight: 700;
    padding: 3px 8px;
    border-radius: 9999px;
    white-space: nowrap;
}

.api-docs-page .status-pill.required {
    background-color: #FEE2E2;
    color: #DC2626;
}

.api-docs-page .status-pill.optional {
    background-color: #F1F5F9;
    color: #64748B;
}

.api-docs-page .table-note {
    font-size: 0.85rem;
    color: #64748B;
}

/* --- Code Snippet & Tab Controller --- */
.api-docs-page .code-tab-container,
.api-docs-page .code-block-wrapper {
    background-color: #0F172A;
    border-radius: 12px;
    overflow: hidden;
    margin: 20px 0;
    box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
    width: 100%;
    max-width: 100%;
    min-width: 0;
    box-sizing: border-box;
}

.api-docs-page .code-tab-header,
.api-docs-page .code-block-header {
    background-color: #1E293B;
    padding: 8px 16px;
    display: flex;
    align-items: center;
    gap: 8px;
    border-bottom: 1px solid rgba(255, 255, 255, 0.08);
    flex-wrap: wrap;
}

.api-docs-page .code-block-title {
    font-family: 'Outfit', sans-serif;
    font-size: 0.85rem;
    font-weight: 600;
    color: #94A3B8;
}

.api-docs-page .status-tag.success {
    background-color: #059669;
    color: #FFFFFF;
    font-size: 0.75rem;
    font-weight: 700;
    padding: 2px 8px;
    border-radius: 4px;
    margin-left: auto;
}

.api-docs-page .code-tab-btn {
    background: transparent;
    border: none;
    color: #94A3B8;
    font-family: 'Inter', sans-serif;
    font-size: 0.85rem;
    font-weight: 600;
    padding: 8px 14px;
    border-radius: 6px;
    cursor: pointer;
    transition: all 0.15s ease;
    min-height: 38px;
}

.api-docs-page .code-tab-btn:hover {
    color: #FFFFFF;
}

.api-docs-page .code-tab-btn.active {
    background-color: #2563EB;
    color: #FFFFFF;
}

.api-docs-page .tab-spacer {
    flex-grow: 1;
}

.api-docs-page .btn-copy-code {
    background: rgba(255, 255, 255, 0.1);
    border: 1px solid rgba(255, 255, 255, 0.15);
    color: #E2E8F0;
    padding: 6px 12px;
    border-radius: 6px;
    font-size: 0.8rem;
    font-weight: 600;
    cursor: pointer;
    display: inline-flex;
    align-items: center;
    gap: 6px;
    transition: background 0.15s ease;
    flex-shrink: 0;
    min-height: 36px;
}
.api-docs-page .btn-copy-code:hover {
    background: rgba(255, 255, 255, 0.2);
}

.api-docs-page .code-tab-panel pre,
.api-docs-page .code-block-wrapper pre {
    margin: 0;
    padding: 18px;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
    font-family: 'JetBrains Mono', 'Fira Code', monospace;
    font-size: 0.88rem;
    color: #E2E8F0;
    line-height: 1.6;
    max-width: 100%;
    box-sizing: border-box;
}

.api-docs-page .code-tab-panel[hidden] {
    display: none;
}

/* --- Transaction State Machine Section --- */
.api-docs-page .api-docs-state-flow {
    display: flex;
    align-items: center;
    justify-content: center;
    gap: 12px;
    flex-wrap: wrap;
    margin: 20px 0 8px;
    background: #FFFFFF;
    border: 1px solid #E2E8F0;
    padding: 16px;
    border-radius: 12px;
    width: 100%;
    box-sizing: border-box;
}

.api-docs-page .state-flow-step .flow-code {
    font-family: 'JetBrains Mono', monospace;
    font-size: 0.8rem;
    font-weight: 700;
    background: #F1F5F9;
    padding: 4px 8px;
    border-radius: 6px;
    color: #0F172A;
    white-space: nowrap;
}

.api-docs-page .state-flow-arrow {
    color: #94A3B8;
    font-weight: 700;
}

.api-docs-page .state-flow-subtext {
    font-size: 0.85rem;
    color: #64748B;
    margin-bottom: 24px;
    text-align: center;
    overflow-wrap: break-word;
}

/* Uniform 6-Card State Grid */
.api-docs-page .api-docs-state-grid {
    display: grid;
    grid-template-columns: repeat(3, minmax(0, 1fr));
    gap: 20px;
    align-items: stretch;
    width: 100%;
}

.api-docs-page .api-docs-state-card {
    height: 100%;
    display: flex;
    flex-direction: column;
    border-radius: 12px;
    padding: 20px;
    border-left: 4px solid var(--state-accent);
    background-color: var(--state-bg);
    box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.03);
    box-sizing: border-box;
    width: 100%;
    min-width: 0;
}

.api-docs-page .api-docs-state-card__header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 12px;
    margin-bottom: 12px;
    flex-wrap: wrap;
    width: 100%;
}

.api-docs-page .api-docs-state-card__constant {
    font-family: 'JetBrains Mono', monospace;
    font-size: 0.8rem;
    font-weight: 700;
    padding: 4px 8px;
    border-radius: 6px;
    background-color: var(--state-accent);
    color: #FFFFFF;
    white-space: nowrap;
}

.api-docs-page .api-docs-state-card__label {
    font-family: 'Inter', sans-serif;
    font-size: 0.85rem;
    font-weight: 600;
    color: var(--state-text);
    text-align: right;
    margin-left: auto;
}

.api-docs-page .api-docs-state-card__description {
    font-size: 0.88rem;
    color: #334155;
    margin: 0 !important;
    line-height: 1.55;
    overflow-wrap: break-word;
}

/* Exact State Colors matching DESIGN_GUIDELINES.md */
.api-docs-page .api-docs-state-card--pending {
    --state-bg: #FEF3C7;
    --state-text: #D97706;
    --state-accent: #F59E0B;
}

.api-docs-page .api-docs-state-card--escrowed {
    --state-bg: #DCFCE7;
    --state-text: #064E3B;
    --state-accent: #10B981;
}

.api-docs-page .api-docs-state-card--shipped {
    --state-bg: #E0F2FE;
    --state-text: #0284C7;
    --state-accent: #0EA5E9;
}

.api-docs-page .api-docs-state-card--completed {
    --state-bg: #DBEAFE;
    --state-text: #1D4ED8;
    --state-accent: #3B82F6;
}

.api-docs-page .api-docs-state-card--disputed {
    --state-bg: #FEE2E2;
    --state-text: #DC2626;
    --state-accent: #EF4444;
}

.api-docs-page .api-docs-state-card--refunded {
    --state-bg: #F1F5F9;
    --state-text: #475569;
    --state-accent: #94A3B8;
}

/* Support Card Component & Restyled Buttons */
.api-docs-page .support-card {
    background: linear-gradient(135deg, #0F172A 0%, #1E293B 100%);
    color: #FFFFFF;
    border-radius: 16px;
    padding: 32px;
    margin-top: 20px;
    width: 100%;
    box-sizing: border-box;
}

.api-docs-page .support-card h3 {
    color: #FFFFFF;
    margin-top: 0;
    font-size: 1.3rem;
}

.api-docs-page .support-card p {
    color: #94A3B8;
    margin-bottom: 20px;
    overflow-wrap: break-word;
}

.api-docs-page .support-actions {
    display: flex;
    align-items: center;
    gap: 16px;
    flex-wrap: wrap;
    margin-top: 20px;
    width: 100%;
}

.api-docs-page .support-actions .btn {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    height: 44px;
    min-height: 44px;
    padding: 0 24px;
    border-radius: 10px;
    font-family: 'Inter', sans-serif;
    font-size: 0.92rem;
    font-weight: 600;
    text-decoration: none;
    cursor: pointer;
    box-sizing: border-box;
    transition: all 0.2s cubic-bezier(0.16, 1, 0.3, 1);
}

/* Primary Button: Contact Support */
.api-docs-page .support-actions .btn-support-primary {
    background-color: #2563EB;
    color: #FFFFFF !important;
    border: 1px solid #2563EB;
    box-shadow: 0 4px 12px rgba(37, 99, 235, 0.25);
}

.api-docs-page .support-actions .btn-support-primary:hover {
    background-color: #1D4ED8;
    border-color: #1D4ED8;
    color: #FFFFFF !important;
    transform: translateY(-1px);
    box-shadow: 0 6px 16px rgba(37, 99, 235, 0.35);
}

.api-docs-page .support-actions .btn-support-primary:active {
    background-color: #1E40AF;
    border-color: #1E40AF;
    transform: translateY(0);
}

/* Secondary Button: Explore E-Commerce Solutions */
.api-docs-page .support-actions .btn-support-secondary {
    background-color: rgba(255, 255, 255, 0.08);
    color: #FFFFFF !important;
    border: 1px solid rgba(255, 255, 255, 0.2);
}

.api-docs-page .support-actions .btn-support-secondary:hover {
    background-color: rgba(255, 255, 255, 0.16);
    border-color: rgba(255, 255, 255, 0.35);
    color: #FFFFFF !important;
    transform: translateY(-1px);
}

.api-docs-page .support-actions .btn-support-secondary:active {
    background-color: rgba(255, 255, 255, 0.05);
    transform: translateY(0);
}

/* --- Accessibility Focus Rings --- */
.api-docs-page a:focus-visible,
.api-docs-page button:focus-visible,
.api-docs-page input:focus-visible,
.api-docs-page select:focus-visible {
    outline: 2px solid #2563EB;
    outline-offset: 2px;
}

/* --- Responsive Breakpoint Adjustments --- */
@media (max-width: 1023px) {
    .api-docs-page .api-docs-hero-grid {
        grid-template-columns: 1fr;
        gap: 32px;
    }

    .api-docs-page .hero-left-col {
        max-width: 100%;
    }

    .api-docs-page .api-docs-state-grid {
        grid-template-columns: repeat(2, minmax(0, 1fr));
    }

    .api-docs-page .api-docs-toc-toggle {
        display: flex;
    }

    .api-docs-page .api-docs-shell {
        flex-direction: column;
        gap: 20px;
    }

    .api-docs-page .api-docs-toc {
        display: none;
        width: 100%;
        position: static;
        max-height: none;
        box-sizing: border-box;
    }

    .api-docs-page .api-docs-toc.open {
        display: block;
    }

    .api-docs-page .doc-section {
        padding: 24px;
    }
}

@media (max-width: 768px) {
    .api-docs-page .api-docs-hero {
        padding: 100px 0 36px;
    }

    .api-docs-page .api-docs-offline-banner {
        margin-top: 80px;
    }

    .api-docs-page .footer {
        padding-bottom: calc(120px + env(safe-area-inset-bottom, 0px));
    }
}

@media (max-width: 640px) {
    .api-docs-page .api-docs-hero {
        padding: 95px 0 32px;
    }

    .api-docs-page .api-docs-container {
        padding: 16px 16px 40px;
    }

    .api-docs-page .doc-section {
        padding: 20px 16px;
        border-radius: 14px;
    }

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

    .api-docs-page .api-docs-state-card__header {
        flex-direction: column;
        align-items: flex-start;
        gap: 6px;
    }

    .api-docs-page .api-docs-state-card__label {
        text-align: left;
        margin-left: 0;
    }

    .api-docs-page .schema-table th,
    .api-docs-page .schema-table td {
        padding: 10px 12px;
    }

    .api-docs-page .endpoint-header-badge {
        flex-direction: row;
        flex-wrap: wrap;
        align-items: center;
        gap: 10px;
    }

    .api-docs-page .endpoint-header-badge .endpoint-badge-preview {
        margin-left: 0;
    }

    .api-docs-page .hero-actions {
        flex-direction: column;
        width: 100%;
    }

    .api-docs-page .hero-actions .btn {
        width: 100%;
        min-height: 44px;
    }

    .api-docs-page .support-actions {
        flex-direction: column;
        width: 100%;
        gap: 12px;
    }

    .api-docs-page .support-actions .btn {
        width: 100%;
    }
}

/* --- Reduced Motion User Fallbacks --- */
@media (prefers-reduced-motion: reduce) {
    *, ::before, ::after {
        animation-duration: 0.01ms !important;
        animation-iteration-count: 1 !important;
        transition-duration: 0.01ms !important;
        scroll-behavior: auto !important;
    }
}