/* ===================================================================
   PicoClaw.ai — Documentation Stylesheet
   =================================================================== */

/* --- Docs Layout --- */
.docs-body {
    overflow-x: hidden;
}

.docs-layout {
    display: flex;
    min-height: calc(100vh - var(--navbar-height));
    padding-top: var(--navbar-height);
    position: relative;
}

/* ===================================================================
   SIDEBAR
   =================================================================== */
.docs-sidebar {
    position: fixed;
    top: var(--navbar-height);
    left: 0;
    width: 280px;
    height: calc(100vh - var(--navbar-height));
    background: var(--color-bg-alt);
    border-right: 1px solid var(--color-border);
    overflow-y: auto;
    z-index: 100;
    transition: transform var(--transition-slow);
    scrollbar-width: thin;
    scrollbar-color: var(--color-border-light) transparent;
}

.docs-sidebar::-webkit-scrollbar {
    width: 4px;
}

.docs-sidebar::-webkit-scrollbar-thumb {
    background: var(--color-border-light);
    border-radius: 4px;
}

.sidebar-header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    padding: var(--space-lg) var(--space-lg) var(--space-md);
    border-bottom: 1px solid var(--color-border);
}

.sidebar-header h3 {
    font-size: 0.9375rem;
    font-weight: 700;
    color: var(--color-text-heading);
    text-transform: uppercase;
    letter-spacing: 0.05em;
}

.sidebar-close {
    display: none;
    background: none;
    border: none;
    color: var(--color-text-muted);
    font-size: 1.25rem;
    cursor: pointer;
    padding: var(--space-xs);
}

.sidebar-nav {
    padding: var(--space-md) 0 var(--space-2xl);
}

.sidebar-menu {
    list-style: none;
}

.sidebar-section-title {
    font-size: 0.6875rem;
    font-weight: 700;
    color: var(--color-text-muted);
    text-transform: uppercase;
    letter-spacing: 0.08em;
    padding: var(--space-lg) var(--space-lg) var(--space-sm);
    margin-top: var(--space-sm);
}

.sidebar-link {
    display: flex;
    align-items: center;
    gap: var(--space-sm);
    padding: 0.45rem var(--space-lg);
    font-size: 0.8475rem;
    color: var(--color-text-muted);
    text-decoration: none;
    transition: all var(--transition-fast);
    border-left: 3px solid transparent;
}

.sidebar-link i {
    width: 18px;
    text-align: center;
    font-size: 0.8125rem;
    opacity: 0.7;
}

.sidebar-link:hover {
    color: var(--color-text-heading);
    background: rgba(255, 255, 255, 0.03);
}

.sidebar-link.active {
    color: var(--color-primary-light);
    background: var(--color-primary-bg);
    border-left-color: var(--color-primary);
    font-weight: 600;
}

.sidebar-link.active i {
    opacity: 1;
}

/* Sidebar Overlay */
.sidebar-overlay {
    display: none;
    position: fixed;
    inset: 0;
    background: rgba(0, 0, 0, 0.5);
    z-index: 99;
}

/* Mobile sidebar toggle */
.docs-sidebar-toggle {
    display: none;
    position: fixed;
    bottom: var(--space-xl);
    left: var(--space-xl);
    z-index: 98;
    background: var(--gradient-primary);
    color: #fff;
    border: none;
    padding: 0.75rem 1.25rem;
    border-radius: var(--radius-full);
    font-family: var(--font-sans);
    font-size: 0.875rem;
    font-weight: 600;
    cursor: pointer;
    box-shadow: 0 4px 20px rgba(99, 102, 241, 0.4);
    transition: all var(--transition-normal);
}

.docs-sidebar-toggle:hover {
    transform: translateY(-2px);
    box-shadow: 0 6px 24px rgba(99, 102, 241, 0.5);
}

.docs-sidebar-toggle i {
    margin-right: var(--space-xs);
}

/* ===================================================================
   MAIN CONTENT
   =================================================================== */
.docs-main {
    flex: 1;
    margin-left: 280px;
    min-width: 0;
}

.docs-container {
    max-width: 860px;
    padding: var(--space-2xl) var(--space-2xl) var(--space-4xl);
}

/* Breadcrumb */
.docs-breadcrumb {
    margin-bottom: var(--space-2xl);
}

.docs-breadcrumb ol {
    display: flex;
    align-items: center;
    gap: var(--space-sm);
    list-style: none;
    font-size: 0.8125rem;
}

.docs-breadcrumb li {
    color: var(--color-text-muted);
}

.docs-breadcrumb li + li::before {
    content: '/';
    margin-right: var(--space-sm);
    color: var(--color-border-light);
}

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

.docs-breadcrumb a:hover {
    color: var(--color-primary-light);
}

/* ===================================================================
   DOCUMENTATION TYPOGRAPHY
   =================================================================== */
.doc-section {
    padding-bottom: var(--space-3xl);
    margin-bottom: var(--space-3xl);
    border-bottom: 1px solid var(--color-border);
    scroll-margin-top: calc(var(--navbar-height) + 20px);
}

.doc-section:last-of-type {
    border-bottom: none;
}

.doc-h1 {
    font-size: clamp(2rem, 4vw, 2.75rem);
    font-weight: 900;
    color: var(--color-text-heading);
    line-height: 1.2;
    margin-bottom: var(--space-md);
}

.doc-emoji {
    font-size: 0.85em;
    margin-right: var(--space-xs);
}

.doc-lead {
    font-size: 1.1875rem;
    color: var(--color-text-muted);
    line-height: 1.7;
    margin-bottom: var(--space-2xl);
}

.doc-h2 {
    font-size: 1.5rem;
    font-weight: 800;
    color: var(--color-text-heading);
    margin-top: var(--space-2xl);
    margin-bottom: var(--space-lg);
    padding-bottom: var(--space-sm);
    border-bottom: 2px solid var(--color-border);
    display: flex;
    align-items: center;
    gap: var(--space-sm);
}

.doc-h2 i {
    color: var(--color-primary-light);
    font-size: 0.9em;
}

.doc-h3 {
    font-size: 1.125rem;
    font-weight: 700;
    color: var(--color-text-heading);
    margin-top: var(--space-xl);
    margin-bottom: var(--space-md);
}

.doc-section p {
    color: var(--color-text);
    line-height: 1.8;
    margin-bottom: var(--space-md);
}

/* Lists */
.doc-list {
    list-style: none;
    margin-bottom: var(--space-lg);
}

.doc-list li {
    position: relative;
    padding: var(--space-sm) 0 var(--space-sm) var(--space-xl);
    color: var(--color-text);
    line-height: 1.6;
}

.doc-list li::before {
    content: '•';
    position: absolute;
    left: var(--space-sm);
    color: var(--color-primary-light);
    font-weight: 700;
}

.doc-list-ordered {
    margin-bottom: var(--space-lg);
    padding-left: var(--space-xl);
}

.doc-list-ordered li {
    padding: var(--space-xs) 0;
    color: var(--color-text);
    line-height: 1.6;
}

.doc-list-ordered li::marker {
    color: var(--color-primary-light);
    font-weight: 700;
}

/* ===================================================================
   CALLOUTS
   =================================================================== */
.doc-callout {
    display: flex;
    gap: var(--space-md);
    padding: var(--space-lg);
    border-radius: var(--radius-md);
    margin-bottom: var(--space-lg);
    border-left: 4px solid;
}

.callout-icon {
    font-size: 1.25rem;
    flex-shrink: 0;
    margin-top: 2px;
}

.callout-content strong {
    display: block;
    margin-bottom: var(--space-xs);
}

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

.doc-callout-info {
    background: rgba(99, 102, 241, 0.06);
    border-color: var(--color-primary);
}

.doc-callout-info .callout-icon { color: var(--color-primary-light); }

.doc-callout-tip {
    background: rgba(16, 185, 129, 0.06);
    border-color: var(--color-green);
}

.doc-callout-tip .callout-icon { color: var(--color-green); }

.doc-callout-warning {
    background: rgba(245, 158, 11, 0.06);
    border-color: var(--color-yellow);
}

.doc-callout-warning .callout-icon { color: var(--color-yellow); }

/* ===================================================================
   FEATURE GRID (Overview)
   =================================================================== */
.doc-feature-grid {
    display: grid;
    grid-template-columns: repeat(2, 1fr);
    gap: var(--space-md);
    margin-bottom: var(--space-xl);
}

.doc-feature-item {
    display: flex;
    align-items: center;
    gap: var(--space-md);
    padding: var(--space-lg);
    background: var(--color-bg-card);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
}

.doc-feature-icon {
    font-size: 1.75rem;
    flex-shrink: 0;
}

.doc-feature-item strong {
    font-size: 1rem;
    display: block;
}

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

/* ===================================================================
   TABLES
   =================================================================== */
.doc-table {
    width: 100%;
    border-collapse: collapse;
    margin-bottom: var(--space-lg);
    font-size: 0.875rem;
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    overflow: hidden;
}

.doc-table thead {
    background: var(--color-surface);
}

.doc-table th {
    padding: var(--space-md) var(--space-lg);
    text-align: left;
    font-weight: 700;
    color: var(--color-text-heading);
    border-bottom: 2px solid var(--color-border);
    white-space: nowrap;
}

.doc-table td {
    padding: var(--space-md) var(--space-lg);
    border-bottom: 1px solid var(--color-border);
    color: var(--color-text);
    vertical-align: top;
}

.doc-table tbody tr:hover {
    background: rgba(99, 102, 241, 0.03);
}

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

/* ===================================================================
   CODE BLOCKS (uses shared .code-header, .code-dot styles from main)
   =================================================================== */
.doc-code {
    border-radius: var(--radius-lg);
    overflow: hidden;
    border: 1px solid var(--color-border);
    background: var(--color-bg-card);
    margin-bottom: var(--space-lg);
}

.doc-code pre {
    padding: var(--space-lg);
    overflow-x: auto;
    font-size: 0.8125rem;
    line-height: 1.9;
    margin: 0;
}

.doc-code code {
    background: none;
    padding: 0;
    color: var(--color-text);
    font-size: 0.8125rem;
}

/* ===================================================================
   STEPS
   =================================================================== */
.doc-steps {
    margin: var(--space-xl) 0;
}

.doc-step {
    display: flex;
    gap: var(--space-lg);
    margin-bottom: var(--space-xl);
    position: relative;
}

.doc-step:not(:last-child)::after {
    content: '';
    position: absolute;
    left: 19px;
    top: 44px;
    bottom: -8px;
    width: 2px;
    background: var(--color-border);
}

.step-number {
    width: 40px;
    height: 40px;
    display: flex;
    align-items: center;
    justify-content: center;
    background: var(--gradient-primary);
    color: #fff;
    font-weight: 800;
    font-size: 1rem;
    border-radius: 50%;
    flex-shrink: 0;
    position: relative;
    z-index: 1;
}

.step-content {
    flex: 1;
    min-width: 0;
    padding-top: var(--space-xs);
}

.step-content h4 {
    font-size: 1.0625rem;
    font-weight: 700;
    color: var(--color-text-heading);
    margin-bottom: var(--space-sm);
}

.step-content p {
    font-size: 0.9375rem;
    line-height: 1.7;
}

/* ===================================================================
   PROVIDER GRID (Quick Start)
   =================================================================== */
.doc-provider-grid {
    display: grid;
    grid-template-columns: repeat(3, 1fr);
    gap: var(--space-sm);
    margin: var(--space-md) 0;
}

.doc-provider {
    display: flex;
    flex-direction: column;
    align-items: center;
    padding: var(--space-md);
    background: var(--color-bg-card);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    text-align: center;
    transition: all var(--transition-fast);
    color: var(--color-text);
    text-decoration: none;
}

.doc-provider:hover {
    border-color: var(--color-primary);
    background: var(--color-primary-bg);
    color: var(--color-primary-light);
}

.doc-provider strong {
    font-size: 0.875rem;
}

.doc-provider small {
    font-size: 0.6875rem;
    color: var(--color-text-muted);
}

/* ===================================================================
   BADGES
   =================================================================== */
.doc-badge {
    display: inline-block;
    font-size: 0.6875rem;
    font-weight: 700;
    padding: 0.2em 0.7em;
    border-radius: var(--radius-full);
    text-transform: uppercase;
    letter-spacing: 0.03em;
    vertical-align: middle;
    margin-bottom: var(--space-md);
}

.doc-badge-green {
    background: var(--color-green-bg);
    color: var(--color-green);
}

.doc-badge-yellow {
    background: var(--color-yellow-bg);
    color: var(--color-yellow);
}

.doc-badge-blue {
    background: rgba(99, 102, 241, 0.1);
    color: var(--color-primary-light);
}

/* ===================================================================
   TROUBLESHOOTING
   =================================================================== */
.doc-troubleshoot-item {
    background: var(--color-bg-card);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    padding: var(--space-lg);
    margin-bottom: var(--space-md);
}

.doc-troubleshoot-item h3 {
    margin-top: 0;
    font-size: 1rem;
}

.doc-troubleshoot-item p {
    font-size: 0.9375rem;
}

/* ===================================================================
   COMMUNITY LINKS
   =================================================================== */
.doc-community-links {
    display: flex;
    gap: var(--space-md);
    flex-wrap: wrap;
    margin-top: var(--space-lg);
}

.doc-community-link {
    display: inline-flex;
    align-items: center;
    gap: var(--space-sm);
    padding: 0.625rem 1.25rem;
    background: var(--color-bg-card);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    color: var(--color-text);
    font-size: 0.875rem;
    font-weight: 600;
    transition: all var(--transition-fast);
    text-decoration: none;
}

.doc-community-link:hover {
    border-color: var(--color-primary);
    color: var(--color-primary-light);
    background: var(--color-primary-bg);
}

.doc-community-link i {
    font-size: 1.125rem;
}

/* ===================================================================
   DOC FOOTER
   =================================================================== */
.doc-footer {
    display: flex;
    align-items: center;
    justify-content: space-between;
    margin-top: var(--space-3xl);
    padding-top: var(--space-xl);
    border-top: 1px solid var(--color-border);
    flex-wrap: wrap;
    gap: var(--space-md);
}

.doc-last-updated {
    font-size: 0.8125rem;
    color: var(--color-text-muted);
}

.docs-footer-main {
    margin-left: 280px;
}

/* ===================================================================
   RESPONSIVE
   =================================================================== */
@media (max-width: 1024px) {
    .docs-sidebar {
        transform: translateX(-100%);
    }

    .docs-sidebar.open {
        transform: translateX(0);
    }

    .sidebar-close {
        display: block;
    }

    .sidebar-overlay.active {
        display: block;
    }

    .docs-sidebar-toggle {
        display: flex;
        align-items: center;
        gap: var(--space-xs);
    }

    .docs-main {
        margin-left: 0;
    }

    .docs-container {
        padding: var(--space-xl) var(--space-lg) var(--space-3xl);
    }

    .docs-footer-main {
        margin-left: 0;
    }
}

@media (max-width: 768px) {
    .doc-feature-grid {
        grid-template-columns: 1fr;
    }

    .doc-provider-grid {
        grid-template-columns: repeat(2, 1fr);
    }

    .docs-container {
        padding: var(--space-lg) var(--space-md) var(--space-3xl);
    }

    .doc-table {
        font-size: 0.8125rem;
    }

    .doc-table th,
    .doc-table td {
        padding: var(--space-sm) var(--space-md);
    }

    .doc-community-links {
        flex-direction: column;
    }

    .doc-step::after {
        display: none !important;
    }
}

@media (max-width: 480px) {
    .doc-provider-grid {
        grid-template-columns: 1fr;
    }
}

/* Print */
@media print {
    .docs-sidebar,
    .docs-sidebar-toggle,
    .sidebar-overlay,
    .navbar {
        display: none !important;
    }

    .docs-main {
        margin-left: 0;
    }

    .docs-footer-main {
        margin-left: 0;
    }
}