/* ===================================================================
   Meridian Blue — Documentation Pages
   3-column layout: left sidebar | centered content | right TOC
   =================================================================== */

/* --- 3-Column Layout Shell --- */
.docs-layout {
    display: grid;
    grid-template-columns: 240px 1fr 220px;
    grid-template-rows: auto 1fr;
    min-height: calc(100vh - 64px);
}

/* Mobile toggle spans full width */
.docs-mobile-toggle {
    display: none;
    grid-column: 1 / -1;
}

/* --- Left Sidebar (article nav) --- */
.docs-sidebar {
    grid-row: 1 / -1;
    position: sticky;
    top: 64px;
    height: calc(100vh - 64px);
    overflow-y: auto;
    border-right: 1px solid var(--border);
    padding: 1.75rem 0;
    background: var(--bg);
    scrollbar-width: thin;
    scrollbar-color: var(--gray-200) transparent;
}

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

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

.docs-sidebar-label {
    font-family: var(--font-display);
    font-size: 0.6875rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.1em;
    color: var(--gray-400);
    margin-bottom: 0.75rem;
    padding-left: 0.75rem;
}

.docs-sidebar-group + .docs-sidebar-group {
    margin-top: 1.75rem;
}

.docs-sidebar-nav {
    list-style: none;
    display: flex;
    flex-direction: column;
    gap: 2px;
}

.docs-sidebar-nav a {
    display: flex;
    align-items: center;
    gap: 0.625rem;
    padding: 0.5rem 0.75rem;
    font-size: 0.875rem;
    font-weight: 500;
    color: var(--text-secondary);
    border-radius: 6px;
    transition: color var(--duration), background var(--duration);
}

.docs-sidebar-nav a svg {
    flex-shrink: 0;
    opacity: 0.5;
    transition: opacity var(--duration);
}

.docs-sidebar-nav a:hover {
    color: var(--text-primary);
    background: var(--gray-50);
}

.docs-sidebar-nav a:hover svg {
    opacity: 0.8;
}

.docs-sidebar-nav a.active {
    color: var(--blue-500);
    background: var(--blue-50);
    font-weight: 600;
}

.docs-sidebar-nav a.active svg {
    opacity: 1;
    color: var(--blue-500);
}

/* --- Main Content Area (center column) --- */
.docs-main {
    min-width: 0;
    padding: 2.5rem clamp(2rem, 4vw, 3rem) 4rem;
}

/* --- Hero --- */
.docs-hero {
    margin-bottom: 3rem;
    padding-bottom: 2rem;
    border-bottom: 1px solid var(--border);
}

.docs-hero-badge {
    display: inline-flex;
    align-items: center;
    gap: 0.5rem;
    padding: 0.3rem 0.875rem 0.3rem 0.5rem;
    background: var(--blue-50);
    border: 1px solid var(--blue-200);
    border-radius: 100px;
    font-size: 0.75rem;
    font-weight: 600;
    color: var(--blue-700);
    text-transform: uppercase;
    letter-spacing: 0.06em;
    margin-bottom: 1.25rem;
}

.docs-hero h1 {
    font-family: var(--font-display);
    font-size: clamp(1.75rem, 3.5vw, 2.25rem);
    font-weight: 800;
    color: var(--text-primary);
    letter-spacing: -0.02em;
    line-height: 1.2;
    margin-bottom: 0.75rem;
}

.docs-hero p {
    font-size: 1rem;
    color: var(--text-secondary);
    line-height: 1.65;
    max-width: 620px;
}

/* --- Per-article TOC (right column of top-level grid) --- */
.docs-toc {
    position: sticky;
    top: 84px;
    height: calc(100vh - 84px);
    overflow-y: auto;
    padding: 2.5rem 1.25rem 2rem 0;
    scrollbar-width: thin;
    scrollbar-color: var(--gray-200) transparent;
}

.docs-toc-title {
    font-family: var(--font-display);
    font-size: 0.6875rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.1em;
    color: var(--gray-400);
    margin-bottom: 0.875rem;
}

.docs-toc-list {
    list-style: none;
    display: flex;
    flex-direction: column;
    gap: 1px;
    border-left: 1px solid var(--gray-200);
}

.docs-toc-list a {
    display: block;
    padding: 0.325rem 0 0.325rem 0.75rem;
    font-size: 0.75rem;
    font-weight: 450;
    color: var(--gray-400);
    transition: color var(--duration), border-color var(--duration);
    margin-left: -1px;
    border-left: 2px solid transparent;
}

.docs-toc-list a:hover {
    color: var(--text-primary);
}

.docs-toc-list a.active {
    color: var(--blue-500);
    border-left-color: var(--blue-500);
    font-weight: 500;
}

.docs-toc-list .toc-sub {
    padding-left: 1.375rem;
    font-size: 0.6875rem;
}

/* --- Sections --- */
.docs-section {
    margin-bottom: 3rem;
    scroll-margin-top: 80px;
}

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

.docs-section h2 {
    font-family: var(--font-display);
    font-size: 1.5rem;
    font-weight: 700;
    color: var(--text-primary);
    letter-spacing: -0.01em;
    margin-bottom: 0.75rem;
    padding-bottom: 0.75rem;
    border-bottom: 1px solid var(--border);
}

.docs-section h3 {
    font-family: var(--font-display);
    font-size: 1.125rem;
    font-weight: 600;
    color: var(--text-primary);
    margin-top: 2rem;
    margin-bottom: 0.625rem;
    scroll-margin-top: 80px;
}

.docs-section h4 {
    font-size: 0.9375rem;
    font-weight: 600;
    color: var(--text-primary);
    margin-top: 1.5rem;
    margin-bottom: 0.5rem;
}

.docs-section p {
    font-size: 0.9375rem;
    color: var(--text-secondary);
    line-height: 1.7;
    margin-bottom: 1rem;
}

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

.docs-section ul,
.docs-section ol {
    padding-left: 1.25rem;
    margin-bottom: 1rem;
}

.docs-section li {
    font-size: 0.9375rem;
    color: var(--text-secondary);
    line-height: 1.7;
    margin-bottom: 0.375rem;
}

.docs-section li strong {
    color: var(--text-primary);
    font-weight: 600;
}

/* --- Inline Code --- */
.docs-section code,
.docs-next code {
    font-family: 'SF Mono', 'Fira Code', 'Cascadia Code', monospace;
    font-size: 0.8125rem;
    background: var(--gray-100);
    border: 1px solid var(--gray-200);
    border-radius: 4px;
    padding: 0.15em 0.4em;
    color: var(--blue-700);
}

/* --- Code Blocks --- */
.docs-code {
    background: var(--gray-900);
    border-radius: 10px;
    overflow: hidden;
    margin: 1rem 0 1.25rem;
    box-shadow: 0 4px 16px hsl(var(--shadow-color) / 0.1),
                0 0 0 1px hsl(var(--shadow-color) / 0.04);
}

.docs-code-header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    padding: 0.625rem 1rem;
    border-bottom: 1px solid rgba(255, 255, 255, 0.08);
}

.docs-code-lang {
    font-family: 'SF Mono', 'Fira Code', monospace;
    font-size: 0.6875rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: rgba(255, 255, 255, 0.35);
}

.docs-code-copy {
    background: none;
    border: 1px solid rgba(255, 255, 255, 0.12);
    border-radius: 4px;
    padding: 0.25rem 0.5rem;
    font-family: var(--font-sans);
    font-size: 0.6875rem;
    font-weight: 500;
    color: rgba(255, 255, 255, 0.5);
    cursor: pointer;
    transition: color var(--duration), border-color var(--duration);
}

.docs-code-copy:hover {
    color: rgba(255, 255, 255, 0.8);
    border-color: rgba(255, 255, 255, 0.25);
}

.docs-code pre {
    padding: 1.25rem;
    margin: 0;
    overflow-x: auto;
    font-family: 'SF Mono', 'Fira Code', 'Cascadia Code', monospace;
    font-size: 0.8125rem;
    line-height: 1.7;
    color: #E2E8F0;
}

.docs-code pre code {
    background: none;
    border: none;
    padding: 0;
    border-radius: 0;
    color: inherit;
    font-size: inherit;
}

/* Code token colors */
.tok-kw { color: #C084FC; }
.tok-str { color: #6EE7B7; }
.tok-fn { color: #7DD3FC; }
.tok-cm { color: rgba(255, 255, 255, 0.35); font-style: italic; }
.tok-num { color: #FCA5A5; }
.tok-var { color: #FDE68A; }

/* --- Tables --- */
.docs-table-wrap {
    overflow-x: auto;
    margin: 1rem 0 1.25rem;
    border: 1px solid var(--border);
    border-radius: 8px;
}

.docs-table {
    width: 100%;
    border-collapse: collapse;
    font-size: 0.875rem;
}

.docs-table th {
    text-align: left;
    padding: 0.75rem 1rem;
    background: var(--gray-50);
    border-bottom: 1px solid var(--border);
    font-weight: 600;
    color: var(--text-primary);
    white-space: nowrap;
}

.docs-table td {
    padding: 0.75rem 1rem;
    border-bottom: 1px solid var(--gray-100);
    color: var(--text-secondary);
}

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

.docs-table code {
    font-size: 0.8125rem;
}

/* --- Callout / Note --- */
.docs-note {
    display: flex;
    gap: 0.75rem;
    padding: 1rem 1.25rem;
    background: var(--blue-50);
    border: 1px solid var(--blue-200);
    border-radius: 8px;
    margin: 1.25rem 0;
}

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

.docs-note p {
    font-size: 0.875rem;
    color: var(--blue-700);
    margin: 0;
    line-height: 1.6;
}

/* Pro-tip variant (green) */
.docs-note.tip {
    background: #ECFDF5;
    border-color: #A7F3D0;
}

.docs-note.tip p { color: #047857; }
.docs-note.tip .docs-note-icon svg circle { stroke: #047857; }
.docs-note.tip .docs-note-icon svg path { stroke: #047857; }

/* --- Status code list --- */
.docs-status-list {
    list-style: none;
    padding: 0;
    margin: 1rem 0;
    display: flex;
    flex-direction: column;
    gap: 0.75rem;
}

.docs-status-list li {
    display: flex;
    align-items: flex-start;
    gap: 0.75rem;
    padding: 0.875rem 1rem;
    background: var(--bg);
    border: 1px solid var(--border);
    border-radius: 8px;
}

.docs-status-code {
    flex-shrink: 0;
    display: inline-flex;
    align-items: center;
    padding: 0.2rem 0.5rem;
    border-radius: 4px;
    font-family: 'SF Mono', 'Fira Code', monospace;
    font-size: 0.8125rem;
    font-weight: 700;
    min-width: 36px;
    justify-content: center;
}

.docs-status-code.green { background: #ECFDF5; color: #047857; border: 1px solid #A7F3D0; }
.docs-status-code.yellow { background: #FFFBEB; color: #B45309; border: 1px solid #FDE68A; }
.docs-status-code.red { background: #FEF2F2; color: #B91C1C; border: 1px solid #FECACA; }

.docs-status-list .status-desc {
    font-size: 0.875rem;
    color: var(--text-secondary);
    line-height: 1.6;
    margin: 0;
}

.docs-status-list .status-desc strong {
    color: var(--text-primary);
}

/* --- System Prompt Blockquote --- */
.docs-prompt {
    margin: 1rem 0 1.25rem;
    padding: 1.25rem 1.5rem;
    background: var(--gray-50);
    border-left: 3px solid var(--blue-500);
    border-radius: 0 8px 8px 0;
    font-size: 0.875rem;
    font-style: italic;
    color: var(--text-secondary);
    line-height: 1.7;
}

/* --- Flow Diagram (Teams page) --- */
.docs-flow {
    display: flex;
    flex-direction: column;
    gap: 0;
    margin: 1.5rem 0;
}

.docs-flow-step {
    display: flex;
    align-items: flex-start;
    gap: 1rem;
    padding: 1rem 1.25rem;
    background: var(--bg);
    border: 1px solid var(--border);
    border-radius: 10px;
    transition: border-color var(--duration);
}

.docs-flow-step:hover {
    border-color: var(--blue-200);
}

.docs-flow-num {
    flex-shrink: 0;
    width: 28px;
    height: 28px;
    display: flex;
    align-items: center;
    justify-content: center;
    background: var(--blue-50);
    color: var(--blue-500);
    font-family: var(--font-display);
    font-size: 0.8125rem;
    font-weight: 700;
    border-radius: 50%;
}

.docs-flow-step strong {
    display: block;
    font-size: 0.875rem;
    color: var(--text-primary);
    margin-bottom: 0.125rem;
}

.docs-flow-step p {
    font-size: 0.8125rem;
    color: var(--text-secondary);
    margin: 0;
    line-height: 1.5;
}

.docs-flow-connector {
    width: 2px;
    height: 16px;
    background: var(--gray-200);
    margin-left: 2.35rem;
}

/* --- Next Steps Section --- */
.docs-next {
    margin-top: 3rem;
    padding: 2rem;
    background: linear-gradient(135deg, var(--blue-50) 0%, #F0F4FF 50%, var(--blue-100) 100%);
    border: 1px solid var(--blue-200);
    border-radius: 12px;
}

.docs-next h3 {
    font-family: var(--font-display);
    font-weight: 700;
    color: var(--text-primary);
    margin: 0 0 0.5rem;
}

.docs-next ul {
    list-style: none;
    padding: 0;
    margin: 0;
    display: flex;
    flex-direction: column;
    gap: 0.5rem;
}

.docs-next li {
    font-size: 0.9375rem;
    color: var(--text-secondary);
    padding-left: 1.25rem;
    position: relative;
}

.docs-next li::before {
    content: '';
    position: absolute;
    left: 0;
    top: 0.5em;
    width: 6px;
    height: 6px;
    border-radius: 50%;
    background: var(--blue-500);
}

.docs-next a {
    color: var(--blue-500);
    font-weight: 600;
    transition: color var(--duration);
}

.docs-next a:hover {
    color: var(--blue-700);
}

/* --- Mobile Sidebar Toggle --- */
.docs-mobile-toggle {
    display: none;
    position: sticky;
    top: 64px;
    z-index: 50;
    width: 100%;
    padding: 0.75rem var(--container-px);
    background: var(--bg);
    border: none;
    border-bottom: 1px solid var(--border);
    font-family: var(--font-sans);
    font-size: 0.875rem;
    font-weight: 600;
    color: var(--text-primary);
    cursor: pointer;
    text-align: left;
    align-items: center;
    gap: 0.5rem;
}

.docs-mobile-toggle svg {
    transition: transform var(--duration) var(--ease-out);
}

.docs-mobile-toggle.open svg {
    transform: rotate(180deg);
}

/* --- Responsive --- */

/* Tablet: hide right TOC, keep left sidebar */
@media (max-width: 1100px) {
    .docs-layout {
        grid-template-columns: 240px 1fr;
    }

    .docs-toc {
        display: none;
    }
}

/* Mobile: collapse left sidebar too */
@media (max-width: 768px) {
    .docs-layout {
        grid-template-columns: 1fr;
    }

    .docs-sidebar {
        position: fixed;
        top: calc(64px + 44px);
        left: 0;
        right: 0;
        height: auto;
        max-height: calc(100vh - 64px - 44px);
        border-right: none;
        border-bottom: 1px solid var(--border);
        z-index: 40;
        transform: translateY(-100%);
        opacity: 0;
        visibility: hidden;
        transition: transform 0.3s var(--ease-out),
                    opacity 0.3s var(--ease-out),
                    visibility 0.3s;
        box-shadow: 0 8px 24px hsl(var(--shadow-color) / 0.1);
        grid-row: auto;
    }

    .docs-sidebar.open {
        transform: translateY(0);
        opacity: 1;
        visibility: visible;
    }

    .docs-mobile-toggle {
        display: flex;
    }

    .docs-main {
        padding: 2rem var(--container-px) 3rem;
    }
}

@media (max-width: 480px) {
    .docs-hero h1 { font-size: 1.5rem; }
    .docs-section h2 { font-size: 1.25rem; }
    .docs-code pre { font-size: 0.75rem; }

    .docs-status-list li {
        flex-direction: column;
        gap: 0.375rem;
    }

    .docs-flow-step {
        flex-direction: column;
        gap: 0.5rem;
    }
}

/* --- Prev / Next pager --- */
.docs-pager {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 1rem;
    margin-top: 4rem;
    padding-top: 2rem;
    border-top: 1px solid var(--border);
}

.docs-pager-link {
    display: flex;
    flex-direction: column;
    gap: 0.25rem;
    padding: 1rem 1.25rem;
    border: 1px solid var(--border);
    border-radius: 10px;
    background: var(--bg);
    text-decoration: none;
    transition: border-color var(--duration), background var(--duration), transform var(--duration);
}

.docs-pager-link:hover {
    border-color: var(--blue-300);
    background: var(--blue-50);
    transform: translateY(-1px);
}

.docs-pager-prev {
    grid-column: 1;
    align-items: flex-start;
    text-align: left;
}

.docs-pager-next {
    grid-column: 2;
    align-items: flex-end;
    text-align: right;
}

.docs-pager-dir {
    font-size: 0.75rem;
    font-weight: 600;
    color: var(--gray-400);
    text-transform: uppercase;
    letter-spacing: 0.05em;
}

.docs-pager-link:hover .docs-pager-dir {
    color: var(--blue-500);
}

.docs-pager-label {
    font-size: 0.9375rem;
    font-weight: 600;
    color: var(--text-primary);
}

@media (max-width: 768px) {
    .docs-pager {
        grid-template-columns: 1fr;
    }
    .docs-pager-prev,
    .docs-pager-next {
        grid-column: 1;
        align-items: flex-start;
        text-align: left;
    }
}