/* ════════════════════════════════════════════════════════════════════
   PF DESIGN SYSTEM — Modal Component
   ────────────────────────────────────────────────────────────────────
   Centered floating dialog. Used for confirmations, focused tasks,
   add-section pickers, template choosers.

   Differs from .pf-drawer in:
     • Centered (vs slide-in from edge)
     • Bounded width (max-width — never full-screen except --full)
     • Stronger backdrop (modal blocks the underlying UI more emphatically)
     • Smaller default size — modals are for focused tasks

   USAGE
     <div class="pf-modal-overlay" data-pf-modal-open>
       <div class="pf-modal-overlay__backdrop" data-pf-modal-close></div>
       <div class="pf-modal" role="dialog" aria-modal="true"
            aria-labelledby="modal-title">
         <header class="pf-modal__header">
           <h2 id="modal-title" class="pf-modal__title">Confirm action</h2>
           <button class="pf-modal__close" data-pf-modal-close aria-label="Close">×</button>
         </header>
         <div class="pf-modal__body">
           <p>Are you sure you want to delete this section?</p>
         </div>
         <footer class="pf-modal__footer">
           <button class="pf-button pf-button--ghost" data-pf-modal-close>Cancel</button>
           <button class="pf-button pf-button--danger">Delete</button>
         </footer>
       </div>
     </div>

     <!-- Sizes -->
     <div class="pf-modal pf-modal--sm">…</div>     <!-- 400px max -->
     <div class="pf-modal pf-modal--md">…</div>     <!-- 640px max (default) -->
     <div class="pf-modal pf-modal--lg">…</div>     <!-- 800px max -->
     <div class="pf-modal pf-modal--xl">…</div>     <!-- 1024px max -->
     <div class="pf-modal pf-modal--full">…</div>   <!-- 95vw max -->

   ACCESSIBILITY
     • role="dialog" + aria-modal="true" required
     • aria-labelledby points to modal title
     • Focus moves into modal on open (JS responsibility)
     • Esc key closes modal (JS responsibility)
     • Focus trap while open (JS responsibility)
     • Backdrop click closes (data-pf-modal-close — confirm before destructive)
     • Returns focus to trigger element on close (JS responsibility)
     • For destructive confirmations, primary button = .pf-button--danger
       and Cancel = ghost variant (so danger gets visual emphasis)

   Version: 1.0.0
   Last revised: 2026-05-10
   ──────────────────────────────────────────────────────────────────── */

/* ─── Block: .pf-modal-overlay (positioning + backdrop) ──────── */

.pf-modal-overlay {
    position: fixed;
    inset: 0;
    z-index: var(--pf-modal-z-index);
    display: flex;
    align-items: center;
    justify-content: center;
    padding: var(--pf-space-4);
    pointer-events: none;
}

.pf-modal-overlay[data-pf-modal-open] {
    pointer-events: auto;
}

.pf-modal-overlay[hidden] { display: none; }

/* ─── Element: __backdrop ────────────────────────────────────── */

.pf-modal-overlay__backdrop {
    position: absolute;
    inset: 0;
    background: var(--pf-modal-backdrop);
    opacity: 0;
    transition: opacity var(--pf-motion-duration-base) var(--pf-motion-ease-out);
    cursor: pointer;
}

.pf-modal-overlay[data-pf-modal-open] .pf-modal-overlay__backdrop {
    opacity: 1;
}

/* ─── Block: .pf-modal (the dialog itself) ────────────────────── */

.pf-modal {
    position: relative;
    display: flex;
    flex-direction: column;
    width: 100%;
    max-width: var(--pf-modal-max-width);
    max-height: calc(100vh - var(--pf-space-8) * 2);
    background: var(--pf-modal-bg);
    color: var(--pf-modal-fg);
    border: 1px solid var(--pf-modal-border);
    border-radius: var(--pf-modal-radius);
    box-shadow: var(--pf-modal-shadow);
    overflow: hidden;
    /* Entrance animation */
    transform: scale(0.95);
    opacity: 0;
    transition:
        transform var(--pf-motion-duration-base) var(--pf-motion-ease-emphasized),
        opacity var(--pf-motion-duration-base) var(--pf-motion-ease-out);
}

.pf-modal-overlay[data-pf-modal-open] .pf-modal {
    transform: scale(1);
    opacity: 1;
}

/* ─── Sizes ──────────────────────────────────────────────────── */

.pf-modal--sm   { max-width: 400px; }
.pf-modal--md   { max-width: 640px; } /* default */
.pf-modal--lg   { max-width: 800px; }
.pf-modal--xl   { max-width: 1024px; }
.pf-modal--full { max-width: 95vw; max-height: 95vh; }

/* ─── Element: __header ──────────────────────────────────────── */

.pf-modal__header {
    display: flex;
    align-items: flex-start;
    justify-content: space-between;
    gap: var(--pf-space-3);
    padding: var(--pf-modal-padding);
    padding-bottom: var(--pf-space-3);
    border-bottom: 1px solid var(--pf-modal-border);
    flex-shrink: 0;
}

.pf-modal__title {
    margin: 0;
    font-size: var(--pf-text-size-xl);
    font-weight: var(--pf-text-weight-semibold);
    color: var(--pf-color-text-primary);
    line-height: var(--pf-text-leading-snug);
}

.pf-modal__subtitle {
    margin: var(--pf-space-1) 0 0;
    font-size: var(--pf-text-size-sm);
    color: var(--pf-color-text-secondary);
    line-height: var(--pf-text-leading-normal);
}

.pf-modal__close {
    flex-shrink: 0;
    display: inline-flex;
    align-items: center;
    justify-content: center;
    width: 32px;
    height: 32px;
    background: transparent;
    color: var(--pf-color-text-secondary);
    border: 1px solid transparent;
    border-radius: var(--pf-radius-sm);
    cursor: pointer;
    font-size: 24px; /* Larger × character */
    line-height: 1;
    transition: background var(--pf-motion-duration-fast) var(--pf-motion-ease-out);
}

.pf-modal__close:hover,
.pf-modal__close:focus-visible {
    background: var(--pf-color-surface-hover);
    color: var(--pf-color-text-primary);
}

.pf-modal__close:focus-visible {
    outline: none;
    box-shadow: var(--pf-focus-ring);
}

/* ─── Element: __body (scrolling content area) ──────────────── */

.pf-modal__body {
    flex: 1;
    overflow-y: auto;
    padding: var(--pf-modal-padding);
    padding-top: var(--pf-space-4);
    padding-bottom: var(--pf-space-4);
}

.pf-modal__body > :first-child { margin-top: 0; }
.pf-modal__body > :last-child  { margin-bottom: 0; }

/* ─── Element: __footer ──────────────────────────────────────── */

.pf-modal__footer {
    display: flex;
    align-items: center;
    justify-content: flex-end;
    gap: var(--pf-space-2);
    padding: var(--pf-modal-padding);
    padding-top: var(--pf-space-3);
    padding-bottom: var(--pf-space-3);
    border-top: 1px solid var(--pf-modal-border);
    background: var(--pf-modal-bg);
    flex-shrink: 0;
}

.pf-modal__footer--start   { justify-content: flex-start; }
.pf-modal__footer--center  { justify-content: center; }
.pf-modal__footer--between { justify-content: space-between; }

/* ─── Reduced-motion respect ─────────────────────────────────── */

@media (prefers-reduced-motion: reduce) {
    .pf-modal-overlay__backdrop,
    .pf-modal {
        transition: opacity var(--pf-motion-duration-fast) linear;
        transform: none;
    }
}