/* NetQueryBuilder Documentation Pages
   Extends landing.css design system via CSS variables */

/* ====================================
   Documentation Layout (3-column)
   ==================================== */
.docs-layout {
    display: grid;
    grid-template-columns: 260px minmax(0, 1fr) 220px;
    gap: 0;
    max-width: 1400px;
    margin: 0 auto;
    padding-top: 64px;
    min-height: 100vh;
}

/* ====================================
   Sidebar Navigation (left)
   ==================================== */
.docs-sidebar {
    position: sticky;
    top: 64px;
    height: calc(100vh - 64px);
    overflow-y: auto;
    padding: var(--space-8) var(--space-4);
    border-right: 1px solid rgba(0, 0, 0, 0.06);
    background: var(--surface-elevated);
    scrollbar-width: thin;
}

.docs-sidebar-section {
    margin-bottom: var(--space-6);
}

.docs-sidebar-title {
    font-size: 0.6875rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--text-muted);
    margin: 0 0 var(--space-3);
    padding: 0 var(--space-3);
}

.docs-sidebar-links {
    list-style: none;
    padding: 0;
    margin: 0;
}

.docs-sidebar-links li {
    margin: 0;
}

.docs-sidebar-links a {
    display: block;
    padding: var(--space-2) var(--space-3);
    color: var(--text-secondary);
    text-decoration: none;
    font-size: 0.875rem;
    font-weight: 500;
    border-radius: var(--radius-sm);
    transition: all var(--transition-fast);
    line-height: 1.5;
}

.docs-sidebar-links a:hover {
    color: var(--text-primary);
    background: var(--surface-muted);
}

.docs-sidebar-links a.active {
    color: var(--accent-purple);
    background: rgba(102, 126, 234, 0.08);
    font-weight: 600;
}

/* ====================================
   Main Content Area (center)
   ==================================== */
.docs-content {
    padding: var(--space-10) var(--space-12);
    max-width: 820px;
    min-width: 0;
}

.docs-content h1 {
    font-size: 2.25rem;
    font-weight: 700;
    letter-spacing: -0.02em;
    margin: 0 0 var(--space-2);
    color: var(--text-primary);
    line-height: 1.2;
}

.docs-content .docs-subtitle {
    font-size: 1.125rem;
    color: var(--text-secondary);
    margin: 0 0 var(--space-8);
    line-height: 1.6;
}

.docs-content h2 {
    font-size: 1.5rem;
    font-weight: 600;
    margin: var(--space-12) 0 var(--space-4);
    padding-top: var(--space-8);
    border-top: 1px solid var(--surface-muted);
    color: var(--text-primary);
    line-height: 1.3;
}

.docs-content h2:first-of-type {
    margin-top: 0;
    padding-top: 0;
    border-top: none;
}

.docs-content h3 {
    font-size: 1.125rem;
    font-weight: 600;
    margin: var(--space-8) 0 var(--space-3);
    color: var(--text-primary);
    line-height: 1.4;
}

.docs-content h4 {
    font-size: 1rem;
    font-weight: 600;
    margin: var(--space-6) 0 var(--space-2);
    color: var(--text-primary);
}

.docs-content p {
    font-size: 1rem;
    line-height: 1.75;
    color: var(--text-secondary);
    margin: 0 0 var(--space-4);
}

.docs-content ul,
.docs-content ol {
    padding-left: var(--space-6);
    margin: 0 0 var(--space-4);
    color: var(--text-secondary);
    line-height: 1.75;
}

.docs-content li {
    margin-bottom: var(--space-2);
}

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

.docs-content a {
    color: var(--accent-purple);
    text-decoration: none;
    font-weight: 500;
    transition: color var(--transition-fast);
}

.docs-content a:hover {
    color: #5468d4;
    text-decoration: underline;
}

.docs-content hr {
    border: none;
    border-top: 1px solid var(--surface-muted);
    margin: var(--space-8) 0;
}

/* Section anchors — offset for fixed nav */
.docs-content h2[id],
.docs-content h3[id],
.docs-content h4[id] {
    scroll-margin-top: 84px;
}

/* Heading anchor links */
.heading-anchor {
    color: var(--text-muted);
    text-decoration: none;
    margin-left: var(--space-2);
    opacity: 0;
    transition: opacity var(--transition-fast);
    font-weight: 400;
}

.docs-content h2:hover .heading-anchor,
.docs-content h3:hover .heading-anchor {
    opacity: 1;
}

.heading-anchor:hover {
    color: var(--accent-purple);
}

/* ====================================
   "On This Page" TOC (right)
   ==================================== */
.docs-toc {
    position: sticky;
    top: 64px;
    height: calc(100vh - 64px);
    overflow-y: auto;
    padding: var(--space-8) var(--space-5);
    border-left: 1px solid rgba(0, 0, 0, 0.06);
    scrollbar-width: thin;
}

.docs-toc-title {
    font-size: 0.6875rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--text-muted);
    margin: 0 0 var(--space-4);
}

.docs-toc-links {
    list-style: none;
    padding: 0;
    margin: 0;
    border-left: 2px solid var(--surface-muted);
}

.docs-toc-links li {
    margin: 0;
}

.docs-toc-links a {
    display: block;
    padding: var(--space-1) var(--space-4);
    color: var(--text-muted);
    text-decoration: none;
    font-size: 0.8125rem;
    line-height: 1.6;
    transition: all var(--transition-fast);
    border-left: 2px solid transparent;
    margin-left: -2px;
}

.docs-toc-links a:hover {
    color: var(--text-secondary);
}

.docs-toc-links a.active {
    color: var(--accent-purple);
    border-left-color: var(--accent-purple);
}

.docs-toc-links a.toc-h3 {
    padding-left: var(--space-8);
    font-size: 0.75rem;
}

/* ====================================
   Breadcrumb Navigation
   ==================================== */
.docs-breadcrumb {
    display: flex;
    align-items: center;
    gap: var(--space-2);
    font-size: 0.8125rem;
    color: var(--text-muted);
    margin-bottom: var(--space-6);
}

.docs-breadcrumb a {
    color: var(--text-muted);
    text-decoration: none;
    transition: color var(--transition-fast);
}

.docs-breadcrumb a:hover {
    color: var(--accent-purple);
}

.docs-breadcrumb-sep::before {
    content: '/';
    margin: 0 var(--space-1);
}

/* ====================================
   Code Blocks
   ==================================== */
.docs-code-wrapper {
    position: relative;
    margin: 0 0 var(--space-6);
    border-radius: var(--radius-md);
    overflow: hidden;
    border: 1px solid rgba(0, 0, 0, 0.08);
}

.docs-code-wrapper .code-lang {
    position: absolute;
    top: var(--space-3);
    right: var(--space-12);
    font-size: 0.6875rem;
    font-weight: 500;
    color: rgba(255, 255, 255, 0.35);
    text-transform: uppercase;
    letter-spacing: 0.05em;
    user-select: none;
    pointer-events: none;
}

.docs-code-wrapper .code-copy-btn {
    position: absolute;
    top: var(--space-2);
    right: var(--space-2);
    background: rgba(255, 255, 255, 0.06);
    border: 1px solid rgba(255, 255, 255, 0.1);
    border-radius: var(--radius-sm);
    color: rgba(255, 255, 255, 0.4);
    cursor: pointer;
    padding: var(--space-1) var(--space-2);
    font-size: 0.75rem;
    font-family: inherit;
    transition: all var(--transition-fast);
    line-height: 1.4;
}

.docs-code-wrapper .code-copy-btn:hover {
    color: var(--text-inverse);
    background: rgba(255, 255, 255, 0.12);
}

.docs-code-wrapper .code-copy-btn.copied {
    color: #10b981;
    border-color: rgba(16, 185, 129, 0.3);
}

.docs-code-wrapper pre {
    margin: 0;
    padding: var(--space-6);
    padding-top: var(--space-10);
    background: linear-gradient(135deg, #1a1b26 0%, #24283b 100%);
    overflow-x: auto;
    font-family: 'JetBrains Mono', 'Fira Code', 'Cascadia Code', Consolas, Monaco, monospace;
    font-size: 0.8125rem;
    line-height: 1.8;
    color: #a9b1d6;
}

/* Syntax highlighting — matches landing.css scheme */
.docs-code-wrapper .keyword { color: #bb9af7; }
.docs-code-wrapper .type { color: #7aa2f7; }
.docs-code-wrapper .string { color: #9ece6a; }
.docs-code-wrapper .comment { color: #565f89; }
.docs-code-wrapper .method { color: #e0af68; }
.docs-code-wrapper .tag { color: #f7768e; }
.docs-code-wrapper .attr { color: #bb9af7; }
.docs-code-wrapper .attr-value { color: #9ece6a; }
.docs-code-wrapper .number { color: #ff9e64; }
.docs-code-wrapper .param { color: #e0af68; }

/* Inline code */
.docs-content code:not(pre code) {
    background: var(--surface-muted);
    padding: 0.125em 0.375em;
    border-radius: 4px;
    font-family: 'JetBrains Mono', monospace;
    font-size: 0.8125em;
    color: var(--accent-purple);
    border: 1px solid rgba(0, 0, 0, 0.06);
    white-space: nowrap;
}

/* ====================================
   Callout Boxes
   ==================================== */
.docs-callout {
    padding: var(--space-4) var(--space-5);
    border-radius: var(--radius-md);
    margin: 0 0 var(--space-6);
    border-left: 4px solid;
    font-size: 0.9375rem;
    line-height: 1.7;
}

.docs-callout p {
    margin: 0;
    font-size: 0.9375rem;
}

.docs-callout p + p {
    margin-top: var(--space-2);
}

.docs-callout-title {
    font-weight: 600;
    margin-bottom: var(--space-1);
    display: block;
}

.docs-callout-info {
    background: rgba(79, 172, 254, 0.08);
    border-left-color: var(--accent-blue);
}

.docs-callout-info .docs-callout-title { color: var(--accent-blue); }

.docs-callout-warning {
    background: rgba(245, 175, 25, 0.08);
    border-left-color: #f5af19;
}

.docs-callout-warning .docs-callout-title { color: #d4940d; }

.docs-callout-tip {
    background: rgba(16, 185, 129, 0.08);
    border-left-color: #10b981;
}

.docs-callout-tip .docs-callout-title { color: #10b981; }

/* ====================================
   API Reference Tables
   ==================================== */
.docs-table-wrapper {
    overflow-x: auto;
    margin: 0 0 var(--space-6);
    border-radius: var(--radius-md);
    border: 1px solid rgba(0, 0, 0, 0.06);
}

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

.docs-table th {
    text-align: left;
    padding: var(--space-3) var(--space-4);
    background: var(--surface-muted);
    font-weight: 600;
    color: var(--text-primary);
    border-bottom: 2px solid rgba(0, 0, 0, 0.08);
    white-space: nowrap;
}

.docs-table td {
    padding: var(--space-3) var(--space-4);
    border-bottom: 1px solid var(--surface-muted);
    color: var(--text-secondary);
    vertical-align: top;
}

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

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

/* ====================================
   Package Install Box
   ==================================== */
.docs-install {
    background: var(--surface-muted);
    border-radius: var(--radius-md);
    padding: var(--space-4) var(--space-5);
    margin: 0 0 var(--space-6);
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: var(--space-4);
    border: 1px solid rgba(0, 0, 0, 0.06);
}

.docs-install code {
    font-family: 'JetBrains Mono', monospace;
    font-size: 0.875rem;
    color: var(--text-primary);
    background: none !important;
    border: none !important;
    padding: 0 !important;
    white-space: nowrap;
}

.docs-install .code-copy-btn {
    background: none;
    border: none;
    cursor: pointer;
    padding: var(--space-1);
    color: var(--text-muted);
    transition: color var(--transition-fast);
    flex-shrink: 0;
}

.docs-install .code-copy-btn:hover {
    color: var(--accent-purple);
}

.docs-install .code-copy-btn svg {
    width: 16px;
    height: 16px;
    display: block;
}

/* ====================================
   Framework Cards (Getting Started)
   ==================================== */
.docs-cards-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
    gap: var(--space-4);
    margin: 0 0 var(--space-6);
}

.docs-card {
    background: var(--surface-elevated);
    border: 1px solid rgba(0, 0, 0, 0.06);
    border-radius: var(--radius-md);
    padding: var(--space-5);
    text-decoration: none;
    transition: all var(--transition-normal);
    display: block;
}

.docs-card:hover {
    transform: translateY(-2px);
    box-shadow: var(--shadow-lg);
    border-color: var(--accent-purple);
}

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

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

/* ====================================
   Badge
   ==================================== */
.docs-badge {
    display: inline-flex;
    align-items: center;
    gap: var(--space-2);
    padding: var(--space-1) var(--space-3);
    background: var(--surface-muted);
    border-radius: var(--radius-full);
    font-size: 0.75rem;
    font-weight: 500;
    color: var(--text-secondary);
    vertical-align: middle;
}

/* ====================================
   Navigation Prev/Next
   ==================================== */
.docs-nav-footer {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: var(--space-4);
    margin-top: var(--space-12);
    padding-top: var(--space-8);
    border-top: 1px solid var(--surface-muted);
}

.docs-nav-link {
    display: block;
    padding: var(--space-4) var(--space-5);
    background: var(--surface-elevated);
    border: 1px solid rgba(0, 0, 0, 0.06);
    border-radius: var(--radius-md);
    text-decoration: none;
    transition: all var(--transition-normal);
}

.docs-nav-link:hover {
    border-color: var(--accent-purple);
    box-shadow: var(--shadow-md);
}

.docs-nav-link-label {
    font-size: 0.75rem;
    font-weight: 500;
    color: var(--text-muted);
    text-transform: uppercase;
    letter-spacing: 0.05em;
    margin-bottom: var(--space-1);
}

.docs-nav-link-title {
    font-size: 0.9375rem;
    font-weight: 600;
    color: var(--accent-purple);
}

.docs-nav-link.next {
    text-align: right;
}

/* ====================================
   Mobile Sidebar Toggle
   ==================================== */
.docs-mobile-sidebar-toggle {
    display: none;
    position: fixed;
    bottom: var(--space-6);
    left: var(--space-6);
    width: 48px;
    height: 48px;
    border-radius: 50%;
    background: var(--gradient-primary);
    color: var(--text-inverse);
    border: none;
    cursor: pointer;
    align-items: center;
    justify-content: center;
    box-shadow: var(--shadow-lg), 0 0 20px rgba(102, 126, 234, 0.3);
    z-index: 997;
    transition: transform var(--transition-normal);
}

.docs-mobile-sidebar-toggle svg {
    width: 20px;
    height: 20px;
}

.docs-sidebar-overlay {
    display: none;
    position: fixed;
    inset: 0;
    background: rgba(0, 0, 0, 0.4);
    z-index: 998;
}

.docs-sidebar-overlay.open {
    display: block;
}

/* ====================================
   Responsive
   ==================================== */

/* Hide right TOC on medium screens */
@media (max-width: 1200px) {
    .docs-layout {
        grid-template-columns: 260px minmax(0, 1fr);
    }

    .docs-toc {
        display: none;
    }
}

/* Stack to single column on mobile */
@media (max-width: 768px) {
    .docs-layout {
        grid-template-columns: 1fr;
        padding-top: 56px;
    }

    .docs-sidebar {
        position: fixed;
        top: 0;
        left: 0;
        bottom: 0;
        width: 280px;
        z-index: 999;
        transform: translateX(-100%);
        transition: transform var(--transition-normal);
        padding-top: 72px;
    }

    .docs-sidebar.open {
        transform: translateX(0);
        box-shadow: 4px 0 24px rgba(0, 0, 0, 0.15);
    }

    .docs-content {
        padding: var(--space-6);
    }

    .docs-content h1 {
        font-size: 1.75rem;
    }

    .docs-content h2 {
        font-size: 1.25rem;
    }

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

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

    .docs-nav-link.next {
        text-align: left;
    }

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

/* ====================================
   Print
   ==================================== */
@media print {
    .docs-sidebar,
    .docs-toc,
    .docs-mobile-sidebar-toggle,
    .docs-sidebar-overlay,
    .code-copy-btn,
    .heading-anchor,
    #nav-slot,
    #footer-slot {
        display: none !important;
    }

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

    .docs-content {
        padding: 0;
        max-width: 100%;
    }
}