/* ==========================================================================
   ADVANCED APPS COMPONENTS
   ========================================================================== */

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

.tip-card {
    background: white;
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    padding: 1.5rem;
    box-shadow: var(--fiber-shadow);
}

.tip-card h3 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
    font-size: 1.125rem;
}

.tip-card ul {
    margin: 0;
    padding-left: 1.25rem;
}

.tip-card li {
    margin-bottom: 0.5rem;
}

/* Deployment Grid */
.deployment-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
    gap: 2rem;
    margin: 2rem 0;
}

.deployment-card {
    background: white;
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    padding: 2rem;
    box-shadow: var(--fiber-shadow);
}

.deployment-card h3 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
}

/* Best Practices Grid */
.best-practices-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
    gap: 1.5rem;
    margin: 2rem 0;
}

.practice-card {
    background: white;
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    padding: 1.5rem;
    box-shadow: var(--fiber-shadow);
}

.practice-card h3 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
}

/* Learning Path */
.learning-path {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));
    gap: 2rem;
    margin: 2rem 0;
}

.step-card {
    background: white;
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    padding: 2rem;
    box-shadow: var(--fiber-shadow);
    position: relative;
}

.step-card.beginner {
    border-left: 4px solid #4caf50;
}

.step-card.intermediate {
    border-left: 4px solid #ff9800;
}

.step-card.advanced {
    border-left: 4px solid #f44336;
}

.step-number {
    position: absolute;
    top: -10px;
    left: 20px;
    width: 30px;
    height: 30px;
    background: var(--fiber-primary);
    color: white;
    border-radius: 50%;
    display: flex;
    align-items: center;
    justify-content: center;
    font-weight: bold;
    font-size: 1rem;
}

.step-card h3 {
    margin: 10px 0 1rem 0;
    color: var(--fiber-primary);
}

.estimated-time {
    background: var(--fiber-bg-light);
    padding: 0.5rem 1rem;
    border-radius: var(--fiber-radius);
    font-size: 0.9rem;
    color: var(--fiber-text-secondary);
    margin-top: 1rem;
    text-align: center;
}

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

.resource-card {
    background: white;
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    padding: 1.5rem;
    box-shadow: var(--fiber-shadow);
}

.resource-card h4 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
}

.resource-card ul {
    margin: 0;
    padding-left: 1.25rem;
}

.resource-card li {
    margin-bottom: 0.5rem;
}

.resource-card a {
    color: var(--fiber-primary);
    text-decoration: none;
}

.resource-card a:hover {
    text-decoration: underline;
}

/* Action Box */
.action-box {
    background: var(--fiber-bg-light);
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    padding: 2rem;
    text-align: center;
    margin: 3rem 0;
}

.action-box h3 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
}

.action-buttons {
    display: flex;
    gap: 1rem;
    justify-content: center;
    margin: 1.5rem 0;
    flex-wrap: wrap;
}

.action-buttons .btn {
    padding: 0.75rem 1.5rem;
    border-radius: var(--fiber-radius);
    text-decoration: none;
    font-weight: 500;
    transition: all 0.2s;
}

.action-buttons .btn-primary {
    background: var(--fiber-primary);
    color: white;
}

.action-buttons .btn-primary:hover {
    background: var(--fiber-accent);
}

.action-buttons .btn-secondary {
    background: white;
    color: var(--fiber-primary);
    border: 1px solid var(--fiber-primary);
}

.action-buttons .btn-secondary:hover {
    background: var(--fiber-primary);
    color: white;
}

.help-note {
    background: white;
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    padding: 1rem;
    margin-top: 1.5rem;
    font-size: 0.9rem;
}

.help-note p {
    margin: 0;
    color: var(--fiber-text-secondary);
}

/* Security Practices */
.security-practices {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
    gap: 1.5rem;
    margin: 2rem 0;
}

.practice-card h4 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
    font-size: 1.125rem;
}

/* Architecture Diagram */
.architecture-diagram {
    background: var(--fiber-bg-light);
    border-radius: var(--fiber-radius);
    padding: 2rem;
    margin: 2rem 0;
}

.architecture-diagram h3 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
    text-align: center;
}

/* Responsive Design for Advanced Components */
@media (max-width: 768px) {
    .tips-grid,
    .deployment-grid,
    .best-practices-grid,
    .resources-grid,
    .security-practices {
        grid-template-columns: 1fr;
    }
    
    .learning-path {
        grid-template-columns: 1fr;
    }
    
    .action-buttons {
        flex-direction: column;
        align-items: center;
    }
    
    .action-buttons .btn {
        width: 100%;
        max-width: 200px;
    }
}

@media (max-width: 480px) {
    .tip-card,
    .deployment-card,
    .practice-card,
    .resource-card,
    .step-card {
        padding: 1rem;
    }
    
    .action-box {
        padding: 1.5rem;
    }
}

/* ==========================================================================
   EXISTING COMPONENTS (keeping all previous styles)
   ========================================================================== */

/* ==========================================================================
   GRID LAYOUTS
   ========================================================================== */

/* Building Block Progression */
.building-block-progression {
    display: flex;
    align-items: center;
    gap: 2rem;
    margin: 2rem 0;
    padding: 2rem;
    background: var(--fiber-bg-light);
    border-radius: var(--fiber-radius);
    overflow-x: auto;
}

.block-item {
    display: flex;
    align-items: center;
    gap: 1rem;
    min-width: 300px;
    padding: 1.5rem;
    background: white;
    border-radius: var(--fiber-radius);
    box-shadow: var(--fiber-shadow);
}

.block-item.current {
    border: 2px solid var(--fiber-primary);
    box-shadow: 0 4px 20px rgba(33, 150, 243, 0.2);
}

.block-item.future {
    opacity: 0.7;
}

.block-number {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 40px;
    height: 40px;
    background: var(--fiber-primary);
    color: white;
    border-radius: 50%;
    font-weight: 700;
}

/* App Development Showcase Styles */
.pattern-section {
    margin: 2rem 0;
    padding: 1.5rem;
    background: var(--fiber-bg-light);
    border-radius: var(--fiber-radius);
    border-left: 4px solid var(--fiber-primary);
}

.pattern-section h4 {
    margin-top: 0;
    color: var(--fiber-primary);
    font-size: 1.25rem;
    margin-bottom: 1rem;
}

.benefits-showcase {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
    gap: 1.5rem;
    margin: 2rem 0;
}

.block-number {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 40px;
    height: 40px;
    background: var(--fiber-primary);
    color: white;
    border-radius: 50%;
    font-weight: 700;
    font-size: 1.25rem;
    flex-shrink: 0;
}

.block-content h3 {
    margin: 0 0 0.5rem 0;
    font-size: 1.125rem;
}

.block-content p {
    margin: 0 0 1rem 0;
    font-weight: 600;
    color: var(--fiber-primary);
}

.block-content ul {
    margin: 0;
    padding-left: 1rem;
}

.block-arrow {
    font-size: 2rem;
    color: var(--fiber-primary);
    font-weight: bold;
    flex-shrink: 0;
}

/* Component Grids */
.component-grid,
.components-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
    gap: 2rem;
    margin: 2rem 0;
}

.config-sections {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(350px, 1fr));
    gap: 2rem;
    margin: 2rem 0;
}

.api-sections {
    display: grid;
    grid-template-columns: 1fr;
    gap: 1.5rem;
    margin: 2rem 0;
}

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

.example-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
    gap: 2rem;
    margin: 2rem 0;
}

.next-steps-grid {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 2rem;
    margin: 1.5rem 0;
}

.benefits-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
    gap: 1.5rem;
    margin: 1rem 0;
}

.agent-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
    gap: 2rem;
    margin: 2rem 0;
}

/* ==========================================================================
   CARD COMPONENTS
   ========================================================================== */

/* Component Cards */
.component-card {
    background: white;
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    padding: 2rem;
    box-shadow: var(--fiber-shadow);
    transition: transform 0.2s, box-shadow 0.2s;
}

.component-card:hover {
    transform: translateY(-2px);
    box-shadow: 0 8px 25px rgba(0, 0, 0, 0.1);
}

.component-card h3 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
    font-size: 1.25rem;
}

.component-card ul {
    margin: 0;
    padding-left: 1.25rem;
}

.component-card li {
    margin-bottom: 0.5rem;
}

/* Provider Cards */
.provider-card {
    background: white;
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    padding: 1.5rem;
    box-shadow: var(--fiber-shadow);
    transition: all 0.2s;
}

.provider-card:hover {
    border-color: var(--fiber-primary);
    box-shadow: 0 4px 12px rgba(33, 150, 243, 0.15);
}

/* Next Step Cards */
.next-step-card {
    background: white;
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    padding: 2rem;
    text-align: center;
    box-shadow: var(--fiber-shadow);
}

.next-step-card h3 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
}

.next-step-card p {
    margin: 0 0 1.5rem 0;
}

/* Feature Cards */
.feature-card {
    background: white;
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    padding: 1.5rem;
    box-shadow: var(--fiber-shadow);
}

.feature-card h3 {
    margin: 0 0 0.75rem 0;
    color: var(--fiber-primary);
    font-size: 1.125rem;
}

.feature-card p {
    margin: 0;
    color: var(--fiber-text-secondary);
    font-size: 0.9rem;
}

/* Example Cards */
.example-card {
    background: white;
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    padding: 1.5rem;
    box-shadow: var(--fiber-shadow);
}

.example-card h3 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
}

/* Agent Cards */
.agent-card {
    background: white;
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    padding: 2rem;
    box-shadow: var(--fiber-shadow);
}

.agent-card h3 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
}

.agent-type {
    display: inline-block;
    padding: 0.375rem 0.75rem;
    border-radius: 0.375rem;
    font-size: 0.875rem;
    font-weight: 600;
    margin-bottom: 1rem;
}

.agent-type.llm {
    background: #e3f2fd;
    color: #1976d2;
}

.agent-type.custom {
    background: #f3e5f5;
    color: #7b1fa2;
}

/* ==========================================================================
   INFORMATION BLOCKS
   ========================================================================== */

/* Info Blurbs */
.info-blurb {
    background: #e3f2fd;
    border: 1px solid #90caf9;
    border-left: 4px solid #2196F3;
    border-radius: var(--fiber-radius);
    padding: 1.5rem;
    margin: 1.5rem 0;
}

.info-blurb h4 {
    margin: 0 0 0.75rem 0;
    color: #1976d2;
}

.info-blurb p {
    margin: 0;
}

.info-link {
    color: #1976d2;
    text-decoration: none;
    font-weight: 500;
}

.info-link:hover {
    text-decoration: underline;
}

/* Provider Notes */
.provider-note {
    background: #f8f9fa;
    border: 1px solid #e9ecef;
    border-left: 4px solid var(--fiber-primary);
    border-radius: var(--fiber-radius);
    padding: 1.5rem;
    margin: 1.5rem 0;
}

.provider-note h4 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
}

.provider-note p {
    margin: 0 0 1rem 0;
}

.provider-note ul {
    margin: 0;
    padding-left: 1.5rem;
}

/* CLI Options */
.cli-options {
    background: #f8f9fa;
    border: 1px solid #e9ecef;
    border-radius: var(--fiber-radius);
    padding: 1.5rem;
    margin: 1rem 0;
}

.cli-options h5 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
}

.cli-options ul {
    margin: 0;
    padding-left: 1.5rem;
}

.cli-options code {
    background: white;
    padding: 0.125rem 0.375rem;
    border-radius: 0.25rem;
    font-weight: 600;
}

/* Learning Path */
.learning-path {
    background: var(--fiber-accent);
    color: white;
    padding: 1.5rem;
    border-radius: var(--fiber-radius);
    margin-top: 1rem;
}

.learning-path h3 {
    margin: 0 0 0.5rem 0;
}

.learning-path p {
    margin: 0;
}

/* ==========================================================================
   RESPONSIVE DESIGN
   ========================================================================== */

@media (max-width: 768px) {
    .building-block-progression {
        flex-direction: column;
    }

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

    .next-steps-grid {
        grid-template-columns: 1fr;
    }

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

    .component-grid,
    .components-grid {
        grid-template-columns: 1fr;
    }

    .config-sections {
        grid-template-columns: 1fr;
    }

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

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

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

@media (max-width: 480px) {
    .component-card,
    .provider-card,
    .next-step-card,
    .feature-card,
    .example-card,
    .agent-card {
        padding: 1rem;
    }

    .info-blurb,
    .provider-note,
    .cli-options {
        padding: 1rem;
    }
}

/* ==========================================================================
   LAYOUT UTILITIES
   ========================================================================== */

.overview-highlight {
    background: var(--fiber-bg-light);
    border-radius: var(--fiber-radius);
    padding: 2rem;
    margin: 2rem 0;
}

.overview-highlight h3 {
    margin: 0 0 1rem 0;
    color: var(--fiber-primary);
}

/* Floating Navigation for Building Blocks */
.floating-building-blocks {
    position: fixed;
    top: 100px;
    right: 20px;
    background: white;
    border: 1px solid var(--fiber-border);
    border-radius: var(--fiber-radius);
    box-shadow: var(--fiber-shadow);
    padding: 1rem;
    z-index: 1000;
    max-width: 250px;
}

.floating-nav-header {
    font-weight: 600;
    color: var(--fiber-primary);
    margin-bottom: 0.75rem;
    text-align: center;
}

.building-blocks-nav {
    display: flex;
    flex-direction: column;
    gap: 0.5rem;
}

.building-block-nav-item {
    display: flex;
    align-items: center;
    gap: 0.75rem;
    padding: 0.75rem;
    border-radius: 0.375rem;
    text-decoration: none;
    color: var(--fiber-text);
    transition: all 0.2s;
}

.building-block-nav-item:hover {
    background: var(--fiber-bg-light);
}

.building-block-nav-item.current {
    background: var(--fiber-primary);
    color: white;
}

.nav-block-number {
    width: 24px;
    height: 24px;
    background: var(--fiber-accent);
    color: white;
    border-radius: 50%;
    display: flex;
    align-items: center;
    justify-content: center;
    font-size: 0.75rem;
    font-weight: 600;
    flex-shrink: 0;
}

.building-block-nav-item.current .nav-block-number {
    background: white;
    color: var(--fiber-primary);
}

.nav-block-content {
    flex: 1;
}

.nav-block-title {
    font-weight: 600;
    font-size: 0.875rem;
    margin-bottom: 0.25rem;
}

.nav-block-desc {
    font-size: 0.75rem;
    opacity: 0.8;
}

@media (max-width: 1200px) {
    .floating-building-blocks {
        display: none;
    }
}

/* ==========================================================================
   DOCUMENTATION LAYOUT STYLES
   ========================================================================== */

.docs-section {
    margin-bottom: 3rem;
    padding-bottom: 2rem;
    border-bottom: 1px solid var(--border-light);
}

.docs-section:last-child {
    border-bottom: none;
}

.process-list {
    background: var(--bg-light);
    padding: 1.5rem;
    border-radius: 0.5rem;
    margin: 1rem 0;
}

.process-list li {
    margin-bottom: 0.75rem;
    padding-left: 0.5rem;
}

.process-list li:last-child {
    margin-bottom: 0;
}

/* Info Boxes */
.info-box {
    background: #e3f2fd;
    border-left: 4px solid #2196f3;
    padding: 1rem 1.5rem;
    margin: 1rem 0;
    border-radius: 0 0.5rem 0.5rem 0;
}

.info-box h4 {
    margin-bottom: 0.5rem;
    color: #1976d2;
}

.info-box ul {
    margin-bottom: 0;
}

/* Migration Guide */
.migration-guide {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 2rem;
    margin: 1rem 0;
}

.migration-old, .migration-new {
    padding: 1rem;
    border-radius: 0.5rem;
}

.migration-old {
    background: #ffebee;
    border-left: 4px solid #f44336;
}

.migration-new {
    background: #e8f5e8;
    border-left: 4px solid #4caf50;
}

.migration-old h4 {
    color: #d32f2f;
    margin-bottom: 1rem;
}

.migration-new h4 {
    color: #388e3c;
    margin-bottom: 1rem;
}

/* API Documentation */
.api-method {
    background: var(--bg-light);
    border-radius: 0.5rem;
    padding: 1.5rem;
    margin: 1.5rem 0;
    border-left: 4px solid var(--primary-color, #2196f3);
}

.api-method h4 {
    margin-bottom: 0.5rem;
    font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
    color: var(--primary-color, #2196f3);
}

.api-method p {
    margin-bottom: 0.75rem;
}

.api-method p:last-of-type {
    margin-bottom: 1rem;
}

/* Lifecycle Diagrams */
.lifecycle-diagram {
    display: flex;
    flex-direction: column;
    gap: 1rem;
    margin: 2rem 0;
    position: relative;
}

.lifecycle-step {
    display: flex;
    align-items: flex-start;
    gap: 1rem;
    padding: 1rem;
    background: var(--bg-light);
    border-radius: 0.5rem;
    position: relative;
}

.lifecycle-step:not(:last-child)::after {
    content: '';
    position: absolute;
    left: 1.75rem;
    bottom: -0.5rem;
    width: 2px;
    height: 0.5rem;
    background: var(--primary-color, #2196f3);
    z-index: 1;
}

.step-number {
    background: var(--primary-color, #2196f3);
    color: white;
    width: 2rem;
    height: 2rem;
    border-radius: 50%;
    display: flex;
    align-items: center;
    justify-content: center;
    font-weight: bold;
    font-size: 0.875rem;
    flex-shrink: 0;
}

.step-content h4 {
    margin-bottom: 0.25rem;
    color: var(--text-color);
}

.step-content p {
    margin: 0;
    color: var(--text-light);
    font-size: 0.9rem;
}

.step-content code {
    background: var(--code-bg, #f5f5f5);
    padding: 0.125rem 0.25rem;
    border-radius: 0.25rem;
    font-size: 0.8rem;
}

/* Troubleshooting */
.troubleshooting-item {
    background: var(--bg-light);
    border-radius: 0.5rem;
    padding: 1.5rem;
    margin: 1.5rem 0;
    border-left: 4px solid #ff9800;
}

.troubleshooting-item h4 {
    margin-bottom: 0.75rem;
    color: #e65100;
}

.error-example {
    background: #fff3e0;
    border: 1px solid #ffcc02;
    border-radius: 0.25rem;
    padding: 0.75rem;
    margin: 0.75rem 0;
    font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
    font-size: 0.875rem;
    color: #bf360c;
}

.troubleshooting-item p {
    margin-bottom: 0.75rem;
}

.troubleshooting-item .code-block {
    margin-top: 0.75rem;
}

/* Workflow Steps */
.workflow-steps {
    display: grid;
    gap: 1.5rem;
    margin: 1.5rem 0;
}

.workflow-step {
    background: var(--bg-light);
    border: 1px solid var(--border-light);
    border-radius: 0.5rem;
    padding: 1.5rem;
}

.workflow-step h4 {
    margin: 0 0 1rem 0;
    color: var(--text-primary);
}

/* Benefit Items */
.benefit-item {
    background: var(--bg-light);
    padding: 1.5rem;
    border-radius: 0.5rem;
    text-align: center;
}

.benefit-item h4 {
    margin-bottom: 0.5rem;
    font-size: 1.1rem;
}

.benefit-item p {
    margin: 0;
    color: var(--text-light);
    font-size: 0.9rem;
}

/* Button Styles */
.btn {
    display: inline-flex;
    align-items: center;
    padding: 0.75rem 1.5rem;
    border: none;
    border-radius: 0.5rem;
    font-weight: 500;
    text-decoration: none;
    cursor: pointer;
    transition: all 0.2s;
}

.btn-primary {
    background: var(--primary-color);
    color: white;
}

.btn-primary:hover {
    background: var(--accent-color);
}

.btn-outline {
    background: transparent;
    color: var(--primary-color);
    border: 1px solid var(--primary-color);
}

.btn-outline:hover {
    background: var(--primary-color);
    color: white;
}

.next-steps {
    display: flex;
    gap: 1rem;
    flex-wrap: wrap;
    margin-top: 1rem;
}

/* ==========================================================================
   MOBILE NAVIGATION
   ========================================================================== */

/* Mobile Menu Toggle Button */
.mobile-menu-toggle {
    display: none;
    flex-direction: column;
    justify-content: space-around;
    width: 30px;
    height: 30px;
    background: transparent;
    border: none;
    cursor: pointer;
    padding: 0;
    z-index: 1001;
    transition: transform 0.3s ease;
}

.mobile-menu-toggle span {
    display: block;
    height: 3px;
    width: 100%;
    background: var(--fiber-text);
    border-radius: 3px;
    transition: all 0.3s ease;
    transform-origin: center;
}

.mobile-menu-toggle.active span:nth-child(1) {
    transform: rotate(45deg) translate(6px, 6px);
}

.mobile-menu-toggle.active span:nth-child(2) {
    opacity: 0;
}

.mobile-menu-toggle.active span:nth-child(3) {
    transform: rotate(-45deg) translate(6px, -6px);
}

/* Mobile Overlay */
.mobile-overlay {
    display: none;
    position: fixed;
    top: 0;
    left: 0;
    width: 100%;
    height: 100%;
    background: rgba(0, 0, 0, 0.5);
    z-index: 999;
    opacity: 0;
    transition: opacity 0.3s ease;
    pointer-events: none;
}

.mobile-overlay.active {
    opacity: 1;
    pointer-events: auto;
}

/* Sidebar Wrapper for Mobile */
.docs-sidebar-wrapper {
    transition: transform 0.3s ease;
}

/* Responsive Design Updates */
@media (max-width: 768px) {
    /* Show mobile toggle button */
    .mobile-menu-toggle {
        display: flex;
    }

    /* Show mobile overlay */
    .mobile-overlay {
        display: block;
    }

    /* Hide desktop nav links on mobile */
    .nav-links {
        display: none;
    }

    /* Sidebar mobile styles */
    .docs-sidebar-wrapper {
        position: fixed;
        top: 0;
        left: 0;
        height: 100vh;
        width: 280px;
        z-index: 1000;
        transform: translateX(-100%);
        background: white;
        border-right: 1px solid var(--fiber-border);
        overflow-y: auto;
        padding-top: 80px; /* Account for nav height */
        box-shadow: 2px 0 10px rgba(0, 0, 0, 0.1);
    }

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

    /* Adjust docs content for mobile */
    .docs-content {
        margin-left: 0;
        width: 100%;
        padding: 1rem;
    }

    /* Docs layout adjustments */
    .docs-layout {
        display: block;
    }

    /* Navigation container adjustments */
    .nav-container {
        justify-content: space-between;
        padding: 0 1rem;
    }

    /* Logo adjustments for mobile */
    .logo span {
        display: none;
    }

    /* Other responsive adjustments */
    .migration-guide {
        grid-template-columns: 1fr;
    }
    
    .next-steps {
        flex-direction: column;
    }

    .building-block-progression {
        flex-direction: column;
    }

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

    .next-steps-grid {
        grid-template-columns: 1fr;
    }

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

    .component-grid,
    .components-grid {
        grid-template-columns: 1fr;
    }

    .config-sections {
        grid-template-columns: 1fr;
    }

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

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

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

@media (max-width: 480px) {
    .component-card,
    .provider-card,
    .next-step-card,
    .feature-card,
    .example-card,
    .agent-card {
        padding: 1rem;
    }

    .info-blurb,
    .provider-note,
    .cli-options {
        padding: 1rem;
    }

    /* Smaller sidebar on very small screens */
    .docs-sidebar-wrapper {
        width: 260px;
    }

    /* Tighter content padding */
    .docs-content {
        padding: 0.5rem;
    }
}

/* ========================================
   Screenshot Placeholders & New Components
   ======================================== */

/* Screenshot Placeholders */
.screenshot-placeholder {
    background: #f8f9fa;
    border: 2px dashed #dee2e6;
    border-radius: 8px;
    margin: 1.5rem 0;
    overflow: hidden;
    transition: all 0.2s ease;
}

.screenshot-placeholder:hover {
    border-color: #007bff;
    background: #f0f8ff;
}

.screenshot-header {
    display: flex;
    align-items: center;
    gap: 0.5rem;
    padding: 0.75rem 1rem;
    background: #e9ecef;
    border-bottom: 1px solid #dee2e6;
    font-weight: 600;
    color: #495057;
}

.screenshot-icon {
    font-size: 1.1rem;
}

.screenshot-content {
    padding: 1rem;
}

.screenshot-content p {
    margin: 0 0 1rem 0;
    color: #6c757d;
    font-style: italic;
}

/* Mockup Components */
.placeholder-mockup {
    background: white;
    border: 1px solid #e9ecef;
    border-radius: 6px;
    overflow: hidden;
    min-height: 120px;
    display: flex;
    align-items: center;
    justify-content: center;
}

.mockup-chat {
    width: 100%;
    max-width: 400px;
    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
}

.mockup-message {
    margin: 0.5rem;
    padding: 0.75rem 1rem;
    border-radius: 18px;
    max-width: 80%;
    font-size: 0.9rem;
    line-height: 1.4;
}

.mockup-message.user {
    background: #007bff;
    color: white;
    margin-left: auto;
    text-align: right;
}

.mockup-message.assistant {
    background: #f1f3f4;
    color: #333;
    margin-right: auto;
}

.mockup-devtools {
    font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
    background: #1e1e1e;
    color: #d4d4d4;
    padding: 1rem;
    border-radius: 4px;
    width: 100%;
}

.console-line {
    margin: 0.25rem 0;
    font-size: 0.85rem;
}

.console-line::before {
    content: '> ';
    color: #569cd6;
}

.mockup-browser {
    width: 100%;
    border: 1px solid #dee2e6;
    border-radius: 8px;
    overflow: hidden;
}

.browser-header {
    background: #f8f9fa;
    padding: 0.5rem 1rem;
    border-bottom: 1px solid #dee2e6;
    font-size: 0.85rem;
    color: #6c757d;
}

.marketplace-grid {
    padding: 1rem;
    display: grid;
    gap: 1rem;
}

.app-card {
    border: 1px solid #e9ecef;
    border-radius: 6px;
    padding: 1rem;
    text-align: center;
    transition: all 0.2s ease;
}

.app-card.highlighted {
    border-color: #007bff;
    background: #f0f8ff;
    box-shadow: 0 2px 8px rgba(0, 123, 255, 0.15);
}

.app-icon {
    font-size: 2rem;
    margin-bottom: 0.5rem;
}

.app-name {
    font-weight: 600;
    margin-bottom: 0.25rem;
}

.app-desc {
    font-size: 0.85rem;
    color: #6c757d;
    margin-bottom: 0.75rem;
}

.launch-btn {
    background: #007bff;
    color: white;
    border: none;
    padding: 0.5rem 1rem;
    border-radius: 4px;
    font-size: 0.85rem;
    cursor: pointer;
}

.launch-btn:hover {
    background: #0056b3;
}

.mockup-chat-app {
    display: flex;
    height: 300px;
    border: 1px solid #e9ecef;
    border-radius: 8px;
    overflow: hidden;
    width: 100%;
}

.chat-sidebar {
    width: 180px;
    background: #f8f9fa;
    border-right: 1px solid #e9ecef;
    padding: 0.75rem;
}

.new-chat-btn {
    width: 100%;
    background: #007bff;
    color: white;
    border: none;
    padding: 0.5rem;
    border-radius: 4px;
    margin-bottom: 0.75rem;
    font-size: 0.85rem;
    cursor: pointer;
}

.new-chat-btn.highlighted {
    box-shadow: 0 0 0 3px rgba(0, 123, 255, 0.25);
}

.chat-list-empty {
    color: #6c757d;
    font-size: 0.8rem;
    text-align: center;
    font-style: italic;
}

.chat-item {
    padding: 0.5rem;
    border-radius: 4px;
    margin-bottom: 0.25rem;
    font-size: 0.85rem;
    cursor: pointer;
    white-space: nowrap;
    overflow: hidden;
    text-overflow: ellipsis;
}

.chat-item.active {
    background: #007bff;
    color: white;
}

.chat-main {
    flex: 1;
    display: flex;
    flex-direction: column;
}

.empty-state {
    flex: 1;
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
    text-align: center;
    padding: 2rem;
}

.empty-state h3 {
    margin: 0 0 0.5rem 0;
    color: #495057;
}

.empty-state p {
    margin: 0;
    color: #6c757d;
    font-size: 0.9rem;
}

.chat-header {
    padding: 0.75rem 1rem;
    border-bottom: 1px solid #e9ecef;
    display: flex;
    align-items: center;
    justify-content: space-between;
}

.chat-header h3 {
    margin: 0;
    font-size: 1rem;
    color: #495057;
}

.provider-badge {
    background: #e9ecef;
    color: #495057;
    padding: 0.25rem 0.5rem;
    border-radius: 12px;
    font-size: 0.75rem;
}

.chat-messages {
    flex: 1;
    padding: 1rem;
    overflow-y: auto;
}

.chat-messages-empty {
    flex: 1;
}

.message {
    margin-bottom: 1rem;
    max-width: 80%;
}

.message.user {
    margin-left: auto;
}

.message.assistant {
    margin-right: auto;
}

.message-content {
    padding: 0.75rem 1rem;
    border-radius: 18px;
    line-height: 1.4;
    font-size: 0.9rem;
}

.message.user .message-content {
    background: #007bff;
    color: white;
}

.message.assistant .message-content {
    background: #f1f3f4;
    color: #333;
}

.message-meta {
    font-size: 0.75rem;
    color: #6c757d;
    margin-top: 0.25rem;
    padding: 0 1rem;
}

.chat-input {
    padding: 0.75rem 1rem;
    border-top: 1px solid #e9ecef;
    display: flex;
    gap: 0.5rem;
    align-items: center;
}

.chat-input.highlighted {
    box-shadow: inset 0 0 0 2px rgba(0, 123, 255, 0.25);
}

.chat-input input {
    flex: 1;
    border: 1px solid #e9ecef;
    border-radius: 20px;
    padding: 0.5rem 1rem;
    font-size: 0.9rem;
    outline: none;
}

.chat-input input:focus {
    border-color: #007bff;
}

.send-btn {
    background: #007bff;
    color: white;
    border: none;
    border-radius: 50%;
    width: 36px;
    height: 36px;
    cursor: pointer;
    display: flex;
    align-items: center;
    justify-content: center;
}

.send-btn:hover {
    background: #0056b3;
}

/* File Structure Display */
.file-structure {
    margin: 1.5rem 0;
}

.file-structure h3 {
    margin-bottom: 1rem;
    color: #495057;
}

/* Manifest Explanation Grid */
.manifest-explanation {
    margin: 2rem 0;
}

.explanation-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
    gap: 1rem;
    margin-top: 1rem;
}

.explanation-item {
    background: #f8f9fa;
    border: 1px solid #e9ecef;
    border-radius: 6px;
    padding: 1rem;
}

.explanation-item h5 {
    margin: 0 0 0.5rem 0;
    color: #495057;
    font-size: 0.9rem;
}

.explanation-item p {
    margin: 0;
    font-size: 0.85rem;
    color: #6c757d;
    line-height: 1.4;
}

/* Code Explanation */
.code-explanation {
    background: #f8f9fa;
    border-left: 4px solid #007bff;
    padding: 1rem;
    margin: 1rem 0;
}

.code-explanation h4 {
    margin: 0 0 0.75rem 0;
    color: #495057;
    font-size: 1rem;
}

.code-explanation ul {
    margin: 0;
    padding-left: 1.25rem;
}

.code-explanation li {
    margin-bottom: 0.5rem;
    color: #495057;
    font-size: 0.9rem;
    line-height: 1.4;
}

/* Storage Overview */
.storage-overview {
    margin: 2rem 0;
}

.storage-section {
    margin-bottom: 2rem;
    border: 1px solid #e9ecef;
    border-radius: 8px;
    overflow: hidden;
}

.storage-section h4 {
    background: #f8f9fa;
    margin: 0;
    padding: 1rem;
    border-bottom: 1px solid #e9ecef;
    color: #495057;
}

.storage-section p {
    margin: 0 0 1rem 0;
    padding: 0 1rem;
    padding-top: 1rem;
    color: #6c757d;
}

.storage-section ul {
    margin: 0;
    padding: 0 1rem 1rem 1rem;
    list-style: none;
}

.storage-section li {
    padding: 0.25rem 0;
    color: #495057;
    font-size: 0.9rem;
}

.storage-section li::before {
    content: '✓ ';
    color: #28a745;
    font-weight: bold;
}

/* SDK Examples Grid */
.sdk-examples-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(400px, 1fr));
    gap: 1.5rem;
    margin: 2rem 0;
}

.sdk-example {
    border: 1px solid #e9ecef;
    border-radius: 8px;
    overflow: hidden;
}

/* Activation Record Example */
.activation-record-example {
    margin: 2rem 0;
    border: 1px solid #e9ecef;
    border-radius: 8px;
    overflow: hidden;
}

.activation-record-example h4 {
    background: #f8f9fa;
    margin: 0;
    padding: 1rem;
    border-bottom: 1px solid #e9ecef;
    color: #495057;
}

.activation-record-example p {
    margin: 0;
    padding: 1rem;
    color: #6c757d;
}

/* SDK Integration Note */
.sdk-integration-note {
    background: #e8f5e8;
    border: 1px solid #c3e6c3;
    border-radius: 6px;
    padding: 1rem;
    margin: 2rem 0;
}

.sdk-integration-note h4 {
    margin: 0 0 0.75rem 0;
    color: #155724;
}

.sdk-integration-note ul {
    margin: 0;
    padding-left: 1.25rem;
}

.sdk-integration-note li {
    margin-bottom: 0.5rem;
    color: #155724;
    font-size: 0.9rem;
    line-height: 1.4;
}

/* Implementation Patterns */
.implementation-patterns {
    margin: 2rem 0;
}

.patterns-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
    gap: 1rem;
    margin-top: 1rem;
}

.pattern-item {
    background: #f8f9fa;
    border: 1px solid #e9ecef;
    border-radius: 6px;
    padding: 1rem;
}

.pattern-item h4 {
    margin: 0 0 0.5rem 0;
    color: #495057;
    font-size: 0.9rem;
}

.pattern-item p {
    margin: 0 0 0.75rem 0;
    font-size: 0.85rem;
    color: #6c757d;
    line-height: 1.4;
}

.code-snippet {
    background: #2d3748;
    color: #e2e8f0;
    padding: 0.5rem;
    border-radius: 4px;
    font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
    font-size: 0.8rem;
}

/* Usage Walkthrough */
.usage-walkthrough {
    margin: 2rem 0;
}

.walkthrough-step {
    margin-bottom: 2rem;
    border: 1px solid #e9ecef;
    border-radius: 8px;
    overflow: hidden;
}

.step-header {
    background: #f8f9fa;
    padding: 1rem;
    border-bottom: 1px solid #e9ecef;
    display: flex;
    align-items: center;
    gap: 0.75rem;
}

.step-number {
    background: #007bff;
    color: white;
    width: 28px;
    height: 28px;
    border-radius: 50%;
    display: flex;
    align-items: center;
    justify-content: center;
    font-weight: bold;
    font-size: 0.9rem;
}

.step-header h4 {
    margin: 0;
    color: #495057;
}

.walkthrough-step > p {
    margin: 0;
    padding: 1rem;
    color: #6c757d;
}

/* Troubleshooting Section */
.troubleshooting-section {
    margin: 2rem 0;
    padding: 1.5rem;
    background: #fff3cd;
    border: 1px solid #ffeaa7;
    border-radius: 8px;
}

.troubleshooting-section h3 {
    margin: 0 0 1rem 0;
    color: #856404;
}

.troubleshooting-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
    gap: 1rem;
}

.issue-card {
    background: white;
    border: 1px solid #ffeaa7;
    border-radius: 6px;
    padding: 1rem;
}

.issue-card h4 {
    margin: 0 0 0.5rem 0;
    color: #856404;
    font-size: 0.95rem;
}

.issue-card p {
    margin: 0.25rem 0;
    font-size: 0.85rem;
    line-height: 1.4;
}

.issue-card p strong {
    color: #495057;
}

/* Responsive adjustments for new components */
@media (max-width: 768px) {
    .explanation-grid,
    .patterns-grid,
    .troubleshooting-grid {
        grid-template-columns: 1fr;
    }

    .sdk-examples-grid {
        grid-template-columns: 1fr;
    }

    .mockup-chat-app {
        height: 250px;
    }

    .chat-sidebar {
        width: 140px;
    }

    .step-header {
        flex-direction: column;
        align-items: flex-start;
        gap: 0.5rem;
    }

    .step-number {
        align-self: flex-start;
    }
}

@media (max-width: 480px) {
    .mockup-chat-app {
        flex-direction: column;
        height: auto;
    }

    .chat-sidebar {
        width: 100%;
        border-right: none;
        border-bottom: 1px solid #e9ecef;
    }

    .pattern-item,
    .explanation-item,
    .issue-card {
        padding: 0.75rem;
    }
}