/* ==========================================================================
   Atelier How-To Guide Pages — guides.css
   Requires: theme-variables.css, tool-layout.css
   ========================================================================== */

/* ---------- Page Container ---------- */
.guide-page {
    max-width: 820px;
    margin: 0 auto;
    padding: var(--space-2xl) var(--space-xl);
    padding-top: calc(60px + var(--space-2xl)); /* account for fixed nav */
}

/* ---------- Breadcrumb ---------- */
.guide-breadcrumb {
    display: flex;
    gap: var(--space-sm);
    align-items: center;
    font-size: 14px;
    color: var(--text-muted);
    margin-bottom: var(--space-2xl);
}

.guide-breadcrumb a {
    color: var(--text-secondary);
    text-decoration: none;
}

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

.guide-breadcrumb span {
    color: var(--text-muted);
}

/* ---------- Page Header ---------- */
.guide-header {
    margin-bottom: var(--space-2xl);
}

.guide-header h1 {
    font-size: 2rem;
    font-weight: 700;
    color: var(--text-primary);
    margin: 0 0 var(--space-md) 0;
    line-height: 1.25;
}

.guide-header .guide-desc {
    font-size: 1.1rem;
    color: var(--text-secondary);
    line-height: 1.7;
    margin: 0 0 var(--space-lg) 0;
}

.guide-meta {
    display: flex;
    gap: var(--space-xl);
    flex-wrap: wrap;
    font-size: 0.875rem;
    color: var(--text-muted);
}

/* ---------- Table of Contents ---------- */
.guide-toc {
    background: var(--bg-secondary);
    border: 1px solid var(--border-default);
    border-radius: var(--radius-lg);
    padding: var(--space-xl) var(--space-2xl);
    margin-bottom: var(--space-2xl);
}

.guide-toc h2 {
    font-size: 0.875rem;
    font-weight: 600;
    color: var(--text-secondary);
    text-transform: uppercase;
    letter-spacing: 0.5px;
    margin: 0 0 var(--space-md) 0;
}

.guide-toc ol {
    margin: 0;
    padding-left: var(--space-xl);
}

.guide-toc li {
    margin-bottom: var(--space-sm);
}

.guide-toc a {
    color: var(--color-primary);
    text-decoration: none;
    font-size: 0.9rem;
}

.guide-toc a:hover {
    text-decoration: underline;
}

/* ---------- Sections ---------- */
.guide-section {
    margin-bottom: var(--space-2xl);
    padding-bottom: var(--space-2xl);
    border-bottom: 1px solid var(--border-default);
}

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

.guide-section-title {
    font-size: 1.25rem;
    font-weight: 600;
    color: var(--text-primary);
    margin: 0 0 var(--space-xl) 0;
    padding-bottom: var(--space-md);
    border-bottom: 2px solid var(--color-primary);
}

/* ---------- Quick Start Panel ---------- */
.guide-quick-start {
    background: var(--bg-secondary);
    border: 1px solid var(--border-default);
    border-left: 4px solid var(--color-primary);
    border-radius: var(--radius-md);
    padding: var(--space-xl);
}

.guide-quick-start p {
    color: var(--text-secondary);
    line-height: 1.7;
    margin: 0 0 var(--space-md) 0;
}

.guide-quick-start ol {
    padding-left: var(--space-xl);
    color: var(--text-secondary);
    line-height: 1.9;
    margin: 0 0 var(--space-xl) 0;
}

/* ---------- Step List ---------- */
.guide-step-list {
    display: flex;
    flex-direction: column;
    gap: var(--space-lg);
    margin-bottom: var(--space-xl);
}

.guide-step {
    display: flex;
    gap: var(--space-lg);
    background: var(--bg-secondary);
    border: 1px solid var(--border-default);
    border-radius: var(--radius-lg);
    padding: var(--space-xl);
}

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

.guide-step-content h3 {
    color: var(--text-primary);
    font-size: 1rem;
    font-weight: 600;
    margin: 0 0 var(--space-sm) 0;
}

.guide-step-content p {
    color: var(--text-secondary);
    line-height: 1.6;
    margin: 0 0 var(--space-md) 0;
}

.guide-step-tip {
    background: var(--bg-tertiary);
    border-left: 3px solid var(--color-success);
    border-radius: var(--radius-sm);
    padding: var(--space-sm) var(--space-md);
    font-size: 0.875rem;
    color: var(--text-secondary);
}

.guide-step-tip strong {
    color: var(--color-success);
}

/* ---------- FAQ List ---------- */
.guide-faq-list {
    display: flex;
    flex-direction: column;
    gap: var(--space-md);
}

.guide-faq-item {
    background: var(--bg-secondary);
    border: 1px solid var(--border-default);
    border-radius: var(--radius-md);
    padding: var(--space-xl);
}

.guide-faq-item:hover {
    border-color: var(--color-primary);
}

.guide-faq-item h3 {
    font-size: 1rem;
    font-weight: 600;
    color: var(--text-primary);
    margin: 0 0 var(--space-sm) 0;
}

.guide-faq-item p {
    color: var(--text-secondary);
    line-height: 1.6;
    margin: 0;
}

/* ---------- Related Tools Grid ---------- */
.guide-related-grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
    gap: var(--space-md);
}

.guide-related-card {
    padding: var(--space-lg);
    background: var(--bg-secondary);
    border: 1px solid var(--border-default);
    border-radius: var(--radius-lg);
    text-decoration: none;
    color: var(--text-primary);
    display: block;
    transition: border-color 0.2s, background 0.2s;
}

.guide-related-card:hover {
    border-color: var(--color-primary);
    background: var(--bg-tertiary);
}

.guide-related-card strong {
    display: block;
    font-size: 0.95rem;
    margin-bottom: var(--space-xs);
}

.guide-related-card small {
    display: block;
    font-size: 0.8rem;
    color: var(--text-muted);
    line-height: 1.4;
}

/* ---------- CTA Banner ---------- */
.guide-cta-banner {
    background: var(--bg-secondary);
    border: 1px solid var(--border-default);
    border-radius: var(--radius-xl);
    padding: var(--space-2xl) var(--space-xl);
    text-align: center;
    margin-top: var(--space-2xl);
}

.guide-cta-banner h2 {
    font-size: 1.5rem;
    font-weight: 700;
    color: var(--text-primary);
    margin: 0 0 var(--space-md) 0;
}

.guide-cta-banner p {
    color: var(--text-secondary);
    margin: 0 0 var(--space-xl) 0;
}

/* ---------- Primary Button ---------- */
.guide-btn-primary {
    display: inline-flex;
    align-items: center;
    gap: var(--space-sm);
    padding: 14px 28px;
    background: var(--color-primary);
    color: #fff;
    text-decoration: none;
    border-radius: var(--radius-lg);
    font-weight: 600;
    font-size: 1rem;
    transition: background 0.2s, transform 0.2s;
}

.guide-btn-primary:hover {
    background: var(--color-primary-hover);
    transform: translateY(-2px);
}

/* ---------- Section Lead Text ---------- */
.guide-section-lead {
    color: var(--text-secondary);
    margin: 0 0 var(--space-xl) 0;
    line-height: 1.6;
}

/* ---------- Step CTA Row ---------- */
.guide-step-cta {
    margin-top: var(--space-xl);
    text-align: center;
}

/* ---------- Responsive ---------- */
@media (max-width: 640px) {
    .guide-page {
        padding: var(--space-xl) var(--space-lg);
        padding-top: calc(60px + var(--space-xl));
    }

    .guide-header h1 {
        font-size: 1.5rem;
    }

    .guide-step {
        flex-direction: column;
        gap: var(--space-md);
    }

    .guide-related-grid {
        grid-template-columns: 1fr;
    }

    .guide-toc {
        padding: var(--space-lg);
    }
}

/* ==========================================================================
   How-To Guide Page Layout Classes (from gen-guides-v2 template)
   ========================================================================== */

/* ---------- Guide Content Wrapper ---------- */
.guide-content {
    max-width: 800px;
    margin: 0 auto;
    padding: var(--space-xl) var(--space-lg);
}

/* ---------- Back Link ---------- */
.back-link {
    display: inline-flex;
    align-items: center;
    gap: var(--space-sm);
    color: var(--color-primary);
    text-decoration: none;
    font-weight: 500;
    margin-bottom: var(--space-xl);
}

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

.back-link svg {
    width: 16px;
    height: 16px;
}

/* ---------- Section Title ---------- */
.section-title {
    font-size: 1.25rem;
    font-weight: 600;
    color: var(--text-primary);
    margin: var(--space-2xl) 0 var(--space-lg) 0;
    padding-bottom: var(--space-md);
    border-bottom: 2px solid var(--color-primary);
}

/* ---------- Guide Intro ---------- */
.guide-intro {
    color: var(--text-secondary);
    font-size: 1.1rem;
    line-height: 1.7;
    margin-bottom: var(--space-2xl);
}

/* ---------- Step List ---------- */
.step-list {
    display: flex;
    flex-direction: column;
    gap: var(--space-lg);
}

.step-item {
    display: flex;
    gap: var(--space-lg);
    background: var(--bg-secondary);
    border: 1px solid var(--border-default);
    border-radius: var(--radius-md);
    padding: var(--space-lg);
}

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

.step-content h3 {
    color: var(--text-primary);
    font-size: 1rem;
    font-weight: 600;
    margin: 0 0 var(--space-sm) 0;
}

.step-content p {
    color: var(--text-secondary);
    line-height: 1.6;
    margin: 0;
}

/* ---------- Tips Section ---------- */
.tips-section {
    background: var(--bg-secondary);
    border: 1px solid var(--border-default);
    border-left: 4px solid var(--color-primary);
    border-radius: var(--radius-md);
    padding: var(--space-xl);
    margin-top: var(--space-2xl);
}

.tips-section h2 {
    font-size: 1rem;
    font-weight: 600;
    color: var(--color-primary);
    margin: 0 0 var(--space-md) 0;
}

.tips-section ul {
    margin: 0;
    padding-left: var(--space-lg);
    color: var(--text-secondary);
    line-height: 1.8;
}

/* ---------- Related Links ---------- */
.related-links {
    display: flex;
    gap: var(--space-lg);
    flex-wrap: wrap;
    margin-top: var(--space-2xl);
    padding-top: var(--space-xl);
    border-top: 1px solid var(--border-default);
}

.related-link {
    display: inline-flex;
    align-items: center;
    gap: var(--space-sm);
    padding: var(--space-md) var(--space-lg);
    background: var(--bg-secondary);
    border: 1px solid var(--border-default);
    border-radius: var(--radius-md);
    color: var(--text-primary);
    text-decoration: none;
    font-weight: 500;
}

.related-link:hover {
    border-color: var(--color-primary);
    background: var(--bg-tertiary);
}

.related-link svg {
    width: 16px;
    height: 16px;
    color: var(--color-primary);
}

/* ---------- Try It Yourself Section ---------- */
.try-it-section {
    background: var(--bg-secondary);
    border: 1px solid var(--border-default);
    border-radius: var(--radius-md);
    padding: var(--space-xl);
    margin-top: var(--space-2xl);
    text-align: center;
}

.try-it-section h2 {
    font-size: 1.25rem;
    font-weight: 600;
    color: var(--text-primary);
    margin: 0 0 var(--space-md) 0;
}

.try-it-section p {
    color: var(--text-secondary);
    margin: 0 0 var(--space-lg) 0;
    line-height: 1.6;
}

/* ---------- Responsive ---------- */
@media (max-width: 640px) {
    .guide-content {
        padding: var(--space-lg) var(--space-md);
    }

    .step-item {
        flex-direction: column;
        gap: var(--space-md);
    }

    .related-links {
        flex-direction: column;
    }
}