/* ════════════════════════════════════════════════════════════════════
   PF DESIGN SYSTEM — Popover Component
   ────────────────────────────────────────────────────────────────────
   Anchored floating panel with optional arrow pointing to trigger
   element. Used for tooltips, menus, contextual hints, share-link UI.

   Differs from .pf-modal in:
     • Anchored to a trigger element (not centered on screen)
     • No backdrop — click outside closes (less intrusive)
     • Smaller typically — for quick contextual info or actions
     • Arrow pointing to trigger element (visual connection)

   USAGE
     <div class="pf-popover-anchor">
       <button class="pf-button" data-pf-popover-trigger>Open menu</button>
       <div class="pf-popover" role="dialog" aria-label="Menu" hidden>
         <div class="pf-popover__arrow" aria-hidden="true"></div>
         <div class="pf-popover__body">
           <button class="pf-popover__item">Edit</button>
           <button class="pf-popover__item">Duplicate</button>
           <button class="pf-popover__item pf-popover__item--danger">Delete</button>
         </div>
       </div>
     </div>

     <!-- Placement -->
     <div class="pf-popover pf-popover--top">…</div>     <!-- arrow points down -->
     <div class="pf-popover pf-popover--bottom">…</div>  <!-- arrow points up (default) -->
     <div class="pf-popover pf-popover--left">…</div>    <!-- arrow points right -->
     <div class="pf-popover pf-popover--right">…</div>   <!-- arrow points left -->

     <!-- Sizes -->
     <div class="pf-popover pf-popover--sm">…</div>      <!-- 200px max -->
     <div class="pf-popover pf-popover--md">…</div>      <!-- 320px max (default) -->
     <div class="pf-popover pf-popover--lg">…</div>      <!-- 480px max -->

     <!-- As tooltip (smaller, no body padding) -->
     <div class="pf-popover pf-popover--tooltip">Quick hint</div>

   ACCESSIBILITY
     • Anchor: aria-haspopup="dialog" + aria-expanded="true|false"
       + aria-controls="popover-id" on trigger
     • Popover: role="dialog" or role="menu" + aria-label
     • Esc key closes (JS responsibility)
     • Click outside closes (JS responsibility)
     • Tab cycles within (no focus trap — popovers are non-blocking)
     • Returns focus to trigger on close (JS responsibility)
     • Tooltip variant: role="tooltip" + aria-describedby on trigger

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

/* ─── Block: .pf-popover-anchor (relative positioning context) ── */

.pf-popover-anchor {
    position: relative;
    display: inline-block;
}

/* ─── Block: .pf-popover (the floating panel) ───────────────── */

.pf-popover {
    position: absolute;
    z-index: var(--pf-popover-z-index);
    display: flex;
    flex-direction: column;
    min-width: 160px;
    max-width: 320px;
    background: var(--pf-popover-bg);
    color: var(--pf-popover-fg);
    border: 1px solid var(--pf-popover-border);
    border-radius: var(--pf-popover-radius);
    box-shadow: var(--pf-popover-shadow);
    /* Default placement = bottom-aligned to anchor */
    top: calc(100% + var(--pf-space-2));
    left: 0;
    /* Entrance animation */
    opacity: 0;
    transform: translateY(-4px);
    transition:
        opacity var(--pf-motion-duration-fast) var(--pf-motion-ease-out),
        transform var(--pf-motion-duration-fast) var(--pf-motion-ease-out);
    pointer-events: none;
}

.pf-popover[data-pf-popover-open],
.pf-popover:not([hidden]) {
    opacity: 1;
    transform: translateY(0);
    pointer-events: auto;
}

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

/* ─── Element: __arrow (12px triangle pointing to anchor) ──── */

.pf-popover__arrow {
    position: absolute;
    width: var(--pf-popover-arrow-size);
    height: var(--pf-popover-arrow-size);
    background: var(--pf-popover-bg);
    border-top: 1px solid var(--pf-popover-border);
    border-left: 1px solid var(--pf-popover-border);
    transform: rotate(45deg);
    /* Default — pointing up (popover below anchor) */
    top: calc(var(--pf-popover-arrow-size) * -0.5 - 1px);
    left: var(--pf-space-3);
}

/* ─── Element: __body (content container with padding) ────── */

.pf-popover__body {
    padding: var(--pf-popover-padding);
    overflow-y: auto;
    max-height: 60vh;
}

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

/* ─── Element: __title (optional header) ────────────────────── */

.pf-popover__title {
    margin: 0 0 var(--pf-space-2);
    font-size: var(--pf-text-size-sm);
    font-weight: var(--pf-text-weight-semibold);
    color: var(--pf-color-text-primary);
}

/* ─── Element: __item (menu item / button row) ─────────────── */

.pf-popover__item {
    display: flex;
    align-items: center;
    gap: var(--pf-space-2);
    width: 100%;
    padding: var(--pf-space-2) var(--pf-space-3);
    background: transparent;
    color: var(--pf-color-text-primary);
    border: none;
    border-radius: var(--pf-radius-sm);
    font: inherit;
    font-size: var(--pf-text-size-sm);
    text-align: left;
    cursor: pointer;
    transition: background var(--pf-motion-duration-fast) var(--pf-motion-ease-out);
}

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

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

.pf-popover__item--danger {
    color: var(--pf-color-status-danger-fg);
}

.pf-popover__item--danger:hover,
.pf-popover__item--danger:focus-visible {
    background: var(--pf-color-action-danger-soft);
    color: var(--pf-color-status-danger-fg);
}

/* ─── Element: __divider ─────────────────────────────────────── */

.pf-popover__divider {
    height: 1px;
    margin: var(--pf-space-1) 0;
    background: var(--pf-popover-border);
    border: none;
}

/* ─── Modifiers: --top / --bottom / --left / --right ────────── */

.pf-popover--top {
    top: auto;
    bottom: calc(100% + var(--pf-space-2));
    transform: translateY(4px);
}

.pf-popover--top[data-pf-popover-open],
.pf-popover--top:not([hidden]) {
    transform: translateY(0);
}

.pf-popover--top .pf-popover__arrow {
    top: auto;
    bottom: calc(var(--pf-popover-arrow-size) * -0.5 - 1px);
    border-top: none;
    border-left: none;
    border-right: 1px solid var(--pf-popover-border);
    border-bottom: 1px solid var(--pf-popover-border);
}

.pf-popover--left {
    top: 0;
    left: auto;
    right: calc(100% + var(--pf-space-2));
    transform: translateX(4px);
}

.pf-popover--left[data-pf-popover-open],
.pf-popover--left:not([hidden]) {
    transform: translateX(0);
}

.pf-popover--left .pf-popover__arrow {
    top: var(--pf-space-3);
    left: auto;
    right: calc(var(--pf-popover-arrow-size) * -0.5 - 1px);
    border: none;
    border-top: 1px solid var(--pf-popover-border);
    border-right: 1px solid var(--pf-popover-border);
}

.pf-popover--right {
    top: 0;
    left: calc(100% + var(--pf-space-2));
    transform: translateX(-4px);
}

.pf-popover--right[data-pf-popover-open],
.pf-popover--right:not([hidden]) {
    transform: translateX(0);
}

.pf-popover--right .pf-popover__arrow {
    top: var(--pf-space-3);
    left: calc(var(--pf-popover-arrow-size) * -0.5 - 1px);
    border: none;
    border-bottom: 1px solid var(--pf-popover-border);
    border-left: 1px solid var(--pf-popover-border);
}

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

.pf-popover--sm { max-width: 200px; }
.pf-popover--md { max-width: 320px; } /* default */
.pf-popover--lg { max-width: 480px; }

/* ─── Modifier: --tooltip (compact, dark-on-light variant) ─── */

.pf-popover--tooltip {
    max-width: 240px;
    background: var(--pf-color-text-primary);
    color: var(--pf-color-text-inverse);
    border-color: var(--pf-color-text-primary);
    font-size: var(--pf-text-size-xs);
    line-height: var(--pf-text-leading-snug);
}

.pf-popover--tooltip .pf-popover__body {
    padding: var(--pf-space-2) var(--pf-space-3);
}

.pf-popover--tooltip .pf-popover__arrow {
    background: var(--pf-color-text-primary);
    border-color: var(--pf-color-text-primary);
}

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

@media (prefers-reduced-motion: reduce) {
    .pf-popover {
        transition: opacity var(--pf-motion-duration-fast) linear;
        transform: none !important;
    }
}