@keenmate/pure-admin-core 1.0.0-rc01

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

@@ -0,0 +1,503 @@
+/* ========================================
+   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;
+  }
+
+  &::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: left;
+    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);
+  }
+
+  // Right position
+  &--right::before {
+    bottom: auto;
+    left: calc(100% + $tooltip-distance);
+    top: 50%;
+    transform: translateX(-$tooltip-offset) translateY(-50%);
+  }
+
+  &--right::after {
+    bottom: auto;
+    left: calc(100% + ($tooltip-arrow-size - 2px));
+    top: 50%;
+    transform: translateX(-$tooltip-offset) translateY(-50%);
+    border-top-color: transparent;
+    border-right-color: var(--pa-tooltip-bg);
+  }
+
+  &--right:hover::before,
+  &--right: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);
+  }
+
+  // Left position
+  &--left::before {
+    bottom: auto;
+    left: auto;
+    right: calc(100% + $tooltip-distance);
+    top: 50%;
+    transform: translateX($tooltip-offset) translateY(-50%);
+  }
+
+  &--left::after {
+    bottom: auto;
+    left: auto;
+    right: calc(100% + ($tooltip-arrow-size - 2px));
+    top: 50%;
+    transform: translateX($tooltip-offset) translateY(-50%);
+    border-top-color: transparent;
+    border-left-color: var(--pa-tooltip-bg);
+  }
+
+  &--left:hover::before,
+  &--left: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--right::after {
+    border-top-color: transparent;
+    border-right-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--left::after {
+    border-top-color: transparent;
+    border-left-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--right::after {
+    border-top-color: transparent;
+    border-right-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--left::after {
+    border-top-color: transparent;
+    border-left-color: var(--pa-btn-success-bg);
+  }
+
+  &--warning::before {
+    background-color: var(--pa-btn-warning-bg);
+    color: var(--pa-text-primary);
+  }
+  &--warning::after {
+    border-top-color: var(--pa-btn-warning-bg);
+  }
+  &--warning.pa-tooltip--right::after {
+    border-top-color: transparent;
+    border-right-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--left::after {
+    border-top-color: transparent;
+    border-left-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--right::after {
+    border-top-color: transparent;
+    border-right-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--left::after {
+    border-top-color: transparent;
+    border-left-color: var(--pa-btn-danger-bg);
+  }
+
+  // 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 left to right
+  &--auto-flip-right::before {
+    left: calc(100% + $tooltip-distance) !important;
+    right: auto !important;
+    transform: translateX(-$tooltip-offset) translateY(-50%) !important;
+  }
+
+  &--auto-flip-right::after {
+    left: calc(100% + ($tooltip-arrow-size - 2px)) !important;
+    right: auto !important;
+    transform: translateX(-$tooltip-offset) translateY(-50%) !important;
+    border-left-color: transparent !important;
+    border-right-color: var(--pa-tooltip-bg) !important;
+  }
+
+  &--auto-flip-right:hover::before,
+  &--auto-flip-right:hover::after {
+    transform: translateX(0) translateY(-50%) !important;
+  }
+
+  // Auto-flip from right to left
+  &--auto-flip-left::before {
+    right: calc(100% + $tooltip-distance) !important;
+    left: auto !important;
+    transform: translateX($tooltip-offset) translateY(-50%) !important;
+  }
+
+  &--auto-flip-left::after {
+    right: calc(100% + ($tooltip-arrow-size - 2px)) !important;
+    left: auto !important;
+    transform: translateX($tooltip-offset) translateY(-50%) !important;
+    border-right-color: transparent !important;
+    border-left-color: var(--pa-tooltip-bg) !important;
+  }
+
+  &--auto-flip-left:hover::before,
+  &--auto-flip-left: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-secondary);
+    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-primary);
+    }
+  }
+
+  &__body {
+    padding: $spacing-base;
+    font-size: $font-size-sm;
+    line-height: $line-height-base;
+    color: var(--pa-text-primary);
+
+    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-left: $spacing-lg;
+    }
+
+    code {
+      padding: $popover-code-padding-v $popover-code-padding-h;
+      background-color: color-mix(in srgb, var(--pa-text-secondary) 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-secondary);
+    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-secondary) 10%, transparent);
+      color: var(--pa-text-primary);
+    }
+  }
+
+  // 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;
+  }
+}
+
+// ========================================
+// 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: left;
+    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);
+  }
+}