@keenmate/pure-admin-core 2.3.0 → 2.3.2

package/src/scss/core-components/_tooltips.scss

@@ -1,605 +1,605 @@
-/* ========================================
-   Tooltip and Popover Components
-   Tooltips with multiple positions and popovers with rich content
-   ======================================== */
-@use '../variables' as *;
-
-@use "sass:color";
-
-// Tooltips
-.pa-tooltip {
-  position: relative;
-  display: inline-block;
-
-  // Elevate z-index on hover to appear above siblings
-  &:hover {
-    z-index: $z-index-modal;
-  }
-
-  // Help cursor modifier - use for informational tooltips
-  &--help {
-    cursor: help;
-  }
-
-  // Keyword modifier - dotted underline for inline term explanations
-  &--keyword {
-    border-bottom: $border-width-base dotted currentColor;
-    cursor: help;
-  }
-
-  &::before,
-  &::after {
-    position: absolute;
-    opacity: 0;
-    pointer-events: none;
-    transition: opacity $transition-normal $easing-smooth, transform $transition-normal $easing-smooth;
-    z-index: $tooltip-z-index;
-  }
-
-  // Tooltip content
-  &::before {
-    content: attr(data-tooltip);
-    background-color: var(--pa-tooltip-bg);
-    color: var(--pa-tooltip-text);
-    padding: $spacing-xs $spacing-sm;
-    border-radius: $border-radius;
-    font-size: $font-size-xs;
-    white-space: nowrap;
-    max-width: $tooltip-max-width;
-    text-align: center;
-    overflow: hidden;
-    text-overflow: ellipsis;
-  }
-
-  // Multiline tooltip variant
-  &--multiline::before {
-    white-space: normal;
-    text-align: start; // RTL: flips to right
-    width: $tooltip-multiline-width;
-    max-width: $tooltip-multiline-width;
-    line-height: $line-height-base;
-  }
-
-  // Tooltip arrow
-  &::after {
-    content: '';
-    border: $tooltip-arrow-size solid transparent;
-  }
-
-  // Show on hover
-  &:hover::before,
-  &:hover::after {
-    opacity: 1;
-  }
-
-  // Disable CSS tooltip when JS floating tooltip is active (prevents double tooltips)
-  &--floating::before,
-  &--floating::after {
-    display: none !important;
-  }
-
-  // Top position (default)
-  &::before {
-    bottom: calc(100% + $tooltip-distance);
-    left: 50%;
-    transform: translateX(-50%) translateY(-$tooltip-offset);
-  }
-
-  &::after {
-    bottom: calc(100% + ($tooltip-arrow-size - 2px));
-    left: 50%;
-    transform: translateX(-50%) translateY(-$tooltip-offset);
-    border-top-color: var(--pa-tooltip-bg);
-  }
-
-  &:hover::before,
-  &:hover::after {
-    transform: translateX(-50%) translateY(0);
-  }
-
-  // End position (inline-end: right in LTR, left in RTL)
-  &--end::before {
-    bottom: auto;
-    left: auto;
-    inset-inline-start: calc(100% + $tooltip-distance);
-    top: 50%;
-    transform: translateX(-$tooltip-offset) translateY(-50%);
-  }
-
-  &--end::after {
-    bottom: auto;
-    left: auto;
-    inset-inline-start: calc(100% + ($tooltip-arrow-size - 2px));
-    top: 50%;
-    transform: translateX(-$tooltip-offset) translateY(-50%);
-    border-top-color: transparent;
-    border-inline-end-color: var(--pa-tooltip-bg);
-  }
-
-  &--end:hover::before,
-  &--end:hover::after {
-    transform: translateX(0) translateY(-50%);
-  }
-
-  // RTL: reverse slide direction for end position
-  [dir="rtl"] &--end::before,
-  [dir="rtl"] &--end::after {
-    transform: translateX($tooltip-offset) translateY(-50%);
-  }
-
-  [dir="rtl"] &--end:hover::before,
-  [dir="rtl"] &--end:hover::after {
-    transform: translateX(0) translateY(-50%);
-  }
-
-  // Bottom position
-  &--bottom::before {
-    bottom: auto;
-    top: calc(100% + $tooltip-distance);
-    left: 50%;
-    transform: translateX(-50%) translateY($tooltip-offset);
-  }
-
-  &--bottom::after {
-    bottom: auto;
-    top: calc(100% + ($tooltip-arrow-size - 2px));
-    left: 50%;
-    transform: translateX(-50%) translateY($tooltip-offset);
-    border-top-color: transparent;
-    border-bottom-color: var(--pa-tooltip-bg);
-  }
-
-  &--bottom:hover::before,
-  &--bottom:hover::after {
-    transform: translateX(-50%) translateY(0);
-  }
-
-  // Start position (inline-start: left in LTR, right in RTL)
-  &--start::before {
-    bottom: auto;
-    left: auto;
-    inset-inline-end: calc(100% + $tooltip-distance);
-    top: 50%;
-    transform: translateX($tooltip-offset) translateY(-50%);
-  }
-
-  &--start::after {
-    bottom: auto;
-    left: auto;
-    inset-inline-end: calc(100% + ($tooltip-arrow-size - 2px));
-    top: 50%;
-    transform: translateX($tooltip-offset) translateY(-50%);
-    border-top-color: transparent;
-    border-inline-start-color: var(--pa-tooltip-bg);
-  }
-
-  &--start:hover::before,
-  &--start:hover::after {
-    transform: translateX(0) translateY(-50%);
-  }
-
-  // RTL: reverse slide direction for start position
-  [dir="rtl"] &--start::before,
-  [dir="rtl"] &--start::after {
-    transform: translateX(-$tooltip-offset) translateY(-50%);
-  }
-
-  [dir="rtl"] &--start:hover::before,
-  [dir="rtl"] &--start:hover::after {
-    transform: translateX(0) translateY(-50%);
-  }
-
-  // Color variants
-  &--primary::before {
-    background-color: var(--pa-btn-primary-bg);
-  }
-  &--primary::after {
-    border-top-color: var(--pa-btn-primary-bg);
-  }
-  &--primary.pa-tooltip--end::after {
-    border-top-color: transparent;
-    border-inline-end-color: var(--pa-btn-primary-bg);
-  }
-  &--primary.pa-tooltip--bottom::after {
-    border-top-color: transparent;
-    border-bottom-color: var(--pa-btn-primary-bg);
-  }
-  &--primary.pa-tooltip--start::after {
-    border-top-color: transparent;
-    border-inline-start-color: var(--pa-btn-primary-bg);
-  }
-
-  &--success::before {
-    background-color: var(--pa-btn-success-bg);
-  }
-  &--success::after {
-    border-top-color: var(--pa-btn-success-bg);
-  }
-  &--success.pa-tooltip--end::after {
-    border-top-color: transparent;
-    border-inline-end-color: var(--pa-btn-success-bg);
-  }
-  &--success.pa-tooltip--bottom::after {
-    border-top-color: transparent;
-    border-bottom-color: var(--pa-btn-success-bg);
-  }
-  &--success.pa-tooltip--start::after {
-    border-top-color: transparent;
-    border-inline-start-color: var(--pa-btn-success-bg);
-  }
-
-  &--warning::before {
-    background-color: var(--pa-btn-warning-bg);
-    color: var(--pa-text-color-1);
-  }
-  &--warning::after {
-    border-top-color: var(--pa-btn-warning-bg);
-  }
-  &--warning.pa-tooltip--end::after {
-    border-top-color: transparent;
-    border-inline-end-color: var(--pa-btn-warning-bg);
-  }
-  &--warning.pa-tooltip--bottom::after {
-    border-top-color: transparent;
-    border-bottom-color: var(--pa-btn-warning-bg);
-  }
-  &--warning.pa-tooltip--start::after {
-    border-top-color: transparent;
-    border-inline-start-color: var(--pa-btn-warning-bg);
-  }
-
-  &--danger::before {
-    background-color: var(--pa-btn-danger-bg);
-  }
-  &--danger::after {
-    border-top-color: var(--pa-btn-danger-bg);
-  }
-  &--danger.pa-tooltip--end::after {
-    border-top-color: transparent;
-    border-inline-end-color: var(--pa-btn-danger-bg);
-  }
-  &--danger.pa-tooltip--bottom::after {
-    border-top-color: transparent;
-    border-bottom-color: var(--pa-btn-danger-bg);
-  }
-  &--danger.pa-tooltip--start::after {
-    border-top-color: transparent;
-    border-inline-start-color: var(--pa-btn-danger-bg);
-  }
-
-  // Numbered color variants (color-1 through color-9)
-  // These use theme-customizable colors from --pa-color-* CSS variables
-  @for $i from 1 through 9 {
-    &--color-#{$i}::before {
-      background-color: var(--pa-color-#{$i});
-      color: var(--pa-color-#{$i}-text);
-    }
-    &--color-#{$i}::after {
-      border-top-color: var(--pa-color-#{$i});
-    }
-    &--color-#{$i}.pa-tooltip--end::after {
-      border-top-color: transparent;
-      border-inline-end-color: var(--pa-color-#{$i});
-    }
-    &--color-#{$i}.pa-tooltip--bottom::after {
-      border-top-color: transparent;
-      border-bottom-color: var(--pa-color-#{$i});
-    }
-    &--color-#{$i}.pa-tooltip--start::after {
-      border-top-color: transparent;
-      border-inline-start-color: var(--pa-color-#{$i});
-    }
-  }
-
-  // Smart positioning - collision detection adjustments
-  // Applied dynamically by JavaScript based on viewport boundaries
-
-  // Auto-flip from top to bottom
-  &--auto-flip-bottom::before {
-    bottom: auto !important;
-    top: calc(100% + $tooltip-distance) !important;
-    transform: translateX(-50%) translateY($tooltip-offset) !important;
-  }
-
-  &--auto-flip-bottom::after {
-    bottom: auto !important;
-    top: calc(100% + ($tooltip-arrow-size - 2px)) !important;
-    transform: translateX(-50%) translateY($tooltip-offset) !important;
-    border-top-color: transparent !important;
-    border-bottom-color: var(--pa-tooltip-bg) !important;
-  }
-
-  &--auto-flip-bottom:hover::before,
-  &--auto-flip-bottom:hover::after {
-    transform: translateX(-50%) translateY(0) !important;
-  }
-
-  // Auto-flip from bottom to top
-  &--auto-flip-top::before {
-    top: auto !important;
-    bottom: calc(100% + $tooltip-distance) !important;
-    transform: translateX(-50%) translateY(-$tooltip-offset) !important;
-  }
-
-  &--auto-flip-top::after {
-    top: auto !important;
-    bottom: calc(100% + ($tooltip-arrow-size - 2px)) !important;
-    transform: translateX(-50%) translateY(-$tooltip-offset) !important;
-    border-bottom-color: transparent !important;
-    border-top-color: var(--pa-tooltip-bg) !important;
-  }
-
-  &--auto-flip-top:hover::before,
-  &--auto-flip-top:hover::after {
-    transform: translateX(-50%) translateY(0) !important;
-  }
-
-  // Auto-flip from start to end
-  &--auto-flip-end::before {
-    left: auto !important;
-    right: auto !important;
-    inset-inline-start: calc(100% + $tooltip-distance) !important;
-    transform: translateX(-$tooltip-offset) translateY(-50%) !important;
-  }
-
-  &--auto-flip-end::after {
-    left: auto !important;
-    right: auto !important;
-    inset-inline-start: calc(100% + ($tooltip-arrow-size - 2px)) !important;
-    transform: translateX(-$tooltip-offset) translateY(-50%) !important;
-    border-inline-start-color: transparent !important;
-    border-inline-end-color: var(--pa-tooltip-bg) !important;
-  }
-
-  &--auto-flip-end:hover::before,
-  &--auto-flip-end:hover::after {
-    transform: translateX(0) translateY(-50%) !important;
-  }
-
-  // RTL: reverse slide direction for auto-flip-end
-  [dir="rtl"] &--auto-flip-end::before,
-  [dir="rtl"] &--auto-flip-end::after {
-    transform: translateX($tooltip-offset) translateY(-50%) !important;
-  }
-
-  [dir="rtl"] &--auto-flip-end:hover::before,
-  [dir="rtl"] &--auto-flip-end:hover::after {
-    transform: translateX(0) translateY(-50%) !important;
-  }
-
-  // Auto-flip from end to start
-  &--auto-flip-start::before {
-    left: auto !important;
-    right: auto !important;
-    inset-inline-end: calc(100% + $tooltip-distance) !important;
-    transform: translateX($tooltip-offset) translateY(-50%) !important;
-  }
-
-  &--auto-flip-start::after {
-    left: auto !important;
-    right: auto !important;
-    inset-inline-end: calc(100% + ($tooltip-arrow-size - 2px)) !important;
-    transform: translateX($tooltip-offset) translateY(-50%) !important;
-    border-inline-end-color: transparent !important;
-    border-inline-start-color: var(--pa-tooltip-bg) !important;
-  }
-
-  &--auto-flip-start:hover::before,
-  &--auto-flip-start:hover::after {
-    transform: translateX(0) translateY(-50%) !important;
-  }
-
-  // RTL: reverse slide direction for auto-flip-start
-  [dir="rtl"] &--auto-flip-start::before,
-  [dir="rtl"] &--auto-flip-start::after {
-    transform: translateX(-$tooltip-offset) translateY(-50%) !important;
-  }
-
-  [dir="rtl"] &--auto-flip-start:hover::before,
-  [dir="rtl"] &--auto-flip-start:hover::after {
-    transform: translateX(0) translateY(-50%) !important;
-  }
-}
-
-// ========================================
-// Popovers - Interactive rich-content tooltips with Floating UI
-// ========================================
-
-.pa-popover {
-  display: inline-block;
-
-  &__trigger {
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    width: $popover-trigger-size;
-    height: $popover-trigger-size;
-    padding: 0;
-    border: $border-width-base solid var(--pa-border-color);
-    border-radius: 50%;
-    background-color: var(--pa-popover-content-bg);
-    color: var(--pa-text-color-2);
-    font-size: $font-size-xs;
-    font-weight: $font-weight-bold;
-    cursor: pointer;
-    transition: all $transition-fast $easing-smooth;
-
-    &:hover {
-      background-color: var(--pa-accent);
-      color: var(--pa-modal-content-bg);
-      border-color: var(--pa-accent);
-    }
-  }
-
-  &__content {
-    position: absolute;
-    display: none;
-    min-width: $popover-min-width;
-    max-width: $popover-max-width;
-    background-color: var(--pa-card-bg);
-    border: $border-width-base solid var(--pa-border-color);
-    border-radius: $border-radius;
-    box-shadow: $shadow-lg;
-    z-index: $popover-z-index;
-
-    // Show when data-show attribute is present (controlled by JavaScript)
-    &[data-show] {
-      display: block;
-    }
-  }
-
-  &__header {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    padding: $popover-header-padding;
-    border-bottom: $popover-header-border;
-    background-color: var(--pa-card-header-bg);
-    border-radius: $popover-header-border-radius;
-
-    h4 {
-      margin: 0;
-      font-size: $popover-title-font-size;
-      font-weight: $font-weight-semibold;
-      color: var(--pa-text-color-1);
-    }
-  }
-
-  &__body {
-    padding: $spacing-base;
-    font-size: $font-size-sm;
-    line-height: $line-height-base;
-    color: var(--pa-text-color-1);
-    text-align: start; // RTL: flips to right
-
-    p {
-      margin: 0 0 $spacing-sm 0;
-
-      &:last-child {
-        margin-bottom: 0;
-      }
-    }
-
-    a {
-      color: var(--pa-accent);
-      text-decoration: underline;
-
-      &:hover {
-        color: var(--pa-accent-hover);
-      }
-    }
-
-    ul, ol {
-      margin: $spacing-sm 0;
-      padding-inline-start: $spacing-lg; // RTL: flips to padding-right
-    }
-
-    code {
-      padding: $popover-code-padding-v $popover-code-padding-h;
-      background-color: color-mix(in srgb, var(--pa-text-color-2) 15%, transparent);
-      border-radius: $border-radius-sm;
-      font-family: monospace;
-      font-size: $popover-code-font-scale;
-    }
-  }
-
-  &__close {
-    background: none;
-    border: none;
-    font-size: $font-size-lg;
-    line-height: 1;
-    color: var(--pa-text-color-2);
-    cursor: pointer;
-    padding: 0;
-    width: $popover-close-size;
-    height: $popover-close-size;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    border-radius: $border-radius;
-    transition: all $transition-fast $easing-smooth;
-
-    &:hover {
-      background-color: color-mix(in srgb, var(--pa-text-color-2) 10%, transparent);
-      color: var(--pa-text-color-1);
-    }
-  }
-
-  // Size variants
-  &--sm &__content {
-    min-width: $popover-sm-min-width;
-    max-width: $popover-sm-max-width;
-  }
-
-  &--lg &__content {
-    min-width: $popover-lg-min-width;
-    max-width: $popover-lg-max-width;
-  }
-
-  // Alignment variants
-  &--center &__body {
-    text-align: center;
-  }
-
-  &--end &__body {
-    text-align: end; // RTL: flips to left
-  }
-}
-
-.pa-popover--end .pa-popover__body {
-  text-align: end;
-}
-
-// ========================================
-// Floating UI Tooltip (Portal Rendering)
-// ========================================
-
-.pa-tooltip-floating {
-  background-color: var(--pa-tooltip-bg);
-  color: var(--pa-tooltip-text);
-  padding: $spacing-xs $spacing-sm;
-  border-radius: $border-radius;
-  font-size: $font-size-xs;
-  white-space: nowrap;
-  max-width: $tooltip-max-width;
-  text-align: center;
-  box-shadow: $shadow-md;
-  pointer-events: none;
-  z-index: $z-index-tooltip;
-
-  // Multiline variant
-  &.pa-tooltip--multiline {
-    white-space: normal;
-    text-align: start; // RTL: flips to right
-    max-width: $tooltip-multiline-max-width;
-  }
-
-  // Color variants
-  &.pa-tooltip--primary {
-    background-color: var(--pa-btn-primary-bg);
-    color: var(--pa-btn-primary-text);
-  }
-
-  &.pa-tooltip--success {
-    background-color: var(--pa-btn-success-bg);
-    color: var(--pa-btn-success-text);
-  }
-
-  &.pa-tooltip--warning {
-    background-color: var(--pa-btn-warning-bg);
-    color: var(--pa-btn-warning-text);
-  }
-
-  &.pa-tooltip--danger {
-    background-color: var(--pa-btn-danger-bg);
-    color: var(--pa-btn-danger-text);
-  }
-
-  // Numbered color variants (color-1 through color-9)
-  @for $i from 1 through 9 {
-    &.pa-tooltip--color-#{$i} {
-      background-color: var(--pa-color-#{$i});
-      color: var(--pa-color-#{$i}-text);
-    }
-  }
-}
+/* ========================================
+   Tooltip and Popover Components
+   Tooltips with multiple positions and popovers with rich content
+   ======================================== */
+@use '../variables' as *;
+
+@use "sass:color";
+
+// Tooltips
+.pa-tooltip {
+  position: relative;
+  display: inline-block;
+
+  // Elevate z-index on hover to appear above siblings
+  &:hover {
+    z-index: $z-index-modal;
+  }
+
+  // Help cursor modifier - use for informational tooltips
+  &--help {
+    cursor: help;
+  }
+
+  // Keyword modifier - dotted underline for inline term explanations
+  &--keyword {
+    border-bottom: $border-width-base dotted currentColor;
+    cursor: help;
+  }
+
+  &::before,
+  &::after {
+    position: absolute;
+    opacity: 0;
+    pointer-events: none;
+    transition: opacity $transition-normal $easing-smooth, transform $transition-normal $easing-smooth;
+    z-index: $tooltip-z-index;
+  }
+
+  // Tooltip content
+  &::before {
+    content: attr(data-tooltip);
+    background-color: var(--pa-tooltip-bg);
+    color: var(--pa-tooltip-text);
+    padding: $spacing-xs $spacing-sm;
+    border-radius: var(--pa-border-radius);
+    font-size: $font-size-xs;
+    white-space: nowrap;
+    max-width: $tooltip-max-width;
+    text-align: center;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+
+  // Multiline tooltip variant
+  &--multiline::before {
+    white-space: normal;
+    text-align: start; // RTL: flips to right
+    width: $tooltip-multiline-width;
+    max-width: $tooltip-multiline-width;
+    line-height: $line-height-base;
+  }
+
+  // Tooltip arrow
+  &::after {
+    content: '';
+    border: $tooltip-arrow-size solid transparent;
+  }
+
+  // Show on hover
+  &:hover::before,
+  &:hover::after {
+    opacity: 1;
+  }
+
+  // Disable CSS tooltip when JS floating tooltip is active (prevents double tooltips)
+  &--floating::before,
+  &--floating::after {
+    display: none !important;
+  }
+
+  // Top position (default)
+  &::before {
+    bottom: calc(100% + $tooltip-distance);
+    left: 50%;
+    transform: translateX(-50%) translateY(-$tooltip-offset);
+  }
+
+  &::after {
+    bottom: calc(100% + ($tooltip-arrow-size - 2px));
+    left: 50%;
+    transform: translateX(-50%) translateY(-$tooltip-offset);
+    border-top-color: var(--pa-tooltip-bg);
+  }
+
+  &:hover::before,
+  &:hover::after {
+    transform: translateX(-50%) translateY(0);
+  }
+
+  // End position (inline-end: right in LTR, left in RTL)
+  &--end::before {
+    bottom: auto;
+    left: auto;
+    inset-inline-start: calc(100% + $tooltip-distance);
+    top: 50%;
+    transform: translateX(-$tooltip-offset) translateY(-50%);
+  }
+
+  &--end::after {
+    bottom: auto;
+    left: auto;
+    inset-inline-start: calc(100% + ($tooltip-arrow-size - 2px));
+    top: 50%;
+    transform: translateX(-$tooltip-offset) translateY(-50%);
+    border-top-color: transparent;
+    border-inline-end-color: var(--pa-tooltip-bg);
+  }
+
+  &--end:hover::before,
+  &--end:hover::after {
+    transform: translateX(0) translateY(-50%);
+  }
+
+  // RTL: reverse slide direction for end position
+  [dir="rtl"] &--end::before,
+  [dir="rtl"] &--end::after {
+    transform: translateX($tooltip-offset) translateY(-50%);
+  }
+
+  [dir="rtl"] &--end:hover::before,
+  [dir="rtl"] &--end:hover::after {
+    transform: translateX(0) translateY(-50%);
+  }
+
+  // Bottom position
+  &--bottom::before {
+    bottom: auto;
+    top: calc(100% + $tooltip-distance);
+    left: 50%;
+    transform: translateX(-50%) translateY($tooltip-offset);
+  }
+
+  &--bottom::after {
+    bottom: auto;
+    top: calc(100% + ($tooltip-arrow-size - 2px));
+    left: 50%;
+    transform: translateX(-50%) translateY($tooltip-offset);
+    border-top-color: transparent;
+    border-bottom-color: var(--pa-tooltip-bg);
+  }
+
+  &--bottom:hover::before,
+  &--bottom:hover::after {
+    transform: translateX(-50%) translateY(0);
+  }
+
+  // Start position (inline-start: left in LTR, right in RTL)
+  &--start::before {
+    bottom: auto;
+    left: auto;
+    inset-inline-end: calc(100% + $tooltip-distance);
+    top: 50%;
+    transform: translateX($tooltip-offset) translateY(-50%);
+  }
+
+  &--start::after {
+    bottom: auto;
+    left: auto;
+    inset-inline-end: calc(100% + ($tooltip-arrow-size - 2px));
+    top: 50%;
+    transform: translateX($tooltip-offset) translateY(-50%);
+    border-top-color: transparent;
+    border-inline-start-color: var(--pa-tooltip-bg);
+  }
+
+  &--start:hover::before,
+  &--start:hover::after {
+    transform: translateX(0) translateY(-50%);
+  }
+
+  // RTL: reverse slide direction for start position
+  [dir="rtl"] &--start::before,
+  [dir="rtl"] &--start::after {
+    transform: translateX(-$tooltip-offset) translateY(-50%);
+  }
+
+  [dir="rtl"] &--start:hover::before,
+  [dir="rtl"] &--start:hover::after {
+    transform: translateX(0) translateY(-50%);
+  }
+
+  // Color variants
+  &--primary::before {
+    background-color: var(--pa-btn-primary-bg);
+  }
+  &--primary::after {
+    border-top-color: var(--pa-btn-primary-bg);
+  }
+  &--primary.pa-tooltip--end::after {
+    border-top-color: transparent;
+    border-inline-end-color: var(--pa-btn-primary-bg);
+  }
+  &--primary.pa-tooltip--bottom::after {
+    border-top-color: transparent;
+    border-bottom-color: var(--pa-btn-primary-bg);
+  }
+  &--primary.pa-tooltip--start::after {
+    border-top-color: transparent;
+    border-inline-start-color: var(--pa-btn-primary-bg);
+  }
+
+  &--success::before {
+    background-color: var(--pa-btn-success-bg);
+  }
+  &--success::after {
+    border-top-color: var(--pa-btn-success-bg);
+  }
+  &--success.pa-tooltip--end::after {
+    border-top-color: transparent;
+    border-inline-end-color: var(--pa-btn-success-bg);
+  }
+  &--success.pa-tooltip--bottom::after {
+    border-top-color: transparent;
+    border-bottom-color: var(--pa-btn-success-bg);
+  }
+  &--success.pa-tooltip--start::after {
+    border-top-color: transparent;
+    border-inline-start-color: var(--pa-btn-success-bg);
+  }
+
+  &--warning::before {
+    background-color: var(--pa-btn-warning-bg);
+    color: var(--pa-text-color-1);
+  }
+  &--warning::after {
+    border-top-color: var(--pa-btn-warning-bg);
+  }
+  &--warning.pa-tooltip--end::after {
+    border-top-color: transparent;
+    border-inline-end-color: var(--pa-btn-warning-bg);
+  }
+  &--warning.pa-tooltip--bottom::after {
+    border-top-color: transparent;
+    border-bottom-color: var(--pa-btn-warning-bg);
+  }
+  &--warning.pa-tooltip--start::after {
+    border-top-color: transparent;
+    border-inline-start-color: var(--pa-btn-warning-bg);
+  }
+
+  &--danger::before {
+    background-color: var(--pa-btn-danger-bg);
+  }
+  &--danger::after {
+    border-top-color: var(--pa-btn-danger-bg);
+  }
+  &--danger.pa-tooltip--end::after {
+    border-top-color: transparent;
+    border-inline-end-color: var(--pa-btn-danger-bg);
+  }
+  &--danger.pa-tooltip--bottom::after {
+    border-top-color: transparent;
+    border-bottom-color: var(--pa-btn-danger-bg);
+  }
+  &--danger.pa-tooltip--start::after {
+    border-top-color: transparent;
+    border-inline-start-color: var(--pa-btn-danger-bg);
+  }
+
+  // Numbered color variants (color-1 through color-9)
+  // These use theme-customizable colors from --pa-color-* CSS variables
+  @for $i from 1 through 9 {
+    &--color-#{$i}::before {
+      background-color: var(--pa-color-#{$i});
+      color: var(--pa-color-#{$i}-text);
+    }
+    &--color-#{$i}::after {
+      border-top-color: var(--pa-color-#{$i});
+    }
+    &--color-#{$i}.pa-tooltip--end::after {
+      border-top-color: transparent;
+      border-inline-end-color: var(--pa-color-#{$i});
+    }
+    &--color-#{$i}.pa-tooltip--bottom::after {
+      border-top-color: transparent;
+      border-bottom-color: var(--pa-color-#{$i});
+    }
+    &--color-#{$i}.pa-tooltip--start::after {
+      border-top-color: transparent;
+      border-inline-start-color: var(--pa-color-#{$i});
+    }
+  }
+
+  // Smart positioning - collision detection adjustments
+  // Applied dynamically by JavaScript based on viewport boundaries
+
+  // Auto-flip from top to bottom
+  &--auto-flip-bottom::before {
+    bottom: auto !important;
+    top: calc(100% + $tooltip-distance) !important;
+    transform: translateX(-50%) translateY($tooltip-offset) !important;
+  }
+
+  &--auto-flip-bottom::after {
+    bottom: auto !important;
+    top: calc(100% + ($tooltip-arrow-size - 2px)) !important;
+    transform: translateX(-50%) translateY($tooltip-offset) !important;
+    border-top-color: transparent !important;
+    border-bottom-color: var(--pa-tooltip-bg) !important;
+  }
+
+  &--auto-flip-bottom:hover::before,
+  &--auto-flip-bottom:hover::after {
+    transform: translateX(-50%) translateY(0) !important;
+  }
+
+  // Auto-flip from bottom to top
+  &--auto-flip-top::before {
+    top: auto !important;
+    bottom: calc(100% + $tooltip-distance) !important;
+    transform: translateX(-50%) translateY(-$tooltip-offset) !important;
+  }
+
+  &--auto-flip-top::after {
+    top: auto !important;
+    bottom: calc(100% + ($tooltip-arrow-size - 2px)) !important;
+    transform: translateX(-50%) translateY(-$tooltip-offset) !important;
+    border-bottom-color: transparent !important;
+    border-top-color: var(--pa-tooltip-bg) !important;
+  }
+
+  &--auto-flip-top:hover::before,
+  &--auto-flip-top:hover::after {
+    transform: translateX(-50%) translateY(0) !important;
+  }
+
+  // Auto-flip from start to end
+  &--auto-flip-end::before {
+    left: auto !important;
+    right: auto !important;
+    inset-inline-start: calc(100% + $tooltip-distance) !important;
+    transform: translateX(-$tooltip-offset) translateY(-50%) !important;
+  }
+
+  &--auto-flip-end::after {
+    left: auto !important;
+    right: auto !important;
+    inset-inline-start: calc(100% + ($tooltip-arrow-size - 2px)) !important;
+    transform: translateX(-$tooltip-offset) translateY(-50%) !important;
+    border-inline-start-color: transparent !important;
+    border-inline-end-color: var(--pa-tooltip-bg) !important;
+  }
+
+  &--auto-flip-end:hover::before,
+  &--auto-flip-end:hover::after {
+    transform: translateX(0) translateY(-50%) !important;
+  }
+
+  // RTL: reverse slide direction for auto-flip-end
+  [dir="rtl"] &--auto-flip-end::before,
+  [dir="rtl"] &--auto-flip-end::after {
+    transform: translateX($tooltip-offset) translateY(-50%) !important;
+  }
+
+  [dir="rtl"] &--auto-flip-end:hover::before,
+  [dir="rtl"] &--auto-flip-end:hover::after {
+    transform: translateX(0) translateY(-50%) !important;
+  }
+
+  // Auto-flip from end to start
+  &--auto-flip-start::before {
+    left: auto !important;
+    right: auto !important;
+    inset-inline-end: calc(100% + $tooltip-distance) !important;
+    transform: translateX($tooltip-offset) translateY(-50%) !important;
+  }
+
+  &--auto-flip-start::after {
+    left: auto !important;
+    right: auto !important;
+    inset-inline-end: calc(100% + ($tooltip-arrow-size - 2px)) !important;
+    transform: translateX($tooltip-offset) translateY(-50%) !important;
+    border-inline-end-color: transparent !important;
+    border-inline-start-color: var(--pa-tooltip-bg) !important;
+  }
+
+  &--auto-flip-start:hover::before,
+  &--auto-flip-start:hover::after {
+    transform: translateX(0) translateY(-50%) !important;
+  }
+
+  // RTL: reverse slide direction for auto-flip-start
+  [dir="rtl"] &--auto-flip-start::before,
+  [dir="rtl"] &--auto-flip-start::after {
+    transform: translateX(-$tooltip-offset) translateY(-50%) !important;
+  }
+
+  [dir="rtl"] &--auto-flip-start:hover::before,
+  [dir="rtl"] &--auto-flip-start:hover::after {
+    transform: translateX(0) translateY(-50%) !important;
+  }
+}
+
+// ========================================
+// Popovers - Interactive rich-content tooltips with Floating UI
+// ========================================
+
+.pa-popover {
+  display: inline-block;
+
+  &__trigger {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: $popover-trigger-size;
+    height: $popover-trigger-size;
+    padding: 0;
+    border: $border-width-base solid var(--pa-border-color);
+    border-radius: 50%;
+    background-color: var(--pa-popover-content-bg);
+    color: var(--pa-text-color-2);
+    font-size: $font-size-xs;
+    font-weight: $font-weight-bold;
+    cursor: pointer;
+    transition: all $transition-fast $easing-smooth;
+
+    &:hover {
+      background-color: var(--pa-accent);
+      color: var(--pa-modal-content-bg);
+      border-color: var(--pa-accent);
+    }
+  }
+
+  &__content {
+    position: absolute;
+    display: none;
+    min-width: $popover-min-width;
+    max-width: $popover-max-width;
+    background-color: var(--pa-card-bg);
+    border: $border-width-base solid var(--pa-border-color);
+    border-radius: var(--pa-border-radius);
+    box-shadow: $shadow-lg;
+    z-index: $popover-z-index;
+
+    // Show when data-show attribute is present (controlled by JavaScript)
+    &[data-show] {
+      display: block;
+    }
+  }
+
+  &__header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: $popover-header-padding;
+    border-bottom: $popover-header-border;
+    background-color: var(--pa-card-header-bg);
+    border-radius: var(--pa-border-radius) var(--pa-border-radius) 0 0;
+
+    h4 {
+      margin: 0;
+      font-size: $popover-title-font-size;
+      font-weight: $font-weight-semibold;
+      color: var(--pa-text-color-1);
+    }
+  }
+
+  &__body {
+    padding: $spacing-base;
+    font-size: $font-size-sm;
+    line-height: $line-height-base;
+    color: var(--pa-text-color-1);
+    text-align: start; // RTL: flips to right
+
+    p {
+      margin: 0 0 $spacing-sm 0;
+
+      &:last-child {
+        margin-bottom: 0;
+      }
+    }
+
+    a {
+      color: var(--pa-accent);
+      text-decoration: underline;
+
+      &:hover {
+        color: var(--pa-accent-hover);
+      }
+    }
+
+    ul, ol {
+      margin: $spacing-sm 0;
+      padding-inline-start: $spacing-lg; // RTL: flips to padding-right
+    }
+
+    code {
+      padding: $popover-code-padding-v $popover-code-padding-h;
+      background-color: color-mix(in srgb, var(--pa-text-color-2) 15%, transparent);
+      border-radius: var(--pa-border-radius-sm);
+      font-family: monospace;
+      font-size: $popover-code-font-scale;
+    }
+  }
+
+  &__close {
+    background: none;
+    border: none;
+    font-size: $font-size-lg;
+    line-height: 1;
+    color: var(--pa-text-color-2);
+    cursor: pointer;
+    padding: 0;
+    width: $popover-close-size;
+    height: $popover-close-size;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    border-radius: var(--pa-border-radius);
+    transition: all $transition-fast $easing-smooth;
+
+    &:hover {
+      background-color: color-mix(in srgb, var(--pa-text-color-2) 10%, transparent);
+      color: var(--pa-text-color-1);
+    }
+  }
+
+  // Size variants
+  &--sm &__content {
+    min-width: $popover-sm-min-width;
+    max-width: $popover-sm-max-width;
+  }
+
+  &--lg &__content {
+    min-width: $popover-lg-min-width;
+    max-width: $popover-lg-max-width;
+  }
+
+  // Alignment variants
+  &--center &__body {
+    text-align: center;
+  }
+
+  &--end &__body {
+    text-align: end; // RTL: flips to left
+  }
+}
+
+.pa-popover--end .pa-popover__body {
+  text-align: end;
+}
+
+// ========================================
+// Floating UI Tooltip (Portal Rendering)
+// ========================================
+
+.pa-tooltip-floating {
+  background-color: var(--pa-tooltip-bg);
+  color: var(--pa-tooltip-text);
+  padding: $spacing-xs $spacing-sm;
+  border-radius: var(--pa-border-radius);
+  font-size: $font-size-xs;
+  white-space: nowrap;
+  max-width: $tooltip-max-width;
+  text-align: center;
+  box-shadow: $shadow-md;
+  pointer-events: none;
+  z-index: $z-index-tooltip;
+
+  // Multiline variant
+  &.pa-tooltip--multiline {
+    white-space: normal;
+    text-align: start; // RTL: flips to right
+    max-width: $tooltip-multiline-max-width;
+  }
+
+  // Color variants
+  &.pa-tooltip--primary {
+    background-color: var(--pa-btn-primary-bg);
+    color: var(--pa-btn-primary-text);
+  }
+
+  &.pa-tooltip--success {
+    background-color: var(--pa-btn-success-bg);
+    color: var(--pa-btn-success-text);
+  }
+
+  &.pa-tooltip--warning {
+    background-color: var(--pa-btn-warning-bg);
+    color: var(--pa-btn-warning-text);
+  }
+
+  &.pa-tooltip--danger {
+    background-color: var(--pa-btn-danger-bg);
+    color: var(--pa-btn-danger-text);
+  }
+
+  // Numbered color variants (color-1 through color-9)
+  @for $i from 1 through 9 {
+    &.pa-tooltip--color-#{$i} {
+      background-color: var(--pa-color-#{$i});
+      color: var(--pa-color-#{$i}-text);
+    }
+  }
+}