/* ============================================================
   Blog-Doc Docs Theme — style.css
   Dark, WCAG AA, no external dependencies
   ============================================================ */

/* ── Design tokens ─────────────────────────────────────────── */
:root {
    /* Canvas */
    --bg: #0d1117;
    --surface: #161b22;
    --surface-2: #1c2128;
    --surface-3: #21262d;
    --border: #30363d;
    --border-2: #21262d;

    /* Text */
    --text: #e6edf3; /* ~14:1 on --bg  — AAA */
    --text-2: #8b949e; /* ~5.5:1 on --bg — AA  */
    --text-3: #6e7681; /* muted labels         */

    /* Accent — forge orange */
    --accent: #e85d26;
    --accent-2: #f0723d;
    --accent-bg: rgba(232, 93, 38, 0.1);
    --accent-bg-2: rgba(232, 93, 38, 0.18);

    /* HTTP method badges */
    --get: #3fb950;
    --get-bg: rgba(63, 185, 80, 0.12);
    --post: #58a6ff;
    --post-bg: rgba(88, 166, 255, 0.12);
    --put: #d29922;
    --put-bg: rgba(210, 153, 34, 0.12);
    --delete: #f85149;
    --delete-bg: rgba(248, 81, 73, 0.12);
    --patch: #bc8cff;
    --patch-bg: rgba(188, 140, 255, 0.12);

    /* Callout colours */
    --note-border: #58a6ff;
    --note-bg: rgba(88, 166, 255, 0.08);
    --tip-border: #3fb950;
    --tip-bg: rgba(63, 185, 80, 0.08);
    --warn-border: #d29922;
    --warn-bg: rgba(210, 153, 34, 0.08);

    /* Layout */
    --sidebar-w: 260px;
    --toc-w: 220px;
    --header-h: 56px;
    --content-max: 780px;
    --gap: 1.5rem;

    /* Type */
    --font-sans: "Inter", system-ui, -apple-system, sans-serif;
    --font-mono: "JetBrains Mono", "Fira Code", "Cascadia Code", monospace;
    --font-display: "Inter", system-ui, sans-serif;

    /* Radius */
    --r-sm: 4px;
    --r: 6px;
    --r-lg: 10px;

    /* Transitions */
    --t: 150ms ease;
    --t-slow: 250ms ease;
}

/* ── Reset & base ────────────────────────────────────────────── */
*,
*::before,
*::after {
    box-sizing: border-box;
    margin: 0;
    padding: 0;
}

html {
    scroll-behavior: smooth;
    scroll-padding-top: calc(var(--header-h) + 1.5rem);
    font-size: 16px;
    -webkit-text-size-adjust: 100%;
}

body {
    background: var(--bg);
    color: var(--text);
    font-family: var(--font-sans);
    font-size: 0.9375rem;
    line-height: 1.7;
    min-height: 100vh;
}

a {
    color: var(--accent-2);
    text-decoration: none;
}
a:hover {
    color: var(--accent-2);
    text-decoration: underline;
}
a:focus-visible {
    outline: 2px solid var(--accent);
    outline-offset: 3px;
    border-radius: var(--r-sm);
}

img {
    max-width: 100%;
    display: block;
}
button {
    cursor: pointer;
    font-family: inherit;
}

/* ── Skip link ───────────────────────────────────────────────── */
.skip-link {
    position: absolute;
    top: -100%;
    left: 1rem;
    background: var(--accent);
    color: #fff;
    padding: 0.5rem 1rem;
    border-radius: var(--r);
    font-weight: 600;
    z-index: 9999;
    transition: top var(--t);
}
.skip-link:focus {
    top: 0.5rem;
}

/* ── Header ──────────────────────────────────────────────────── */
.site-header {
    position: fixed;
    top: 0;
    left: 0;
    right: 0;
    height: var(--header-h);
    background: rgba(13, 17, 23, 0.92);
    backdrop-filter: blur(12px);
    -webkit-backdrop-filter: blur(12px);
    border-bottom: 1px solid var(--border);
    z-index: 100;
    display: flex;
    align-items: center;
    gap: 1rem;
    padding: 0 1.25rem;
}

.header-sidebar-toggle {
    display: none;
    background: none;
    border: none;
    color: var(--text-2);
    padding: 6px;
    border-radius: var(--r);
    line-height: 0;
    transition:
        color var(--t),
        background var(--t);
}
.header-sidebar-toggle:hover {
    color: var(--text);
    background: var(--surface-2);
}

.header-brand {
    display: flex;
    align-items: center;
    gap: 0.625rem;
    color: var(--text);
    font-weight: 700;
    font-size: 1rem;
    letter-spacing: -0.01em;
    white-space: nowrap;
    text-decoration: none;
    flex-shrink: 0;
}
.header-brand:hover {
    color: var(--text);
    text-decoration: none;
}

.brand-icon {
    width: 28px;
    height: 28px;
    background: var(--accent);
    border-radius: var(--r-sm);
    display: flex;
    align-items: center;
    justify-content: center;
    flex-shrink: 0;
}
.brand-icon svg {
    width: 16px;
    height: 16px;
    color: #fff;
}

.brand-name {
    color: var(--text);
}
.brand-version {
    font-size: 0.6875rem;
    font-weight: 500;
    color: var(--text-3);
    background: var(--surface-2);
    border: 1px solid var(--border);
    padding: 2px 6px;
    border-radius: 20px;
    font-family: var(--font-mono);
    margin-left: 0.25rem;
    align-self: center;
}

.header-search {
    flex: 1;
    max-width: 380px;
    margin-left: auto;
    position: relative;
}

.header-search-input {
    width: 100%;
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: var(--r);
    color: var(--text);
    font-family: var(--font-sans);
    font-size: 0.875rem;
    padding: 0.4375rem 2.5rem 0.4375rem 2.25rem;
    transition:
        border-color var(--t),
        background var(--t);
    outline: none;
}
.header-search-input::placeholder {
    color: var(--text-3);
}
.header-search-input:focus {
    border-color: var(--accent);
    background: var(--surface-2);
}

.search-icon {
    position: absolute;
    left: 0.625rem;
    top: 50%;
    transform: translateY(-50%);
    color: var(--text-3);
    pointer-events: none;
    line-height: 0;
}
.search-icon svg {
    width: 14px;
    height: 14px;
}

.search-shortcut {
    position: absolute;
    right: 0.625rem;
    top: 50%;
    transform: translateY(-50%);
    font-size: 0.6875rem;
    font-family: var(--font-mono);
    color: var(--text-3);
    background: var(--surface-3);
    border: 1px solid var(--border);
    border-radius: var(--r-sm);
    padding: 1px 5px;
    pointer-events: none;
}

.header-links {
    display: flex;
    align-items: center;
    gap: 0.25rem;
    flex-shrink: 0;
}

.header-link {
    display: flex;
    align-items: center;
    gap: 0.375rem;
    color: var(--text-2);
    font-size: 0.875rem;
    padding: 0.375rem 0.625rem;
    border-radius: var(--r);
    border: none;
    background: none;
    transition:
        color var(--t),
        background var(--t);
    text-decoration: none;
}
.header-link svg {
    width: 16px;
    height: 16px;
    flex-shrink: 0;
}
.header-link:hover {
    color: var(--text);
    background: var(--surface-2);
    text-decoration: none;
}
.header-link span {
    display: none;
}

/* Search results dropdown */
.search-results {
    position: absolute;
    top: calc(100% + 6px);
    left: 0;
    right: 0;
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: var(--r-lg);
    overflow: hidden;
    z-index: 200;
    max-height: 400px;
    overflow-y: auto;
    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.4);
    display: none;
}
.search-results.is-open {
    display: block;
}

.search-result-item {
    display: flex;
    flex-direction: column;
    gap: 0.125rem;
    padding: 0.75rem 1rem;
    border-bottom: 1px solid var(--border-2);
    cursor: pointer;
    transition: background var(--t);
    text-decoration: none;
}
.search-result-item:last-child {
    border-bottom: none;
}
.search-result-item:hover {
    background: var(--surface-2);
}

.search-result-title {
    font-size: 0.875rem;
    font-weight: 600;
    color: var(--text);
}
.search-result-desc {
    font-size: 0.8125rem;
    color: var(--text-2);
    white-space: nowrap;
    overflow: hidden;
    text-overflow: ellipsis;
}
.search-result-type {
    font-size: 0.6875rem;
    font-family: var(--font-mono);
    color: var(--text-3);
    text-transform: uppercase;
    letter-spacing: 0.04em;
}
.search-no-results {
    padding: 1.25rem 1rem;
    text-align: center;
    color: var(--text-2);
    font-size: 0.875rem;
}

/* ── Layout shell ────────────────────────────────────────────── */
.docs-layout {
    display: flex;
    min-height: 100vh;
    padding-top: var(--header-h);
}

/* ── Sidebar ─────────────────────────────────────────────────── */
.docs-sidebar {
    position: fixed;
    top: var(--header-h);
    left: 0;
    bottom: 0;
    width: var(--sidebar-w);
    background: var(--surface);
    border-right: 1px solid var(--border);
    overflow-y: auto;
    overflow-x: hidden;
    scrollbar-width: thin;
    scrollbar-color: var(--border) transparent;
    z-index: 50;
    transition: transform var(--t-slow);
    flex-shrink: 0;
}

.docs-sidebar::-webkit-scrollbar {
    width: 4px;
}
.docs-sidebar::-webkit-scrollbar-track {
    background: transparent;
}
.docs-sidebar::-webkit-scrollbar-thumb {
    background: var(--border);
    border-radius: 2px;
}

.sidebar-inner {
    padding: 1.25rem 0 2rem;
}

.sidebar-section {
    margin-bottom: 0.5rem;
    padding-bottom: 0.5rem;
    border-bottom: 1px solid var(--border-2);
}
.sidebar-section:last-child {
    border-bottom: none;
}

.sidebar-section-label {
    display: block;
    padding: 0.625rem 1.25rem 0.375rem;
    font-size: 0.6875rem;
    font-weight: 700;
    letter-spacing: 0.08em;
    text-transform: uppercase;
    color: var(--text-3);
    user-select: none;
}

.sidebar-nav-list {
    list-style: none;
    margin-left: 0.625rem;
}

.sidebar-link {
    display: flex;
    align-items: center;
    gap: 0.5rem;
    padding: 0.375rem 1.25rem;
    font-size: 0.875rem;
    color: var(--text-2);
    border-radius: 0;
    border-left: 2px solid transparent;
    text-decoration: none;
    transition:
        color var(--t),
        background var(--t),
        border-color var(--t);
    line-height: 1.4;
}
.sidebar-link:hover {
    color: var(--text);
    background: var(--surface-2);
    text-decoration: none;
}
.sidebar-link.is-active {
    color: var(--accent-2);
    background: var(--accent-bg);
    border-left-color: var(--accent);
    font-weight: 500;
}

/* Depth-2 children */
.sidebar-children {
    list-style: none;
    border-left: 1px solid var(--border);
    margin-left: 1.625rem;
    margin-top: 0.25rem;
    margin-bottom: 0.25rem;
    padding-left: 0;
}

.sidebar-child-link {
    display: block;
    padding: 0.3125rem 0.875rem 0.3125rem 0.75rem;
    font-size: 0.8125rem;
    color: var(--text-3);
    text-decoration: none;
    border-left: 2px solid transparent;
    margin-left: -1px;
    transition:
        color var(--t),
        background var(--t),
        border-color var(--t);
    line-height: 1.4;
}
.sidebar-child-link:hover {
    color: var(--text);
    text-decoration: none;
}
.sidebar-child-link.is-active {
    color: var(--accent-2);
    border-left-color: var(--accent);
    font-weight: 500;
}

/* Depth-3 grandchildren */
.sidebar-grandchildren {
    list-style: none;
    border-left: 1px solid var(--border-2);
    margin-left: 0.875rem;
}

.sidebar-grandchild-link {
    display: block;
    padding: 0.25rem 0.75rem 0.25rem 0.75rem;
    font-size: 0.8125rem;
    color: var(--text-3);
    text-decoration: none;
    border-left: 2px solid transparent;
    transition:
        color var(--t),
        border-color var(--t);
    line-height: 1.4;
}
.sidebar-grandchild-link:hover {
    color: var(--text);
    text-decoration: none;
}
.sidebar-grandchild-link.is-active {
    color: var(--accent-2);
    border-left-color: var(--accent);
}

/* ── Main content area ───────────────────────────────────────── */
.docs-main {
    flex: 1;
    margin-left: var(--sidebar-w);
    min-width: 0;
    display: flex;
}

.docs-content {
    flex: 1;
    min-width: 0;
    padding: 2.5rem 3rem 4rem;
}

/* With TOC visible: reserve space for the right-rail */
.docs-main.has-toc .docs-content {
    padding-right: calc(var(--toc-w) + 2.5rem + var(--gap));
}

/* ── Right-rail TOC ──────────────────────────────────────────── */
.docs-toc {
    position: fixed;
    top: var(--header-h);
    right: 0;
    width: var(--toc-w);
    bottom: 0;
    padding: 2rem 1.25rem 2rem 0.75rem;
    overflow-y: auto;
    scrollbar-width: thin;
    scrollbar-color: var(--border) transparent;
    display: none;
}
.docs-toc.is-visible {
    display: block;
}

.toc-label {
    font-size: 0.6875rem;
    font-weight: 700;
    letter-spacing: 0.08em;
    text-transform: uppercase;
    color: var(--text-3);
    margin-bottom: 0.625rem;
    display: block;
}

.toc-list {
    list-style: none;
    border-left: 1px solid var(--border-2);
}

/* .toc-item {
} */

.toc-link {
    display: block;
    padding: 0.25rem 0 0.25rem 0.875rem;
    font-size: 0.8125rem;
    color: var(--text-3);
    text-decoration: none;
    border-left: 2px solid transparent;
    margin-left: -1px;
    line-height: 1.4;
    transition:
        color var(--t),
        border-color var(--t);
}
.toc-link:hover {
    color: var(--text);
    text-decoration: none;
}
.toc-link.is-active {
    color: var(--accent-2);
    border-left-color: var(--accent);
}

.toc-link.toc-h3 {
    padding-left: 1.625rem;
    font-size: 0.75rem;
}

/* ── Breadcrumb ──────────────────────────────────────────────── */
.breadcrumb {
    display: flex;
    align-items: center;
    flex-wrap: wrap;
    gap: 0.25rem;
    margin-bottom: 1.5rem;
    font-size: 0.8125rem;
    color: var(--text-3);
}

.breadcrumb-link {
    color: var(--text-2);
    text-decoration: none;
    transition: color var(--t);
}
.breadcrumb-link:hover {
    color: var(--text);
    text-decoration: none;
}

.breadcrumb-sep {
    color: var(--text-3);
    margin: 0 0.125rem;
}

.breadcrumb-current {
    color: var(--text-2);
}

/* ── Page header ─────────────────────────────────────────────── */
.page-header {
    margin-bottom: 2rem;
    padding-bottom: 1.5rem;
    border-bottom: 1px solid var(--border-2);
}

.page-eyebrow {
    display: inline-block;
    font-size: 0.6875rem;
    font-weight: 700;
    letter-spacing: 0.08em;
    text-transform: uppercase;
    color: var(--accent);
    margin-bottom: 0.625rem;
}

.page-title {
    font-size: 2rem;
    font-weight: 800;
    letter-spacing: -0.03em;
    line-height: 1.2;
    color: var(--text);
    margin-bottom: 0.75rem;
}

.page-description {
    font-size: 1.0625rem;
    color: var(--text-2);
    line-height: 1.6;
    max-width: 62ch;
}

/* ── Prose (markdown rendered content) ──────────────────────── */
.prose {
    color: var(--text);
    line-height: 1.75;
}

.prose h2 {
    font-size: 1.375rem;
    font-weight: 700;
    letter-spacing: -0.02em;
    color: var(--text);
    margin: 2.5rem 0 0.875rem;
    padding-bottom: 0.5rem;
    border-bottom: 1px solid var(--border-2);
    scroll-margin-top: calc(var(--header-h) + 1.5rem);
}

.prose h3 {
    font-size: 1.0625rem;
    font-weight: 700;
    color: var(--text);
    margin: 2rem 0 0.625rem;
    scroll-margin-top: calc(var(--header-h) + 1.5rem);
}

.prose h4 {
    font-size: 0.9375rem;
    font-weight: 700;
    color: var(--text-2);
    text-transform: uppercase;
    letter-spacing: 0.04em;
    font-size: 0.75rem;
    margin: 1.5rem 0 0.5rem;
    scroll-margin-top: calc(var(--header-h) + 1.5rem);
}

.prose p {
    margin-bottom: 1rem;
}
.prose p:last-child {
    margin-bottom: 0;
}

.prose ul,
.prose ol {
    padding-left: 1.5rem;
    margin-bottom: 1rem;
}
.prose li {
    margin-bottom: 0.375rem;
}
.prose li:last-child {
    margin-bottom: 0;
}

.prose strong {
    color: var(--text);
    font-weight: 600;
}
.prose em {
    font-style: italic;
}

.prose a {
    color: var(--accent-2);
    text-decoration: underline;
    text-decoration-thickness: 1px;
    text-underline-offset: 2px;
}
.prose a:hover {
    color: var(--accent-2);
    text-decoration-thickness: 2px;
}

/* Inline code */
.prose code {
    font-family: var(--font-mono);
    font-size: 0.84em;
    background: var(--surface-2);
    color: var(--accent-2);
    padding: 0.15em 0.45em;
    border-radius: var(--r-sm);
    border: 1px solid var(--border);
}

/* Code blocks */
.prose pre {
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: var(--r-lg);
    overflow-x: auto;
    margin: 1.25rem 0;
    position: relative;
}
.prose pre code {
    display: block;
    padding: 1.125rem 1.25rem;
    font-size: 0.84375rem;
    line-height: 1.6;
    background: none;
    color: var(--text);
    border: none;
    border-radius: 0;
    overflow-x: auto;
}

/* Copy button on code blocks */
.code-block-wrapper {
    position: relative;
    isolation: isolate;
}
.code-block-wrapper:hover .copy-btn,
.copy-btn:focus {
    opacity: 1;
}

.copy-btn {
    position: absolute;
    top: 0.625rem;
    right: 0.625rem;
    background: var(--surface-2);
    border: 1px solid var(--border);
    border-radius: var(--r);
    color: var(--text-2);
    font-size: 0.75rem;
    font-family: var(--font-mono);
    padding: 0.25rem 0.625rem;
    opacity: 0;
    transition:
        opacity var(--t),
        color var(--t),
        background var(--t);
    cursor: pointer;
    line-height: 1.5;
    display: flex;
    align-items: center;
    gap: 0.375rem;
    z-index: 2;
}
.copy-btn svg {
    width: 12px;
    height: 12px;
}
.copy-btn:hover {
    color: var(--text);
    background: var(--surface-3);
}
.copy-btn.is-copied {
    color: var(--get);
    border-color: var(--get);
}

/* Code block language label */
.code-lang {
    position: absolute;
    top: 0;
    left: 0;
    right: 0;
    padding: 0.5rem 1.25rem;
    font-size: 0.6875rem;
    font-family: var(--font-mono);
    font-weight: 600;
    letter-spacing: 0.06em;
    text-transform: uppercase;
    color: var(--text-3);
    border-bottom: 1px solid var(--border-2);
    background: var(--surface-2);
    border-radius: var(--r-lg) var(--r-lg) 0 0;
    user-select: none;
    z-index: 1;
}
.has-lang pre code {
    padding-top: 0.75rem;
    margin-top: 2rem;
}

/* Tables — scrollable wrapper keeps display:table intact so columns span correctly */
.prose .table-wrap {
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
    margin: 1.25rem 0;
    border-radius: var(--r-lg);
    border: 1px solid var(--border);
}
.prose .table-wrap table {
    margin: 0;
    border: none;
    border-radius: 0;
    width: 100%;
}

.prose table {
    width: 100%;
    border-collapse: collapse;
    font-size: 0.875rem;
    margin: 1.25rem 0;
    border-radius: var(--r-lg);
    border: 1px solid var(--border);
    /* Do NOT use display:block — it breaks column spanning.
       Scrollability is handled by .table-wrap injected by theme.js */
}

.prose thead th {
    background: var(--surface);
    color: var(--text-2);
    font-weight: 600;
    font-size: 0.75rem;
    letter-spacing: 0.04em;
    text-transform: uppercase;
    padding: 0.625rem 1rem;
    text-align: left;
    border-bottom: 1px solid var(--border);
}

.prose tbody tr {
    border-bottom: 1px solid var(--border-2);
    transition: background var(--t);
}
.prose tbody tr:last-child {
    border-bottom: none;
}
.prose tbody tr:hover {
    background: var(--surface-2);
}

.prose td {
    padding: 0.625rem 1rem;
    vertical-align: top;
    color: var(--text);
}

/* Horizontal rule */
.prose hr {
    border: none;
    border-top: 1px solid var(--border-2);
    margin: 2rem 0;
}

/* Blockquote */
.prose blockquote {
    border-left: 3px solid var(--accent);
    padding: 0.75rem 1.25rem;
    margin: 1.25rem 0;
    background: var(--accent-bg);
    border-radius: 0 var(--r) var(--r) 0;
    color: var(--text-2);
    font-style: italic;
}

/* ── Callouts ────────────────────────────────────────────────── */
.callout {
    display: flex;
    gap: 0.75rem;
    padding: 0.875rem 1.125rem;
    border-radius: var(--r-lg);
    margin: 1.25rem 0;
    font-size: 0.9rem;
    line-height: 1.65;
}
.callout-icon {
    flex-shrink: 0;
    font-size: 1rem;
    line-height: 1.7;
}
.callout-body {
    flex: 1;
    min-width: 0;
}
.callout-body strong {
    display: block;
    margin-bottom: 0.25rem;
    font-size: 0.875rem;
}
.callout-body p:last-child {
    margin-bottom: 0;
}

.callout--note {
    background: var(--note-bg);
    border: 1px solid rgba(88, 166, 255, 0.2);
    color: var(--text);
}
.callout--note strong {
    color: var(--note-border);
}

.callout--tip {
    background: var(--tip-bg);
    border: 1px solid rgba(63, 185, 80, 0.2);
    color: var(--text);
}
.callout--tip strong {
    color: var(--tip-border);
}

.callout--warn {
    background: var(--warn-bg);
    border: 1px solid rgba(210, 153, 34, 0.2);
    color: var(--text);
}
.callout--warn strong {
    color: var(--warn-border);
}

/* ── Tab groups ──────────────────────────────────────────────── */
.tabs {
    margin: 1.5rem 0;
    border: 1px solid var(--border);
    border-radius: var(--r-lg);
    /* No overflow:hidden here — it clips table scroll */
}

.tab-list {
    display: flex;
    background: var(--surface);
    border-bottom: 1px solid var(--border);
    overflow-x: auto;
    scrollbar-width: none;
    -ms-overflow-style: none;
}
.tab-list::-webkit-scrollbar {
    display: none;
}

.tab-btn {
    flex-shrink: 0;
    background: none;
    border: none;
    border-bottom: 2px solid transparent;
    color: var(--text-2);
    font-size: 0.875rem;
    font-weight: 500;
    padding: 0.625rem 1.125rem;
    cursor: pointer;
    transition:
        color var(--t),
        border-color var(--t);
    white-space: nowrap;
    margin-bottom: -1px;
}
.tab-btn:hover {
    color: var(--text);
}
.tab-btn.is-active {
    color: var(--text);
    border-bottom-color: var(--accent);
}

.tab-pane {
    display: none;
    padding: 1.25rem;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
    border-radius: 0 0 var(--r-lg) var(--r-lg);
}
.tab-pane.is-active {
    display: block;
}
.tab-pane > .prose table,
.tab-pane > table {
    margin: 0;
    min-width: 480px; /* Prevents column collapse in narrow panes */
}

/* ── API endpoint cards ──────────────────────────────────────── */
.api-section {
    margin: 2.5rem 0;
}

.api-card {
    border: 1px solid var(--border);
    border-radius: var(--r-lg);
    overflow: hidden;
    margin-bottom: 1.5rem;
    transition: border-color var(--t);
}
.api-card:hover {
    border-color: var(--border);
}

.api-card-header {
    display: flex;
    align-items: center;
    flex-wrap: wrap;
    gap: 0.75rem;
    padding: 0.875rem 1.25rem;
    background: var(--surface);
    border-bottom: 1px solid var(--border);
    cursor: pointer;
    user-select: none;
}

.api-method {
    display: inline-flex;
    align-items: center;
    font-family: var(--font-mono);
    font-size: 0.75rem;
    font-weight: 700;
    letter-spacing: 0.04em;
    padding: 0.2rem 0.5rem;
    border-radius: var(--r-sm);
    flex-shrink: 0;
}
.api-method--get {
    background: var(--get-bg);
    color: var(--get);
}
.api-method--post {
    background: var(--post-bg);
    color: var(--post);
}
.api-method--put {
    background: var(--put-bg);
    color: var(--put);
}
.api-method--delete {
    background: var(--delete-bg);
    color: var(--delete);
}
.api-method--patch {
    background: var(--patch-bg);
    color: var(--patch);
}

.api-path {
    font-family: var(--font-mono);
    font-size: 0.9rem;
    color: var(--text);
    flex: 1;
}

.api-summary {
    font-size: 0.875rem;
    color: var(--text-2);
    flex-basis: 100%;
    margin-top: -0.25rem;
    padding-left: calc(40px + 0.75rem);
}

.api-expand-icon {
    color: var(--text-3);
    line-height: 0;
    transition: transform var(--t);
    margin-left: auto;
    flex-shrink: 0;
}
.api-expand-icon svg {
    width: 16px;
    height: 16px;
}
.api-card.is-open .api-expand-icon {
    transform: rotate(180deg);
}

.api-card-body {
    display: none;
    padding: 1.25rem;
    border-top: 1px solid var(--border-2);
    background: var(--bg);
}
.api-card.is-open .api-card-body {
    display: block;
}

.api-params {
    margin-bottom: 1.25rem;
}

.api-label {
    font-size: 0.6875rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.07em;
    color: var(--text-3);
    margin-bottom: 0.5rem;
    display: block;
}

/* Status badge inside API cards */
.status-badge {
    display: inline-flex;
    align-items: center;
    font-family: var(--font-mono);
    font-size: 0.75rem;
    font-weight: 600;
    padding: 0.15rem 0.45rem;
    border-radius: var(--r-sm);
    margin-right: 0.375rem;
}
.status-badge--2xx {
    background: var(--get-bg);
    color: var(--get);
}
.status-badge--4xx {
    background: var(--put-bg);
    color: var(--put);
}
.status-badge--5xx {
    background: var(--delete-bg);
    color: var(--delete);
}
.status-badge--201 {
    background: var(--post-bg);
    color: var(--post);
}

/* ── API filter bar ──────────────────────────────────────────── */
.api-filter-bar {
    display: flex;
    flex-wrap: wrap;
    gap: 0.75rem;
    align-items: center;
    margin: 1.5rem 0;
    padding: 1rem 1.25rem;
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: var(--r-lg);
    position: sticky;
    top: calc(var(--header-h) + 0.75rem);
    z-index: 30;
    box-shadow: 0 4px 16px rgba(0, 0, 0, 0.3);
}

.api-filter-input {
    flex: 1;
    min-width: 180px;
    background: var(--bg);
    border: 1px solid var(--border);
    border-radius: var(--r);
    color: var(--text);
    font-family: var(--font-sans);
    font-size: 0.875rem;
    padding: 0.4rem 2.5rem 0.4rem 0.75rem; /* right padding for the badge */
    outline: none;
    transition: border-color var(--t);
}
.api-filter-input::placeholder {
    color: var(--text-3);
}
.api-filter-input:focus {
    border-color: var(--accent);
}

/* Wrapper needed to position the ESC/clear badge */
.api-filter-input-wrap {
    position: relative;
    flex: 1;
    min-width: 180px;
    display: flex;
    align-items: center;
}
.api-filter-input-wrap .api-filter-input {
    min-width: 0;
    width: 100%;
    flex: 1;
}

/* Shared clear/ESC badge for both API filter and header search */
.input-clear-badge {
    position: absolute;
    right: 0.5rem;
    top: 50%;
    transform: translateY(-50%);
    font-size: 0.6875rem;
    font-family: var(--font-mono);
    color: var(--text-3);
    background: var(--surface-3);
    border: 1px solid var(--border);
    border-radius: var(--r-sm);
    padding: 1px 5px;
    pointer-events: none;
    user-select: none;
    transition:
        color var(--t),
        background var(--t),
        border-color var(--t),
        opacity var(--t);
    line-height: 1.6;
    white-space: nowrap;
}
/* When input has content — badge becomes a clickable × */
.input-clear-badge.is-clearable {
    pointer-events: auto;
    cursor: pointer;
    color: var(--text-2);
}
.input-clear-badge.is-clearable:hover {
    color: var(--text);
    background: var(--surface-2);
    border-color: var(--border);
}

.api-method-filters {
    display: flex;
    gap: 0.375rem;
    flex-wrap: wrap;
}

.method-filter-btn {
    background: var(--surface-2);
    border: 1px solid var(--border);
    border-radius: var(--r-sm);
    color: var(--text-2);
    font-size: 0.75rem;
    font-family: var(--font-mono);
    font-weight: 600;
    letter-spacing: 0.04em;
    padding: 0.25rem 0.625rem;
    cursor: pointer;
    transition:
        color var(--t),
        background var(--t),
        border-color var(--t);
}
.method-filter-btn:hover {
    color: var(--text);
    background: var(--surface-3);
}
.method-filter-btn.is-active {
    color: var(--accent-2);
    background: var(--accent-bg);
    border-color: var(--accent);
}
.method-filter-btn[data-method="GET"].is-active {
    color: var(--get);
    background: var(--get-bg);
    border-color: var(--get);
}
.method-filter-btn[data-method="POST"].is-active {
    color: var(--post);
    background: var(--post-bg);
    border-color: var(--post);
}
.method-filter-btn[data-method="PUT"].is-active {
    color: var(--put);
    background: var(--put-bg);
    border-color: var(--put);
}
.method-filter-btn[data-method="DELETE"].is-active {
    color: var(--delete);
    background: var(--delete-bg);
    border-color: var(--delete);
}
.method-filter-btn[data-method="PATCH"].is-active {
    color: var(--patch);
    background: var(--patch-bg);
    border-color: var(--patch);
}

.api-card--hidden {
    display: none;
}

/* ── Feature cards (landing page) ───────────────────────────── */
.feature-grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
    gap: 1rem;
    margin: 2rem 0;
}

.feature-card {
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: var(--r-lg);
    padding: 1.25rem;
    transition:
        border-color var(--t),
        background var(--t);
}
.feature-card:hover {
    border-color: var(--accent);
    background: var(--surface-2);
}

.feature-card-icon {
    width: 36px;
    height: 36px;
    border-radius: var(--r);
    background: var(--accent-bg);
    display: flex;
    align-items: center;
    justify-content: center;
    margin-bottom: 0.875rem;
}
.feature-card-icon svg {
    width: 18px;
    height: 18px;
    color: var(--accent-2);
}

.feature-card-title {
    font-size: 0.9375rem;
    font-weight: 700;
    color: var(--text);
    margin-bottom: 0.375rem;
    letter-spacing: -0.01em;
}

.feature-card-desc {
    font-size: 0.8125rem;
    color: var(--text-2);
    line-height: 1.55;
}

/* ── Quick-start / numbered steps ───────────────────────────── */
.steps {
    list-style: none;
    counter-reset: step;
    margin: 1.5rem 0;
    display: flex;
    flex-direction: column;
    gap: 1rem;
}

.step {
    display: flex;
    gap: 1rem;
    counter-increment: step;
}

.step-number {
    flex-shrink: 0;
    width: 28px;
    height: 28px;
    border-radius: 50%;
    background: var(--accent-bg);
    border: 1.5px solid var(--accent);
    color: var(--accent-2);
    font-size: 0.8125rem;
    font-weight: 700;
    display: flex;
    align-items: center;
    justify-content: center;
    margin-top: 0.1rem;
    font-family: var(--font-mono);
}

.step-body {
    flex: 1;
    min-width: 0;
}
.step-body p {
    margin-bottom: 0.375rem;
}
.step-body code {
    font-family: var(--font-mono);
    font-size: 0.84em;
    background: var(--surface-2);
    color: var(--accent-2);
    padding: 0.15em 0.45em;
    border-radius: var(--r-sm);
    border: 1px solid var(--border);
}
.step-body pre {
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: var(--r-lg);
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
    margin: 0.5rem 0 0;
    max-width: 100%;
}
.step-body pre code {
    display: block;
    padding: 0.875rem 1rem;
    font-size: 0.84375rem;
    line-height: 1.6;
    background: none;
    color: var(--text);
    border: none;
    border-radius: 0;
    overflow-x: auto;
    white-space: pre;
}

/* ── Screenshot placeholder ──────────────────────────────────── */
.screenshot-placeholder {
    width: 100%;
    aspect-ratio: 16 / 9;
    background: var(--surface);
    border: 2px dashed var(--border);
    border-radius: var(--r-lg);
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
    gap: 0.5rem;
    color: var(--text-3);
    font-size: 0.875rem;
    margin: 1.5rem 0;
}
.screenshot-placeholder svg {
    width: 32px;
    height: 32px;
    opacity: 0.5;
}
.screenshot-placeholder span {
    font-size: 0.75rem;
    font-family: var(--font-mono);
}

/* ── Inline tags / badges ────────────────────────────────────── */
.badge {
    display: inline-flex;
    align-items: center;
    font-size: 0.6875rem;
    font-weight: 600;
    font-family: var(--font-mono);
    padding: 0.15rem 0.5rem;
    border-radius: 20px;
    letter-spacing: 0.02em;
}
.badge--required {
    background: var(--delete-bg);
    color: var(--delete);
}
.badge--optional {
    background: var(--surface-2);
    color: var(--text-3);
    border: 1px solid var(--border);
}
.badge--new {
    background: var(--post-bg);
    color: var(--post);
}

/* ── Data flow diagram containers ────────────────────────────── */
.diagram-container {
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: var(--r-lg);
    padding: 1.5rem;
    margin: 1.5rem 0;
    overflow-x: auto;
}

.diagram-title {
    font-size: 0.75rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.07em;
    color: var(--text-3);
    margin-bottom: 1rem;
}

/* ── Hero (landing page) ─────────────────────────────────────── */
.hero {
    padding: 3rem 0 2.5rem;
    border-bottom: 1px solid var(--border-2);
    margin-bottom: 2.5rem;
}

.hero-eyebrow {
    display: inline-flex;
    align-items: center;
    gap: 0.5rem;
    font-size: 0.75rem;
    font-weight: 700;
    letter-spacing: 0.08em;
    text-transform: uppercase;
    color: var(--accent);
    margin-bottom: 1rem;
}

.hero-title {
    font-size: 2.75rem;
    font-weight: 900;
    letter-spacing: -0.04em;
    line-height: 1.1;
    color: var(--text);
    margin-bottom: 1rem;
}

.hero-title span {
    color: var(--accent);
}

.hero-desc, .support-callout {
    font-size: 1.125rem;
    color: var(--text-2);
    line-height: 1.65;
    max-width: 58ch;
    margin-bottom: 2rem;
}

.hero-ctas {
    display: flex;
    flex-wrap: wrap;
    gap: 0.75rem;
    align-items: center;
}

.btn {
    display: inline-flex;
    align-items: center;
    gap: 0.5rem;
    font-size: 0.9rem;
    font-weight: 600;
    padding: 0.5rem 1.125rem;
    border-radius: var(--r);
    border: none;
    cursor: pointer;
    transition:
        background var(--t),
        color var(--t),
        border-color var(--t);
    text-decoration: none;
    line-height: 1.5;
}
.btn svg {
    width: 16px;
    height: 16px;
}

.btn--primary {
    background: var(--accent);
    color: #fff;
}
.btn--primary:hover {
    background: var(--accent-2);
    color: #fff;
    text-decoration: none;
}

.btn--secondary {
    background: var(--surface);
    color: var(--text);
    border: 1px solid var(--border);
}
.btn--secondary:hover {
    background: var(--surface-2);
    color: var(--text);
    border-color: var(--text-3);
    text-decoration: none;
}

/* ── Quick-nav cards (landing page) ──────────────────────────── */
.quicknav-grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
    gap: 0.875rem;
    margin: 1.5rem 0;
}

.quicknav-card {
    display: flex;
    flex-direction: column;
    gap: 0.375rem;
    padding: 1rem 1.125rem;
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: var(--r-lg);
    text-decoration: none;
    transition:
        border-color var(--t),
        background var(--t);
}
.quicknav-card:hover {
    border-color: var(--accent);
    background: var(--surface-2);
    text-decoration: none;
}

.quicknav-label {
    font-size: 0.6875rem;
    font-weight: 700;
    letter-spacing: 0.07em;
    text-transform: uppercase;
    color: var(--accent);
}

.quicknav-title {
    font-size: 0.9375rem;
    font-weight: 700;
    color: var(--text);
    letter-spacing: -0.01em;
}

.quicknav-desc {
    font-size: 0.8125rem;
    color: var(--text-2);
    line-height: 1.5;
}

/* ── Stack layout (between sections) ────────────────────────── */
.section {
    margin-bottom: 3rem;
}
.section-title {
    font-size: 1.125rem;
    font-weight: 700;
    color: var(--text);
    letter-spacing: -0.02em;
    margin-bottom: 0.875rem;
}

/* ── Footer ──────────────────────────────────────────────────── */
.docs-footer {
    margin-left: var(--sidebar-w);
    border-top: 1px solid var(--border-2);
    padding: 1.5rem var(--gap);
    display: flex;
    align-items: center;
    justify-content: space-between;
    flex-wrap: wrap;
    gap: 0.75rem;
    color: var(--text-3);
    font-size: 0.8125rem;
}

.footer-links {
    display: flex;
    gap: 1.25rem;
}

.footer-link {
    color: var(--text-3);
    text-decoration: none;
    transition: color var(--t);
}
.footer-link:hover {
    color: var(--text-2);
    text-decoration: none;
}

/* ── Sidebar overlay (mobile) ────────────────────────────────── */
.sidebar-overlay {
    display: none;
    position: fixed;
    inset: 0;
    background: rgba(0, 0, 0, 0.6);
    z-index: 49;
    backdrop-filter: blur(2px);
}

/* ── Prev / Next page navigation ────────────────────────────── */
.doc-nav {
    display: flex;
    gap: 1rem;
    margin-top: 3rem;
    padding-top: 1.5rem;
    border-top: 1px solid var(--border-2);
}

.doc-nav-link {
    flex: 1;
    display: flex;
    flex-direction: column;
    gap: 0.25rem;
    padding: 0.875rem 1.125rem;
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: var(--r-lg);
    text-decoration: none;
    transition:
        border-color var(--t),
        background var(--t);
}
.doc-nav-link:hover {
    border-color: var(--accent);
    background: var(--surface-2);
    text-decoration: none;
}
.doc-nav-link--next {
    text-align: right;
}

.doc-nav-dir {
    font-size: 0.6875rem;
    font-weight: 700;
    letter-spacing: 0.07em;
    text-transform: uppercase;
    color: var(--text-3);
    display: flex;
    align-items: center;
    gap: 0.25rem;
}
.doc-nav-link--next .doc-nav-dir {
    justify-content: flex-end;
}
.doc-nav-dir svg {
    width: 12px;
    height: 12px;
}

.doc-nav-title {
    font-size: 0.9375rem;
    font-weight: 600;
    color: var(--text);
    letter-spacing: -0.01em;
}

/* ── Heading anchor links ────────────────────────────────────── */
.prose h2 .heading-anchor,
.prose h3 .heading-anchor {
    display: inline-flex;
    align-items: center;
    margin-left: 0.4em;
    color: var(--text-3);
    opacity: 0;
    text-decoration: none;
    vertical-align: middle;
    transition:
        opacity var(--t),
        color var(--t);
}
.prose h2:hover .heading-anchor,
.prose h3:hover .heading-anchor,
.prose h2 .heading-anchor:focus,
.prose h3 .heading-anchor:focus {
    opacity: 1;
    color: var(--accent);
}

/* ── Utilities ────────────────────────────────────────────────── */
.sr-only {
    position: absolute;
    width: 1px;
    height: 1px;
    padding: 0;
    margin: -1px;
    overflow: hidden;
    clip: rect(0, 0, 0, 0);
    white-space: nowrap;
    border-width: 0;
}

/* ── Responsive ──────────────────────────────────────────────── */
@media (max-width: 1280px) {
    .docs-toc {
        display: none !important;
    }
    .docs-main.has-toc .docs-content {
        padding-right: var(--gap);
    }
    .docs-content {
        padding: 2.5rem 2rem 4rem;
    }
}

@media (max-width: 900px) {
    .docs-sidebar {
        transform: translateX(calc(-1 * var(--sidebar-w)));
    }
    .docs-sidebar.is-open {
        transform: translateX(0);
        box-shadow: 4px 0 24px rgba(0, 0, 0, 0.4);
    }
    .docs-main {
        margin-left: 0;
    }
    .docs-footer {
        margin-left: 0;
    }
    .sidebar-overlay.is-active {
        display: block;
    }
    .header-sidebar-toggle {
        display: flex;
    }
    .docs-content {
        padding: 2rem 1.5rem 4rem;
    }

    .hero-title {
        font-size: 2rem;
    }
}

@media (max-width: 600px) {
    .header-search {
        display: none;
    }
    .doc-nav {
        flex-direction: column;
    }
    .hero-title {
        font-size: 1.75rem;
    }
    .page-title {
        font-size: 1.5rem;
    }
    .feature-grid {
        grid-template-columns: 1fr;
    }
    .docs-content {
        padding: 1.5rem 1rem 3rem;
    }
    .step {
        flex-direction: column;
        gap: 0.5rem;
    }
    .api-filter-bar {
        flex-direction: column;
        align-items: stretch;
    }
    .api-filter-input-wrap {
        min-width: 0;
        width: 100%;
    }
}

@media (max-width: 360px) {
    .header-links {
        margin-left: auto;
    }
}

@media (min-width: 360px) {
    .header-link span {
        display: inline;
    }
}

/* ── Reduced motion ──────────────────────────────────────────── */
@media (prefers-reduced-motion: reduce) {
    *,
    *::before,
    *::after {
        transition-duration: 0.01ms !important;
        animation-duration: 0.01ms !important;
    }
    html {
        scroll-behavior: auto;
    }
}