/* =====================================================
   DOCUMENTATION PAGE STYLES (Minimal additions)
   Most styling uses existing classes from pages.css
   ===================================================== */

/* Documentation page container */
.documentation-page {
    padding: 2rem;
    min-height: 70vh;

    .info-item {
        text-align: center;

        h3, p {
            text-align: center;
        }
    }

    ol, ul {
        padding-left: 2rem;
        margin: 1rem 0;

        li {
            margin-bottom: 0.5rem;
        }
    }

    .page-section h3 {
        margin-top: 1.5rem;
    }
}

/* Step Header - numbered step indicator */
.step-header {
    display: flex;
    align-items: center;
    gap: 1rem;
    margin-bottom: 1rem;
}

.step-number {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 3rem;
    height: 3rem;
    background: var(--gradient-text);
    border-radius: 50%;
    font-size: 1.5rem;
    font-weight: 700;
    color: var(--color-background-1);
    flex-shrink: 0;
}

/* Info Boxes - callout boxes for tips/warnings */
.info-box {
    padding: 1rem 1.25rem;
    border-radius: var(--radius-sm);
    margin: 1.5rem 0;
    border-left: 4px solid;
}

.info-box-info {
    background: var(--color-decoration-light-alpha-10);
    border-color: var(--color-decoration-light);
    color: var(--text-color);
}

.info-box-warning {
    background: rgba(251, 191, 36, 0.1);
    border-color: rgb(251, 191, 36);
    color: var(--text-color);
}

.info-box-success {
    background: rgba(34, 197, 94, 0.1);
    border-color: rgb(34, 197, 94);
    color: var(--text-color);
}

/* Example Box - highlighted example */
.example-box {
    background: var(--white-alpha-05);
    padding: 1.25rem;
    border-radius: var(--radius-sm);
    border: 1px solid var(--color-decoration-light-alpha-30);
    margin: 1.5rem 0;
    line-height: 1.8;
}

/* FAQ accordion - native <details>/<summary>, no JS required */
.faq-item {
    margin-bottom: 0.75rem;
    padding: 0;
    overflow: hidden;

    summary {
        padding: 1rem 1.25rem;
        cursor: pointer;
        font-weight: 600;
        color: var(--text-color-light);
        list-style: none;

        &::-webkit-details-marker {
            display: none;
        }

        &::after {
            content: "+";
            float: right;
            color: var(--color-decoration-light);
            font-weight: 700;
        }
    }

    &[open] summary::after {
        content: "−";
    }
}

.faq-answer {
    padding: 0 1.25rem 1.25rem;
    color: var(--text-color);

    p {
        margin-bottom: 0.75rem;
    }

    p:last-child {
        margin-bottom: 0;
    }

    /* Hardware list of the FAQ: the description on the left, a visible purchase button aligned on the right. */
    .faq-hardware-list {
        list-style: none;
        padding-left: 0; /* wins over the documentation lists' indentation */
        margin: 0 0 0.75rem;

        li {
            display: flex;
            flex-wrap: wrap;
            align-items: center;
            justify-content: space-between;
            gap: 0.5rem 1rem;
            padding: 0.75rem 0;
            border-bottom: 1px solid var(--white-alpha-05);
        }

        li:last-child {
            border-bottom: none;
        }
    }
}

.faq-buy-link {
    flex-shrink: 0;
    white-space: nowrap;
}

/* Premium note - small badge for features gated behind a higher plan,
   mirrors the ".tag.premium" badge used in the ambience editor. */
.tag-premium-note {
    display: inline-flex;
    align-items: center;
    gap: 4px;
    padding: 1px 6px;
    font-size: 11px;
    font-weight: 600;
    letter-spacing: 0.02em;
    border-radius: 999px;
    background: rgba(251, 191, 36, 0.12);
    color: rgb(251, 191, 36);
    border: 1px solid rgba(251, 191, 36, 0.3);
    vertical-align: middle;

    &::before {
        content: "👑";
    }
}

/* Lead paragraph - larger intro text */
.lead {
    font-size: 1.1rem;
    line-height: 1.8;
    color: var(--text-color);
    margin-bottom: 1.5rem;
}