/* ===== Documentation Layout ===== */
.docs-layout {
    padding: 3rem 0;
    background: var(--bg-subtle);
    min-height: calc(100vh - 200px);
}

.docs-grid {
    display: grid;
    grid-template-columns: 280px 1fr;
    gap: 3rem;
}

/* ===== Docs Sidebar ===== */
.docs-sidebar {
    background: white;
    border: 1px solid var(--border);
    border-radius: var(--radius-lg);
    padding: 1.5rem;
    height: fit-content;
    position: sticky;
    top: 100px;
}

.sidebar-search {
    margin-bottom: 1.5rem;
}

.search-input {
    width: 100%;
    padding: 0.75rem;
    border: 1px solid var(--border);
    border-radius: var(--radius);
    font-size: 0.9375rem;
    transition: all 0.2s;
}

.search-input:focus {
    outline: none;
    border-color: var(--primary);
    box-shadow: 0 0 0 3px var(--primary-light);
}

.sidebar-section {
    margin-bottom: 2rem;
}

.sidebar-section:last-child {
    margin-bottom: 0;
}

.sidebar-section h3 {
    font-size: 0.75rem;
    font-weight: 700;
    color: var(--text-muted);
    text-transform: uppercase;
    letter-spacing: 0.05em;
    margin-bottom: 0.75rem;
}

.sidebar-section ul {
    list-style: none;
}

.sidebar-section li {
    margin-bottom: 0.25rem;
}

.sidebar-section a {
    color: var(--text-muted);
    text-decoration: none;
    font-size: 0.9375rem;
    padding: 0.5rem 0.75rem;
    display: block;
    border-radius: var(--radius);
    transition: all 0.2s;
}

.sidebar-section a:hover {
    background: var(--bg-subtle);
    color: var(--text);
}

.sidebar-section a.active {
    background: var(--primary-light);
    color: var(--text);
    font-weight: 600;
}

/* ===== Docs Content ===== */
.docs-content {
    background: white;
    border: 1px solid var(--border);
    border-radius: var(--radius-lg);
    padding: 3rem;
}

.doc-section {
    margin-bottom: 4rem;
}

.doc-section:last-child {
    margin-bottom: 0;
}

.doc-section h1 {
    font-size: 2.5rem;
    font-weight: 800;
    color: var(--text);
    margin-bottom: 1rem;
}

.doc-section h2 {
    font-size: 2rem;
    font-weight: 700;
    color: var(--text);
    margin-bottom: 1.5rem;
    margin-top: 3rem;
    padding-bottom: 0.75rem;
    border-bottom: 2px solid var(--border);
}

.doc-section h3 {
    font-size: 1.5rem;
    font-weight: 600;
    color: var(--text);
    margin-bottom: 1rem;
    margin-top: 2rem;
}

.doc-section h4 {
    font-size: 1.25rem;
    font-weight: 600;
    color: var(--text);
    margin-bottom: 0.75rem;
    margin-top: 1.5rem;
}

.doc-section p {
    color: var(--text-muted);
    margin-bottom: 1rem;
    line-height: 1.7;
}

.lead {
    font-size: 1.125rem;
    color: var(--text-muted);
    margin-bottom: 2rem;
}

/* ===== Inline Code ===== */
.doc-section code {
    color: #FFFFFF;
    padding: 0.25rem 0.5rem;
    border-radius: 4px;
    font-family: 'Monaco', 'Menlo', monospace;
    font-size: 0.875rem;
}

/* ===== Read More Link ===== */
.doc-read-more {
    margin-top: 1.5rem;
}

.read-more-link {
    color: var(--primary);
    font-weight: 600;
    text-decoration: none;
    display: inline-flex;
    align-items: center;
    gap: 0.25rem;
}

.read-more-link:hover {
    color: var(--primary-hover);
}

.alert code {
    color: #1F2937;
}

/* ===== Alerts ===== */
.alert {
    display: flex;
    gap: 1rem;
    padding: 1rem 1.5rem;
    border-radius: var(--radius);
    margin: 1.5rem 0;
    border-left: 4px solid;
}

.alert svg {
    flex-shrink: 0;
    margin-top: 0.125rem;
}

.alert-info {
    background: #DBEAFE;
    border-color: #3B82F6;
    color: #1E40AF;
}

.alert-info svg {
    stroke: #3B82F6;
}

.alert-success {
    background: #D1FAE5;
    border-color: #10B981;
    color: #065F46;
}

.alert-success svg {
    stroke: #10B981;
}

.alert-warning {
    background: #FEF3C7;
    border-color: #F59E0B;
    color: #92400E;
}

.alert-warning svg {
    stroke: #F59E0B;
}

/* ===== MVL Diagram ===== */
.mvl-diagram {
    display: flex;
    align-items: center;
    gap: 1rem;
    margin: 2rem 0;
    flex-wrap: wrap;
    justify-content: center;
}

.mvl-box {
    background: var(--bg-subtle);
    border: 2px solid var(--border);
    border-radius: var(--radius);
    padding: 1.5rem;
    text-align: center;
    min-width: 150px;
}

.mvl-box h4 {
    font-weight: 700;
    margin-bottom: 0.5rem;
    color: var(--primary);
}

.mvl-box p {
    font-size: 0.875rem;
    color: var(--text-muted);
    margin: 0;
}

.mvl-arrow {
    font-size: 1.5rem;
    color: var(--text-muted);
    font-weight: 700;
}

/* ===== Feature Grid ===== */
.feature-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
    gap: 1.5rem;
    margin: 2rem 0;
}

.feature-item {
    background: var(--bg-subtle);
    padding: 1.5rem;
    border-radius: var(--radius);
    border: 1px solid var(--border);
}

.feature-item strong {
    display: block;
    font-weight: 600;
    margin-bottom: 0.5rem;
    color: var(--text);
}

.feature-item p {
    font-size: 0.9375rem;
    color: var(--text-muted);
    margin: 0;
}

/* ===== Best Practices ===== */
.best-practice {
    background: var(--bg-subtle);
    padding: 1.5rem;
    border-radius: var(--radius);
    border-left: 4px solid var(--primary);
    margin-bottom: 1rem;
}

.best-practice h3 {
    font-size: 1.125rem;
    font-weight: 600;
    margin-bottom: 0.5rem;
    margin-top: 0;
}

.best-practice p {
    margin: 0;
    font-size: 0.9375rem;
}

/* ===== Version Info ===== */
.version-info {
    background: var(--primary-light);
    border: 1px solid var(--primary);
    border-radius: var(--radius);
    padding: 1.5rem;
    text-align: center;
    margin-top: 4rem;
}

.version-info p {
    margin-bottom: 0.5rem;
}

.version-info a {
    color: var(--primary-hover);
    text-decoration: none;
    font-weight: 600;
}

/* ===== Docs Responsive ===== */
@media (max-width: 1024px) {
    .docs-grid {
        grid-template-columns: 1fr;
    }

    .docs-sidebar {
        position: static;
    }
}

@media (max-width: 768px) {
    .docs-content {
        padding: 2rem 1rem;
    }

    .mvl-diagram {
        flex-direction: column;
    }

    .mvl-arrow {
        transform: rotate(90deg);
    }
}