@pine-ds/core 3.17.0 → 3.19.0

package/components/truncation-tooltip.js

@@ -0,0 +1,247 @@
+import { c as computePosition, o as offset, f as flip, s as shift } from './floating-ui.dom.js';
+
+/** CSS class prefix used for truncation tooltip portal elements */
+const TOOLTIP_CLASS = 'pds-truncation-tooltip';
+/**
+ * Injects the truncation tooltip styles into the document head.
+ * Uses the same design tokens as pds-tooltip for visual consistency.
+ * Only injects once — checks the DOM to avoid duplicates.
+ *
+ * Z-Index Strategy:
+ * Uses --pine-z-index-nuclear (9999) to ensure tooltips appear above all other UI elements.
+ * This is necessary because tooltips are portaled to document.body and must overlay:
+ * - Modal dialogs
+ * - Dropdown menus
+ * - Other floating UI elements
+ * If you encounter z-index conflicts, ensure your overlays use Pine's z-index tokens
+ * or adjust --pine-z-index-nuclear in your theme.
+ */
+function injectStyles() {
+    if (document.querySelector('[data-pds-truncation-tooltip]'))
+        return;
+    const style = document.createElement('style');
+    style.setAttribute('data-pds-truncation-tooltip', '');
+    style.textContent = `
+    .${TOOLTIP_CLASS} {
+      position: fixed;
+      z-index: var(--pine-z-index-nuclear, 9999);
+    }
+    .${TOOLTIP_CLASS}__content {
+      background-color: var(--pine-color-primary, #1a1a2e);
+      border-radius: calc(var(--pine-dimension-xs, 4px) * 1.25);
+      box-shadow: var(--pine-box-shadow, 0 2px 8px rgba(0,0,0,0.15));
+      color: var(--pine-color-text-primary, #fff);
+      cursor: text;
+      font-family: var(--pine-font-family-body, sans-serif);
+      font-size: var(--pine-font-size-body-sm, 0.875rem);
+      letter-spacing: var(--pine-letter-spacing, normal);
+      line-height: var(--pine-line-height-body, 1.5);
+      max-width: 320px;
+      opacity: 0;
+      padding: var(--pine-dimension-xs, 4px) calc(var(--pine-dimension-md, 12px) / 2);
+      transition: opacity 0.15s ease-in-out, visibility 0.15s ease-in-out;
+      user-select: text;
+      visibility: hidden;
+      width: max-content;
+      word-break: break-word;
+    }
+    .${TOOLTIP_CLASS}--visible .${TOOLTIP_CLASS}__content {
+      opacity: 1;
+      visibility: visible;
+    }
+  `;
+    document.head.appendChild(style);
+}
+/**
+ * Checks if an element's content is overflowing horizontally (i.e. text is truncated).
+ */
+function isOverflowing(el) {
+    return el.scrollWidth > el.clientWidth;
+}
+/**
+ * Sets up automatic tooltip behavior for a truncated element.
+ *
+ * When the element's text overflows, hovering or focusing the host element
+ * will display a tooltip showing the full text content. The tooltip is
+ * rendered as a portal on document.body and positioned with Floating UI.
+ *
+ * @returns A cleanup function that removes all listeners, observers, and DOM elements.
+ */
+function setupTruncationTooltip(options) {
+    const { hostEl, contentEl, getTooltipText, placement = 'top' } = options;
+    injectStyles();
+    let portalEl = null;
+    let isHovering = false;
+    let isHoveringPortal = false;
+    let isFocused = false;
+    let hideTimeout = null;
+    let resizeObserver = null;
+    let resizeDebounce = null;
+    // Use ResizeObserver to re-evaluate overflow when the element resizes
+    // Debounced to prevent performance issues during rapid window resizing
+    if (typeof ResizeObserver !== 'undefined') {
+        resizeObserver = new ResizeObserver(() => {
+            if (resizeDebounce) {
+                clearTimeout(resizeDebounce);
+            }
+            resizeDebounce = setTimeout(() => {
+                resizeDebounce = null;
+                // If tooltip is showing but text no longer overflows, hide it
+                if (portalEl && portalEl.isConnected && !isOverflowing(contentEl)) {
+                    hideTooltip();
+                }
+            }, 100);
+        });
+        resizeObserver.observe(contentEl);
+    }
+    function createPortal() {
+        if (portalEl)
+            return;
+        const text = getTooltipText();
+        if (!text || text.trim() === '')
+            return;
+        portalEl = document.createElement('div');
+        portalEl.className = TOOLTIP_CLASS;
+        portalEl.setAttribute('role', 'tooltip');
+        portalEl.setAttribute('aria-hidden', 'false');
+        const contentDiv = document.createElement('div');
+        contentDiv.className = `${TOOLTIP_CLASS}__content`;
+        contentDiv.textContent = text.trim();
+        portalEl.appendChild(contentDiv);
+        document.body.appendChild(portalEl);
+        // Allow the user to hover into the tooltip to select/copy text
+        portalEl.addEventListener('mouseenter', handlePortalMouseEnter);
+        portalEl.addEventListener('mouseleave', handlePortalMouseLeave);
+        positionTooltip().then(() => {
+            if (portalEl) {
+                portalEl.classList.add(`${TOOLTIP_CLASS}--visible`);
+            }
+        });
+    }
+    async function positionTooltip() {
+        if (!portalEl)
+            return;
+        try {
+            const { x, y } = await computePosition(hostEl, portalEl, {
+                placement,
+                strategy: 'fixed',
+                middleware: [offset(4), flip(), shift({ padding: 5 })],
+            });
+            Object.assign(portalEl.style, {
+                left: `${x}px`,
+                top: `${y}px`,
+            });
+        }
+        catch (_a) {
+            // Fallback: position above the element with bounds checking
+            if (portalEl) {
+                const rect = hostEl.getBoundingClientRect();
+                const portalRect = portalEl.getBoundingClientRect();
+                const padding = 5;
+                // Ensure tooltip stays within viewport bounds
+                const left = Math.max(padding, Math.min(rect.left, window.innerWidth - portalRect.width - padding));
+                const top = Math.max(padding, rect.top - portalRect.height - 8);
+                portalEl.style.left = `${left}px`;
+                portalEl.style.top = `${top}px`;
+            }
+        }
+    }
+    function removePortal() {
+        if (portalEl) {
+            portalEl.removeEventListener('mouseenter', handlePortalMouseEnter);
+            portalEl.removeEventListener('mouseleave', handlePortalMouseLeave);
+            portalEl.classList.remove(`${TOOLTIP_CLASS}--visible`);
+            // Check if portal is still in the DOM before removing
+            if (portalEl.parentNode && portalEl.isConnected) {
+                try {
+                    portalEl.parentNode.removeChild(portalEl);
+                }
+                catch (e) {
+                    // Portal was already removed, ignore error
+                }
+            }
+            portalEl = null;
+        }
+    }
+    function cancelHideTimeout() {
+        if (hideTimeout !== null) {
+            clearTimeout(hideTimeout);
+            hideTimeout = null;
+        }
+    }
+    function showTooltip() {
+        cancelHideTimeout();
+        if (!isOverflowing(contentEl))
+            return;
+        createPortal();
+    }
+    function hideTooltip() {
+        if (isHovering || isHoveringPortal || isFocused)
+            return;
+        removePortal();
+    }
+    /**
+     * Schedules tooltip removal after a short delay.
+     *
+     * The 100ms delay serves two purposes:
+     * 1. Gives users time to move their cursor from the truncated text to the tooltip portal
+     *    without it closing, enabling text selection/copying from the tooltip
+     * 2. Prevents flickering when the user briefly moves the cursor during normal interaction
+     */
+    function scheduleHide() {
+        cancelHideTimeout();
+        hideTimeout = setTimeout(() => {
+            hideTimeout = null;
+            hideTooltip();
+        }, 100);
+    }
+    function handleMouseEnter() {
+        isHovering = true;
+        showTooltip();
+    }
+    function handleMouseLeave() {
+        isHovering = false;
+        scheduleHide();
+    }
+    function handlePortalMouseEnter() {
+        isHoveringPortal = true;
+        cancelHideTimeout();
+    }
+    function handlePortalMouseLeave() {
+        isHoveringPortal = false;
+        scheduleHide();
+    }
+    function handleFocusIn() {
+        isFocused = true;
+        showTooltip();
+    }
+    function handleFocusOut() {
+        isFocused = false;
+        scheduleHide();
+    }
+    hostEl.addEventListener('mouseenter', handleMouseEnter);
+    hostEl.addEventListener('mouseleave', handleMouseLeave);
+    hostEl.addEventListener('focusin', handleFocusIn);
+    hostEl.addEventListener('focusout', handleFocusOut);
+    // Return cleanup function
+    return () => {
+        cancelHideTimeout();
+        if (resizeDebounce) {
+            clearTimeout(resizeDebounce);
+            resizeDebounce = null;
+        }
+        if (resizeObserver) {
+            resizeObserver.disconnect();
+        }
+        hostEl.removeEventListener('mouseenter', handleMouseEnter);
+        hostEl.removeEventListener('mouseleave', handleMouseLeave);
+        hostEl.removeEventListener('focusin', handleFocusIn);
+        hostEl.removeEventListener('focusout', handleFocusOut);
+        removePortal();
+    };
+}
+
+export { setupTruncationTooltip as s };
+//# sourceMappingURL=truncation-tooltip.js.map
+
+//# sourceMappingURL=truncation-tooltip.js.map

package/components/truncation-tooltip.js.map

@@ -0,0 +1 @@
+{"file":"truncation-tooltip.js","mappings":"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","names":[],"sources":["src/utils/truncation-tooltip.ts"],"sourcesContent":["import { PlacementType } from './types';\nimport {\n  computePosition,\n  flip,\n  offset,\n  shift,\n} from '@floating-ui/dom';\n\nexport interface TruncationTooltipOptions {\n  /** The host element (for hover/focus listeners and positioning anchor) */\n  hostEl: HTMLElement;\n  /** The inner element where overflow actually occurs (inside shadow root) */\n  contentEl: HTMLElement;\n  /** Function that returns the full text to display in the tooltip */\n  getTooltipText: () => string;\n  /** Tooltip placement preference (default: 'top') */\n  placement?: PlacementType;\n}\n\n/** CSS class prefix used for truncation tooltip portal elements */\nconst TOOLTIP_CLASS = 'pds-truncation-tooltip';\n\n/**\n * Injects the truncation tooltip styles into the document head.\n * Uses the same design tokens as pds-tooltip for visual consistency.\n * Only injects once — checks the DOM to avoid duplicates.\n *\n * Z-Index Strategy:\n * Uses --pine-z-index-nuclear (9999) to ensure tooltips appear above all other UI elements.\n * This is necessary because tooltips are portaled to document.body and must overlay:\n * - Modal dialogs\n * - Dropdown menus\n * - Other floating UI elements\n * If you encounter z-index conflicts, ensure your overlays use Pine's z-index tokens\n * or adjust --pine-z-index-nuclear in your theme.\n */\nfunction injectStyles(): void {\n  if (document.querySelector('[data-pds-truncation-tooltip]')) return;\n\n  const style = document.createElement('style');\n  style.setAttribute('data-pds-truncation-tooltip', '');\n  style.textContent = `\n    .${TOOLTIP_CLASS} {\n      position: fixed;\n      z-index: var(--pine-z-index-nuclear, 9999);\n    }\n    .${TOOLTIP_CLASS}__content {\n      background-color: var(--pine-color-primary, #1a1a2e);\n      border-radius: calc(var(--pine-dimension-xs, 4px) * 1.25);\n      box-shadow: var(--pine-box-shadow, 0 2px 8px rgba(0,0,0,0.15));\n      color: var(--pine-color-text-primary, #fff);\n      cursor: text;\n      font-family: var(--pine-font-family-body, sans-serif);\n      font-size: var(--pine-font-size-body-sm, 0.875rem);\n      letter-spacing: var(--pine-letter-spacing, normal);\n      line-height: var(--pine-line-height-body, 1.5);\n      max-width: 320px;\n      opacity: 0;\n      padding: var(--pine-dimension-xs, 4px) calc(var(--pine-dimension-md, 12px) / 2);\n      transition: opacity 0.15s ease-in-out, visibility 0.15s ease-in-out;\n      user-select: text;\n      visibility: hidden;\n      width: max-content;\n      word-break: break-word;\n    }\n    .${TOOLTIP_CLASS}--visible .${TOOLTIP_CLASS}__content {\n      opacity: 1;\n      visibility: visible;\n    }\n  `;\n  document.head.appendChild(style);\n}\n\n/**\n * Checks if an element's content is overflowing horizontally (i.e. text is truncated).\n */\nfunction isOverflowing(el: HTMLElement): boolean {\n  return el.scrollWidth > el.clientWidth;\n}\n\n/**\n * Sets up automatic tooltip behavior for a truncated element.\n *\n * When the element's text overflows, hovering or focusing the host element\n * will display a tooltip showing the full text content. The tooltip is\n * rendered as a portal on document.body and positioned with Floating UI.\n *\n * @returns A cleanup function that removes all listeners, observers, and DOM elements.\n */\nexport function setupTruncationTooltip(options: TruncationTooltipOptions): () => void {\n  const { hostEl, contentEl, getTooltipText, placement = 'top' } = options;\n\n  injectStyles();\n\n  let portalEl: HTMLElement | null = null;\n  let isHovering = false;\n  let isHoveringPortal = false;\n  let isFocused = false;\n  let hideTimeout: ReturnType<typeof setTimeout> | null = null;\n  let resizeObserver: ResizeObserver | null = null;\n  let resizeDebounce: ReturnType<typeof setTimeout> | null = null;\n\n  // Use ResizeObserver to re-evaluate overflow when the element resizes\n  // Debounced to prevent performance issues during rapid window resizing\n  if (typeof ResizeObserver !== 'undefined') {\n    resizeObserver = new ResizeObserver(() => {\n      if (resizeDebounce) {\n        clearTimeout(resizeDebounce);\n      }\n      resizeDebounce = setTimeout(() => {\n        resizeDebounce = null;\n        // If tooltip is showing but text no longer overflows, hide it\n        if (portalEl && portalEl.isConnected && !isOverflowing(contentEl)) {\n          hideTooltip();\n        }\n      }, 100);\n    });\n    resizeObserver.observe(contentEl);\n  }\n\n  function createPortal(): void {\n    if (portalEl) return;\n\n    const text = getTooltipText();\n    if (!text || text.trim() === '') return;\n\n    portalEl = document.createElement('div');\n    portalEl.className = TOOLTIP_CLASS;\n    portalEl.setAttribute('role', 'tooltip');\n    portalEl.setAttribute('aria-hidden', 'false');\n\n    const contentDiv = document.createElement('div');\n    contentDiv.className = `${TOOLTIP_CLASS}__content`;\n    contentDiv.textContent = text.trim();\n\n    portalEl.appendChild(contentDiv);\n    document.body.appendChild(portalEl);\n\n    // Allow the user to hover into the tooltip to select/copy text\n    portalEl.addEventListener('mouseenter', handlePortalMouseEnter);\n    portalEl.addEventListener('mouseleave', handlePortalMouseLeave);\n\n    positionTooltip().then(() => {\n      if (portalEl) {\n        portalEl.classList.add(`${TOOLTIP_CLASS}--visible`);\n      }\n    });\n  }\n\n  async function positionTooltip(): Promise<void> {\n    if (!portalEl) return;\n\n    try {\n      const { x, y } = await computePosition(hostEl, portalEl, {\n        placement,\n        strategy: 'fixed',\n        middleware: [offset(4), flip(), shift({ padding: 5 })],\n      });\n\n      Object.assign(portalEl.style, {\n        left: `${x}px`,\n        top: `${y}px`,\n      });\n    } catch {\n      // Fallback: position above the element with bounds checking\n      if (portalEl) {\n        const rect = hostEl.getBoundingClientRect();\n        const portalRect = portalEl.getBoundingClientRect();\n        const padding = 5;\n\n        // Ensure tooltip stays within viewport bounds\n        const left = Math.max(padding, Math.min(rect.left, window.innerWidth - portalRect.width - padding));\n        const top = Math.max(padding, rect.top - portalRect.height - 8);\n\n        portalEl.style.left = `${left}px`;\n        portalEl.style.top = `${top}px`;\n      }\n    }\n  }\n\n  function removePortal(): void {\n    if (portalEl) {\n      portalEl.removeEventListener('mouseenter', handlePortalMouseEnter);\n      portalEl.removeEventListener('mouseleave', handlePortalMouseLeave);\n      portalEl.classList.remove(`${TOOLTIP_CLASS}--visible`);\n      // Check if portal is still in the DOM before removing\n      if (portalEl.parentNode && portalEl.isConnected) {\n        try {\n          portalEl.parentNode.removeChild(portalEl);\n        } catch (e) {\n          // Portal was already removed, ignore error\n        }\n      }\n      portalEl = null;\n    }\n  }\n\n  function cancelHideTimeout(): void {\n    if (hideTimeout !== null) {\n      clearTimeout(hideTimeout);\n      hideTimeout = null;\n    }\n  }\n\n  function showTooltip(): void {\n    cancelHideTimeout();\n    if (!isOverflowing(contentEl)) return;\n    createPortal();\n  }\n\n  function hideTooltip(): void {\n    if (isHovering || isHoveringPortal || isFocused) return;\n    removePortal();\n  }\n\n  /**\n   * Schedules tooltip removal after a short delay.\n   *\n   * The 100ms delay serves two purposes:\n   * 1. Gives users time to move their cursor from the truncated text to the tooltip portal\n   *    without it closing, enabling text selection/copying from the tooltip\n   * 2. Prevents flickering when the user briefly moves the cursor during normal interaction\n   */\n  function scheduleHide(): void {\n    cancelHideTimeout();\n    hideTimeout = setTimeout(() => {\n      hideTimeout = null;\n      hideTooltip();\n    }, 100);\n  }\n\n  function handleMouseEnter(): void {\n    isHovering = true;\n    showTooltip();\n  }\n\n  function handleMouseLeave(): void {\n    isHovering = false;\n    scheduleHide();\n  }\n\n  function handlePortalMouseEnter(): void {\n    isHoveringPortal = true;\n    cancelHideTimeout();\n  }\n\n  function handlePortalMouseLeave(): void {\n    isHoveringPortal = false;\n    scheduleHide();\n  }\n\n  function handleFocusIn(): void {\n    isFocused = true;\n    showTooltip();\n  }\n\n  function handleFocusOut(): void {\n    isFocused = false;\n    scheduleHide();\n  }\n\n  hostEl.addEventListener('mouseenter', handleMouseEnter);\n  hostEl.addEventListener('mouseleave', handleMouseLeave);\n  hostEl.addEventListener('focusin', handleFocusIn);\n  hostEl.addEventListener('focusout', handleFocusOut);\n\n  // Return cleanup function\n  return () => {\n    cancelHideTimeout();\n    if (resizeDebounce) {\n      clearTimeout(resizeDebounce);\n      resizeDebounce = null;\n    }\n    if (resizeObserver) {\n      resizeObserver.disconnect();\n    }\n    hostEl.removeEventListener('mouseenter', handleMouseEnter);\n    hostEl.removeEventListener('mouseleave', handleMouseLeave);\n    hostEl.removeEventListener('focusin', handleFocusIn);\n    hostEl.removeEventListener('focusout', handleFocusOut);\n    removePortal();\n  };\n}\n"],"version":3}

package/dist/cjs/{index-DkQebouX.js → index-CjhTEk39.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-/* pds-icons v9.15.0, ES Modules */
+/* pds-icons v9.16.0, ES Modules */
 
 const addCircle = "data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' class='pdsicon'><path fill-rule='evenodd' d='M12 3a9 9 0 1 0 0 18 9 9 0 0 0 0-18M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12m11-5a1 1 0 0 1 1 1v3h3a1 1 0 1 1 0 2h-3v3a1 1 0 1 1-2 0v-3H8a1 1 0 1 1 0-2h3V8a1 1 0 0 1 1-1'/></svg>";
 const caretDown = "data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' class='pdsicon'><path fill-rule='evenodd' d='M5.293 8.293a1 1 0 0 1 1.414 0L12 13.586l5.293-5.293a1 1 0 1 1 1.414 1.414l-6 6a1 1 0 0 1-1.414 0l-6-6a1 1 0 0 1 0-1.414'/></svg>";
@@ -29,6 +29,6 @@ exports.remove = remove;
 exports.trash = trash;
 exports.upSmall = upSmall;
 exports.userFilled = userFilled;
-//# sourceMappingURL=index-DkQebouX.js.map
+//# sourceMappingURL=index-CjhTEk39.js.map
 
-//# sourceMappingURL=index-DkQebouX.js.map
+//# sourceMappingURL=index-CjhTEk39.js.map