/* ==========================================================================
   layouts/app-page.css — Main content page shell
   --------------------------------------------------------------------------
   The outermost wrapper for a page's main content: an intro block with the
   page heading, then a stack of sections. Sits inside #main / .main-content.

   Markup contract:
     .app-page                          (vertical stack)
       .app-page__intro
         .app-page__title
         .app-page__desc
         .app-page__actions             (optional, right-aligned)
       .app-page__section[id]
         .app-page__section-title
         .app-page__section-desc
         (…section content…)
       .app-page__divider               (optional rule between sections)
   ========================================================================== */

/* ========== CONTAINER ========== */

.app-page {
    display: flex;
    flex-direction: column;
    gap: var(--spacing-2xl);
    padding: var(--spacing-xl);
}

/* ========== INTRO ========== */

.app-page__intro {
    display: flex;
    flex-wrap: wrap;
    align-items: flex-start;
    justify-content: space-between;
    gap: var(--spacing-md);
    padding-bottom: var(--spacing-xl);
    border-bottom: 1px solid var(--color-border-subtle);
}

/* Title + description stack together, actions sit opposite them */
.app-page__intro > .app-page__title,
.app-page__intro > .app-page__desc {
    flex: 1 1 100%;
}

.app-page__title {
    font-family: var(--font-family-primary);
    font-size: var(--font-display-xl-size);
    font-weight: var(--font-display-xl-weight);
    line-height: var(--font-display-xl-line-height);
    letter-spacing: var(--font-display-xl-letter-spacing);
    color: var(--color-text-default);
    margin: 0;
}

.app-page__desc {
    font-size: var(--font-body-lg-size);
    line-height: var(--font-body-lg-line-height);
    color: var(--color-text-muted);
    max-width: 64ch;
    margin: 0;
}

.app-page__actions {
    display: flex;
    align-items: center;
    gap: var(--spacing-sm);
    flex: 0 0 auto;
    margin-left: auto;
}

/* When actions are present they share the first row with the title */
.app-page__intro:has(> .app-page__actions) > .app-page__title {
    flex: 1 1 auto;
}

/* ========== SECTIONS ========== */

.app-page__section {
    display: flex;
    flex-direction: column;
    gap: var(--spacing-lg);
    scroll-margin-top: var(--spacing-2xl);
}

.app-page__section-title {
    font-family: var(--font-family-primary);
    font-size: var(--font-display-sm-size);
    font-weight: var(--font-display-sm-weight);
    line-height: var(--font-display-sm-line-height);
    letter-spacing: var(--font-display-sm-letter-spacing);
    color: var(--color-text-default);
    margin: 0;
}

.app-page__section-desc {
    font-size: var(--font-body-sm-size);
    line-height: var(--font-body-sm-line-height);
    color: var(--color-text-muted);
    max-width: 72ch;
    margin: 0;
}

/* Title and description belong together — tighten the section's stack gap between them */
.app-page__section-title + .app-page__section-desc {
    margin-top: calc(var(--spacing-xs) - var(--spacing-lg));
}

/* ========== DIVIDER ========== */

.app-page__divider {
    height: 1px;
    background: var(--color-border-subtle);
    border: 0;
    margin: 0;
}

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

@media (max-width: 640px) {
    .app-page {
        padding: var(--spacing-md);
        gap: var(--spacing-xl);
    }

    .app-page__actions {
        margin-left: 0;
    }
}
