/* ============================================
   YOOSH Docs Page - Two-column layout
   Sticky sidebar + scrollable content area
   ============================================ */

/* ─── Layout ──────────────────────────────────────────────────────────────── */

.docs-layout {
    display: grid;
    grid-template-columns: 260px 1fr;
    min-height: calc(100vh - var(--nav-height));
    margin-top: var(--nav-height);
    max-width: 1400px;
    margin-left: auto;
    margin-right: auto;
}

/* ─── Sidebar ─────────────────────────────────────────────────────────────── */

.docs-sidebar {
    position: sticky;
    top: var(--nav-height);
    height: calc(100vh - var(--nav-height));
    overflow-y: auto;
    border-right: 1px solid var(--border-subtle);
    background: var(--bg-void);
    scrollbar-width: thin;
    scrollbar-color: var(--border-subtle) transparent;
}

.docs-sidebar__inner {
    padding: var(--space-6) var(--space-4) var(--space-16);
}

/* Search */
.docs-sidebar__search {
    position: relative;
    margin-bottom: var(--space-6);
}

.docs-sidebar__search input {
    width: 100%;
    background: var(--bg-surface);
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-md);
    padding: var(--space-2) var(--space-3) var(--space-2) var(--space-8);
    font-family: var(--font-sans);
    font-size: var(--text-sm);
    color: var(--text-primary);
    outline: 2px solid transparent;
    outline-offset: 2px;
    transition:
        border-color var(--duration-fast) var(--ease-out),
        outline-color var(--duration-fast) var(--ease-out);
    box-sizing: border-box;
}

.docs-sidebar__search input::placeholder {
    color: var(--text-muted);
}

.docs-sidebar__search input:focus-visible {
    border-color: var(--primary);
    outline-color: rgba(167, 139, 250, 0.72);
}

.docs-sidebar__search-icon {
    position: absolute;
    left: 10px;
    top: 50%;
    transform: translateY(-50%);
    color: var(--text-muted);
    pointer-events: none;
}

/* Nav groups */
.docs-nav__group {
    margin-bottom: var(--space-6);
}

.docs-nav__group-label {
    font-size: 10px;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.1em;
    color: var(--text-muted);
    padding: 0 var(--space-3);
    margin-bottom: var(--space-2);
}

.docs-nav__link {
    display: flex;
    align-items: center;
    gap: var(--space-2);
    padding: var(--space-2) var(--space-3);
    border-radius: var(--radius-sm);
    font-size: var(--text-sm);
    color: var(--text-secondary);
    text-decoration: none;
    transition:
        background var(--duration-fast) var(--ease-out),
        color var(--duration-fast) var(--ease-out);
    cursor: pointer;
    border: none;
    background: none;
    width: 100%;
    text-align: left;
}

.docs-nav__link:hover {
    color: var(--text-primary);
    background: rgba(255, 255, 255, 0.04);
}

.docs-nav__link.active {
    color: var(--primary-glow);
    background: rgba(139, 92, 246, 0.1);
    font-weight: 500;
}

.docs-nav__link .docs-nav__badge {
    margin-left: auto;
    font-size: 9px;
    padding: 1px 5px;
    border-radius: 999px;
    background: rgba(6, 214, 160, 0.15);
    color: var(--secondary);
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.05em;
}

/* ─── Main content ────────────────────────────────────────────────────────── */

.docs-main {
    padding: var(--space-12) var(--space-12) var(--space-24);
    max-width: 860px;
}

.docs-content-section {
    padding-bottom: var(--space-16);
    border-bottom: 1px solid var(--border-subtle);
    margin-bottom: var(--space-16);
    scroll-margin-top: calc(var(--nav-height) + var(--space-6));
}

.docs-content-section:last-child {
    border-bottom: none;
}

/* Section headings */
.docs-section-label {
    display: inline-flex;
    align-items: center;
    gap: var(--space-2);
    font-size: 10px;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.1em;
    color: var(--text-muted);
    margin-bottom: var(--space-3);
}

.docs-h1 {
    font-family: var(--font-display);
    font-size: var(--text-4xl);
    font-weight: 800;
    letter-spacing: -0.02em;
    line-height: var(--leading-tight);
    margin-bottom: var(--space-4);
}

.docs-h2 {
    font-family: var(--font-display);
    font-size: var(--text-2xl);
    font-weight: 700;
    margin-bottom: var(--space-4);
    margin-top: var(--space-10);
}

.docs-h2:first-child {
    margin-top: 0;
}

.docs-h3 {
    font-size: var(--text-lg);
    font-weight: 600;
    margin-bottom: var(--space-3);
    margin-top: var(--space-8);
    color: var(--text-primary);
}

.docs-p {
    font-size: var(--text-base);
    color: var(--text-secondary);
    line-height: var(--leading-relaxed);
    margin-bottom: var(--space-4);
}

.docs-p code,
.docs-p-sm code {
    font-family: var(--font-mono);
    font-size: 0.85em;
    background: var(--bg-surface);
    border: 1px solid var(--border-subtle);
    padding: 1px 5px;
    border-radius: 4px;
    color: var(--secondary);
}

.docs-p-sm {
    font-size: var(--text-sm);
    color: var(--text-secondary);
    line-height: var(--leading-relaxed);
    margin-bottom: var(--space-3);
}

/* Callout boxes */
.docs-callout {
    display: flex;
    gap: var(--space-3);
    padding: var(--space-4) var(--space-5);
    border-radius: var(--radius-md);
    margin: var(--space-6) 0;
    font-size: var(--text-sm);
    line-height: var(--leading-relaxed);
}

.docs-callout--info {
    background: rgba(139, 92, 246, 0.08);
    border: 1px solid rgba(139, 92, 246, 0.2);
    color: var(--text-secondary);
}

.docs-callout--tip {
    background: rgba(6, 214, 160, 0.06);
    border: 1px solid rgba(6, 214, 160, 0.2);
    color: var(--text-secondary);
}

.docs-callout--warn {
    background: rgba(245, 158, 11, 0.07);
    border: 1px solid rgba(245, 158, 11, 0.2);
    color: var(--text-secondary);
}

.docs-callout__icon {
    flex-shrink: 0;
    margin-top: 1px;
}

/* Steps */
.docs-steps {
    display: flex;
    flex-direction: column;
    gap: 0;
    margin: var(--space-6) 0;
    position: relative;
}

.docs-steps::before {
    content: '';
    position: absolute;
    left: 19px;
    top: 24px;
    bottom: 24px;
    width: 1px;
    background: var(--border-subtle);
}

.docs-step {
    display: grid;
    grid-template-columns: 40px 1fr;
    gap: var(--space-4);
    padding-bottom: var(--space-6);
    position: relative;
}

.docs-step:last-child {
    padding-bottom: 0;
}

.docs-step__num {
    width: 40px;
    height: 40px;
    border-radius: 50%;
    background: var(--bg-surface);
    border: 2px solid var(--primary);
    display: flex;
    align-items: center;
    justify-content: center;
    font-family: var(--font-display);
    font-size: var(--text-sm);
    font-weight: 700;
    color: var(--primary-glow);
    flex-shrink: 0;
    position: relative;
    z-index: 1;
}

.docs-step__body h4 {
    font-size: var(--text-base);
    font-weight: 600;
    margin-bottom: var(--space-1);
    padding-top: 8px;
}

.docs-step__body p {
    font-size: var(--text-sm);
    color: var(--text-secondary);
    line-height: var(--leading-relaxed);
    margin-bottom: var(--space-3);
}

/* Inline code endpoint pill */
.docs-endpoint {
    display: inline-flex;
    align-items: center;
    gap: var(--space-2);
    background: var(--bg-surface);
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-md);
    padding: var(--space-2) var(--space-4);
    margin: var(--space-3) 0;
    font-family: var(--font-mono);
    font-size: var(--text-sm);
}

.docs-endpoint__method {
    font-weight: 700;
    font-size: var(--text-xs);
    padding: 2px 6px;
    border-radius: 4px;
}

.docs-endpoint__method--post { background: rgba(139,92,246,0.2); color: var(--primary-glow); }
.docs-endpoint__method--get  { background: rgba(6,214,160,0.15); color: var(--secondary); }

.docs-endpoint__path {
    color: var(--text-primary);
}

/* Parameter table */
.docs-params {
    width: 100%;
    border-collapse: separate;
    border-spacing: 0;
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-md);
    overflow: hidden;
    margin: var(--space-4) 0 var(--space-6);
    font-size: var(--text-sm);
}

.docs-params th {
    padding: var(--space-2) var(--space-4);
    text-align: left;
    font-size: 10px;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--text-muted);
    background: var(--bg-surface);
    border-bottom: 1px solid var(--border-subtle);
}

.docs-params td {
    padding: var(--space-3) var(--space-4);
    border-bottom: 1px solid var(--border-subtle);
    vertical-align: top;
    line-height: var(--leading-relaxed);
}

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

.docs-params td:first-child {
    font-family: var(--font-mono);
    font-size: var(--text-xs);
    color: var(--secondary);
    white-space: nowrap;
}

.docs-params td:nth-child(2) {
    font-size: var(--text-xs);
    color: var(--accent-warm);
    white-space: nowrap;
}

.docs-params td:nth-child(3) {
    color: var(--text-secondary);
    font-size: var(--text-xs);
}

/* Models table */
.models-table {
    width: 100%;
    border-collapse: separate;
    border-spacing: 0;
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-lg);
    overflow: hidden;
    font-size: var(--text-sm);
}

.models-table th {
    padding: var(--space-3) var(--space-4);
    text-align: left;
    font-size: 10px;
    font-weight: 700;
    color: var(--text-muted);
    text-transform: uppercase;
    letter-spacing: 0.08em;
    background: var(--bg-surface);
    border-bottom: 1px solid var(--border-subtle);
}

.models-table td {
    padding: var(--space-3) var(--space-4);
    border-bottom: 1px solid var(--border-subtle);
    color: var(--text-primary);
}

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

.models-table tbody tr:hover td {
    background: rgba(255,255,255,0.02);
}

.models-table code {
    font-size: var(--text-xs);
    background: var(--bg-surface);
    padding: 2px 6px;
    border-radius: 4px;
    color: var(--secondary);
}

/* Error grid */
.error-grid {
    display: grid;
    grid-template-columns: repeat(2, 1fr);
    gap: var(--space-3);
    margin-top: var(--space-4);
}

.error-card {
    padding: var(--space-4) var(--space-5);
    background: var(--bg-surface);
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-md);
    transition: border-color var(--duration-fast) var(--ease-out);
}

.error-card:hover {
    border-color: var(--border-medium);
}

.error-card__code {
    font-family: var(--font-mono);
    font-size: var(--text-sm);
    font-weight: 700;
    color: var(--accent-warm);
    margin-bottom: var(--space-1);
}

.error-card__title {
    font-size: var(--text-sm);
    font-weight: 600;
    color: var(--text-primary);
    margin-bottom: var(--space-2);
}

.error-card__desc {
    font-size: var(--text-xs);
    color: var(--text-secondary);
    line-height: var(--leading-relaxed);
}

/* Code tabs */
.code-tabs {
    display: flex;
    gap: var(--space-1);
    margin-bottom: 0;
}

.code-tab {
    padding: var(--space-2) var(--space-4);
    background: var(--bg-surface);
    border: 1px solid var(--border-subtle);
    border-bottom: none;
    border-radius: var(--radius-sm) var(--radius-sm) 0 0;
    font-family: var(--font-mono);
    font-size: var(--text-xs);
    color: var(--text-muted);
    cursor: pointer;
    transition:
        background var(--duration-fast) var(--ease-out),
        border-color var(--duration-fast) var(--ease-out),
        color var(--duration-fast) var(--ease-out);
}

.code-tab:hover { color: var(--text-primary); }

.code-tab--active {
    background: var(--bg-obsidian);
    color: var(--primary-glow);
    border-color: var(--border-primary);
}

.code-tab-panel { display: none; }
.code-tab-panel--active { display: block; }
.code-tab-panel .code-block {
    border-radius: 0 var(--radius-lg) var(--radius-lg) var(--radius-lg);
}

/* Search highlight */
.docs-nav__link.search-hidden {
    display: none;
}

/* ─── Responsive ──────────────────────────────────────────────────────────── */

@media (max-width: 1024px) {
    .docs-layout {
        grid-template-columns: 220px 1fr;
    }
    .docs-main {
        padding: var(--space-8) var(--space-8) var(--space-16);
    }
}

@media (max-width: 768px) {
    .docs-layout {
        grid-template-columns: 1fr;
    }
    .docs-sidebar {
        position: static;
        height: auto;
        border-right: none;
        border-bottom: 1px solid var(--border-subtle);
    }
    .docs-main {
        padding: var(--space-6) var(--space-4) var(--space-12);
    }
    .error-grid {
        grid-template-columns: 1fr;
    }
    .docs-params,
    .models-table {
        display: block;
        max-width: 100%;
        overflow-x: auto;
        -webkit-overflow-scrolling: touch;
    }
    .docs-h1 {
        font-size: var(--text-3xl);
    }
}