.docs-shell {
    max-width: 1280px;
    margin: 0 auto;
    padding: 2rem 1rem 4rem;
    color: var(--color-text-primary);
}

.docs-hero {
    display: grid;
    grid-template-columns: minmax(0, 1fr) auto;
    gap: 2rem;
    align-items: end;
    padding: 2rem 0 1.5rem;
    border-bottom: 1px solid var(--color-border);
}

.docs-kicker {
    color: var(--color-text-secondary);
    font-weight: 600;
    margin: 0 0 0.5rem;
}

.docs-hero h1 {
    margin: 0;
    font-size: 2.5rem;
    line-height: 1.1;
    color: var(--color-text-primary);
}

.docs-hero-copy {
    max-width: 760px;
    color: var(--color-text-secondary);
    line-height: 1.65;
    margin: 1rem 0 0;
}

.docs-quick-actions {
    display: flex;
    gap: 0.75rem;
    flex-wrap: wrap;
    justify-content: flex-end;
}

.docs-layout {
    display: grid;
    grid-template-columns: 260px minmax(0, 1fr);
    gap: 2rem;
    margin-top: 2rem;
}

.docs-index {
    position: sticky;
    top: 1rem;
    align-self: start;
    background: var(--color-bg-content);
    border: 1px solid var(--color-border);
    border-radius: 8px;
    padding: 1rem;
}

.docs-search-label {
    display: block;
    color: var(--color-text-secondary);
    font-size: 0.85rem;
    font-weight: 600;
    margin-bottom: 0.5rem;
}

.docs-search {
    width: 100%;
    background: var(--color-bg-content);
    border: 1px solid var(--color-border);
    border-radius: 6px;
    color: var(--color-text-primary);
    padding: 0.65rem 0.75rem;
    margin-bottom: 1rem;
    box-sizing: border-box;
}

.docs-index nav {
    display: grid;
    gap: 0.25rem;
}

.docs-index a {
    display: block;
    color: var(--color-text-secondary);
    text-decoration: none;
    border-radius: 6px;
    padding: 0.55rem 0.65rem;
    font-size: 0.9rem;
    transition: background 0.15s, color 0.15s;
}

.docs-index a:hover,
.docs-index a.active {
    background: var(--color-bg-secondary, rgba(99,102,241,0.08));
    color: var(--color-text-primary);
}

.docs-content {
    display: flex;
    flex-direction: column;
    gap: 1rem;
}

.docs-section {
    background: var(--color-bg-content);
    border: 1px solid var(--color-border);
    border-radius: 8px;
    padding: 1.5rem;
    scroll-margin-top: 1.5rem;
}

.docs-section h2 {
    color: var(--color-text-primary);
    margin: 0 0 0.75rem;
    display: flex;
    align-items: center;
    gap: 0.75rem;
    font-size: 1.25rem;
}

.docs-section p,
.docs-section li {
    color: var(--color-text-secondary);
    line-height: 1.65;
    margin: 0.4rem 0;
}

.docs-section ul,
.docs-section ol {
    padding-left: 1.5rem;
    margin: 0.5rem 0;
}

.docs-section a {
    color: var(--color-accent, #6366f1);
    text-decoration: none;
}

.docs-section a:hover {
    text-decoration: underline;
}

.docs-grid {
    display: grid;
    grid-template-columns: repeat(2, minmax(0, 1fr));
    gap: 1rem;
    margin-top: 1rem;
}

.docs-card {
    background: var(--color-bg-secondary, rgba(99,102,241,0.04));
    border: 1px solid var(--color-border);
    border-radius: 8px;
    padding: 1rem;
}

.docs-card h3 {
    color: var(--color-text-primary);
    margin: 0 0 0.5rem;
    font-size: 0.95rem;
    font-weight: 600;
}

.docs-card p {
    margin: 0;
    font-size: 0.88rem;
}

.docs-code {
    display: inline-block;
    background: var(--color-bg-secondary, rgba(99,102,241,0.08));
    border: 1px solid var(--color-border);
    border-radius: 6px;
    color: var(--color-text-primary);
    font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
    font-size: 0.82rem;
    padding: 0.15rem 0.4rem;
}

.docs-copy-link {
    display: inline-block;
    margin-left: auto;
    background: none;
    border: 1px solid var(--color-border);
    border-radius: 5px;
    color: var(--color-text-secondary);
    cursor: pointer;
    font-size: 0.75rem;
    padding: 0.2rem 0.55rem;
    transition: background 0.15s, color 0.15s;
}

.docs-copy-link:hover {
    background: var(--color-bg-secondary, rgba(99,102,241,0.08));
    color: var(--color-text-primary);
}

/* Light-mode overrides for dark-first components */
:root:not([data-theme="dark"]) .docs-index {
    background: #ffffff;
    border-color: #e5e7eb;
}

:root:not([data-theme="dark"]) .docs-section {
    background: #ffffff;
    border-color: #e5e7eb;
}

:root:not([data-theme="dark"]) .docs-card {
    background: #f9fafb;
    border-color: #e5e7eb;
}

:root:not([data-theme="dark"]) .docs-search {
    background: #ffffff;
    border-color: #d1d5db;
    color: #1f2937;
}

:root:not([data-theme="dark"]) .docs-code {
    background: #f3f4f6;
    border-color: #d1d5db;
    color: #1f2937;
}

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

    .docs-quick-actions {
        justify-content: flex-start;
    }

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

    .docs-index {
        position: static;
    }

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

    .docs-hero h1 {
        font-size: 1.9rem;
    }
}