pixel-react 1.22.5 → 1.22.6

package/lib/components/TooltipService/TooltipService.js

@@ -1,7 +1,8 @@
 import { useEffect } from 'react';
-import { delegate, hideAll } from 'tippy.js';
+import tippy, { hideAll } from 'tippy.js';
 import 'tippy.js/dist/tippy.css';
 import './TooltipService.scss';
+const TOOLTIP_TARGET = '[data-tooltip], [data-tooltip-id], [data-tooltip-overflow]';
 const VALID_PLACEMENTS = new Set([
     'auto',
     'auto-start',
@@ -19,6 +20,30 @@ const VALID_PLACEMENTS = new Set([
     'left-start',
     'left-end',
 ]);
+const TOOLTIP_PROPS = {
+    arrow: false,
+    theme: 'ff-global-tooltip',
+    appendTo: () => document.body,
+    allowHTML: true,
+    popperOptions: {
+        modifiers: [
+            {
+                name: 'preventOverflow',
+                options: {
+                    altAxis: true,
+                    padding: 8,
+                },
+            },
+            {
+                name: 'flip',
+                options: {
+                    padding: 8,
+                    fallbackPlacements: ['top', 'right', 'left'],
+                },
+            },
+        ],
+    },
+};
 const getTooltipContent = (reference) => {
     const contentNode = document.createElement('div');
     // Accept template content via id
@@ -45,16 +70,34 @@ const getTooltipContent = (reference) => {
             return contentNode;
         }
     }
-    const rawText = reference.getAttribute('data-tooltip') || '';
+    // An overflow-only element without its own text shows the text it cuts off
+    const rawText = reference.getAttribute('data-tooltip') ||
+        (reference.hasAttribute('data-tooltip-overflow')
+            ? reference.textContent
+            : '') ||
+        '';
     if (!rawText.trim())
         return '';
-    const text = rawText
-        .replace(/\\n/g, ' ')
-        .replace(/\n/g, ' ')
-        .replace(/\s+/g, ' ')
-        .trim();
+    // `data-tooltip-multiline` keeps the text's line breaks (\n), e.g. one
+    // `name: value` per line; otherwise all whitespace collapses to single spaces
+    const multiline = reference.hasAttribute('data-tooltip-multiline');
+    const text = multiline
+        ? rawText
+            .split(/\r?\n/)
+            .map((line) => line.replace(/\s+/g, ' ').trim())
+            .filter(Boolean)
+            .join('\n')
+        : rawText
+            .replace(/\\n/g, ' ')
+            .replace(/\n/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim();
     if (!text)
         return '';
+    if (multiline) {
+        contentNode.style.whiteSpace = 'pre-line';
+        contentNode.style.textAlign = 'left';
+    }
     const isPureHTML = text.trim().startsWith('<') && text.trim().endsWith('>');
     const hasHTML = /<(?:[a-z][\s\S]*>|\/[a-z0-9]+>)|&[#a-zA-Z0-9]+;/i.test(text);
     const allowHTML = reference.hasAttribute('data-tooltip-allowhtml');
@@ -79,118 +122,185 @@ const getTooltipContent = (reference) => {
     }
     return contentNode;
 };
-const TooltipService = () => {
-    useEffect(() => {
-        const hideTooltipsOnScroll = (event) => {
-            const target = event.target;
-            if (target instanceof Element && target.closest('[data-tippy-root]')) {
-                return;
+// One-line ellipsis cut-off, read only when the element is hovered
+const isClipped = (element) => element.scrollWidth > element.clientWidth + 0.5;
+// The innermost element with something to show. A `data-tooltip-overflow`
+// element counts only while its text is cut off; otherwise the next one out is tried.
+const findTooltipTarget = (start) => {
+    let element = start.closest(TOOLTIP_TARGET);
+    while (element) {
+        const overflowOnly = element.hasAttribute('data-tooltip-overflow');
+        if ((!overflowOnly || isClipped(element)) &&
+            getTooltipContent(element) !== '') {
+            return element;
+        }
+        element = element.parentElement?.closest(TOOLTIP_TARGET) ?? null;
+    }
+    return null;
+};
+// Tippy's own ARIA, except where it would be wrong: a hoverable tooltip is not
+// interactive, so it still describes its element and sets no aria-expanded;
+// and text shown only because an ellipsis cuts it off repeats what the element
+// already says, so it is not added as a description
+const getAria = (reference) => {
+    if (reference.hasAttribute('data-tooltip-interactive'))
+        return {};
+    const repeatsOwnText = reference.hasAttribute('data-tooltip-overflow') &&
+        !reference.hasAttribute('data-tooltip') &&
+        !reference.hasAttribute('data-tooltip-id');
+    if (!repeatsOwnText && !reference.hasAttribute('data-tooltip-hoverable')) {
+        return {};
+    }
+    return {
+        aria: { expanded: false, content: repeatsOwnText ? null : 'describedby' },
+    };
+};
+const getPlacement = (reference) => {
+    //  placement attribute for tooltip
+    const normalizedPlacement = reference
+        .getAttribute('data-tooltip-placement')
+        ?.trim()
+        .toLowerCase();
+    return normalizedPlacement && VALID_PLACEMENTS.has(normalizedPlacement)
+        ? normalizedPlacement
+        : 'bottom';
+};
+/**
+ * Shows at most one tooltip at a time. The instance is created when its element
+ * is hovered or focused and destroyed when it hides, so nothing is kept for
+ * elements that were hovered and later removed (e.g. virtualized rows).
+ */
+const startTooltips = () => {
+    let active = null;
+    // Closed with Escape: stays hidden until the pointer or focus leaves it
+    let dismissed = null;
+    // While a tooltip shows: refresh it when its attributes change, and drop it
+    // when its element leaves the page
+    const activeObserver = new MutationObserver((records) => {
+        if (!active)
+            return;
+        if (!active.reference.isConnected) {
+            destroyActive();
+            return;
+        }
+        if (records.some((record) => record.type === 'attributes')) {
+            const content = getTooltipContent(active.reference);
+            if (content === '') {
+                destroyActive();
             }
-            hideAll({ duration: 0 });
-        };
-        window.addEventListener('scroll', hideTooltipsOnScroll, true);
-        const instance = delegate(document.body, {
-            target: '[data-tooltip], [data-tooltip-id]',
-            arrow: false,
-            placement: 'bottom',
-            theme: 'ff-global-tooltip',
-            appendTo: document.body,
-            allowHTML: true,
-            popperOptions: {
-                modifiers: [
-                    {
-                        name: 'preventOverflow',
-                        options: {
-                            altAxis: true,
-                            padding: 8,
-                        },
-                    },
-                    {
-                        name: 'flip',
-                        options: {
-                            padding: 8,
-                            fallbackPlacements: ['top', 'right', 'left'],
-                        },
-                    },
-                ],
-            },
-            content(reference) {
-                return getTooltipContent(reference);
-            },
-            onShow(tippyInstance) {
-                const { reference } = tippyInstance;
-                if (!document.body.contains(reference)) {
-                    return false;
-                }
-                const latestContent = getTooltipContent(reference);
-                // If no tooltip content is currently available, prevent showing.
-                if (latestContent === '') {
+            else {
+                active.setContent(content);
+            }
+        }
+    });
+    const destroyActive = () => {
+        activeObserver.disconnect();
+        active?.destroy();
+        active = null;
+    };
+    const show = (reference) => {
+        destroyActive();
+        // Another copy of this service (e.g. from a second bundle) already handles it
+        if (reference._tippy)
+            return;
+        active = tippy(reference, {
+            ...TOOLTIP_PROPS,
+            content: getTooltipContent(reference),
+            placement: getPlacement(reference),
+            // This is  specific tooltip attributefor interactive. A hoverable
+            // tooltip uses it only so the pointer can move onto it (WCAG 1.4.13).
+            interactive: reference.hasAttribute('data-tooltip-interactive') ||
+                reference.hasAttribute('data-tooltip-hoverable'),
+            ...getAria(reference),
+            showOnCreate: true,
+            onShow(instance) {
+                if (!instance.reference.isConnected)
                     return false;
-                }
-                // This is  specific tooltip attributefor interactive
-                const isInteractive = tippyInstance.reference.hasAttribute('data-tooltip-interactive');
-                //  placement attribute for tooltip
-                const rawPlacement = tippyInstance.reference.getAttribute('data-tooltip-placement');
-                const normalizedPlacement = rawPlacement?.trim().toLowerCase();
-                const placement = normalizedPlacement && VALID_PLACEMENTS.has(normalizedPlacement)
-                    ? normalizedPlacement
-                    : 'bottom';
-                tippyInstance.setProps({
-                    interactive: isInteractive,
-                    placement,
-                    content: latestContent,
-                });
-            },
-            onCreate(tippyInstance) {
-                const attrObserver = new MutationObserver(() => {
-                    if (tippyInstance.state.isVisible) {
-                        const newContent = getTooltipContent(tippyInstance.reference);
-                        if (newContent === '') {
-                            tippyInstance.hide();
-                        }
-                        else {
-                            tippyInstance.setContent(newContent);
-                        }
-                    }
-                });
-                attrObserver.observe(tippyInstance.reference, {
-                    attributes: true,
-                    attributeFilter: ['data-tooltip', 'data-tooltip-id'],
-                });
-                tippyInstance._attrObserver = attrObserver;
-                const parentEl = tippyInstance.reference.parentElement;
-                if (parentEl) {
-                    const domObserver = new MutationObserver(() => {
-                        if (!document.body.contains(tippyInstance.reference)) {
-                            tippyInstance.hide();
-                            tippyInstance.destroy();
-                        }
-                    });
-                    domObserver.observe(parentEl, { childList: true });
-                    tippyInstance._domObserver = domObserver;
-                }
-            },
-            onDestroy(tippyInstance) {
-                tippyInstance._attrObserver?.disconnect();
-                tippyInstance._domObserver?.disconnect();
             },
-            onMount(tippyInstance) {
-                const isExplicitlyInteractive = tippyInstance.reference.hasAttribute('data-tooltip-interactive');
+            onMount(instance) {
+                const isExplicitlyInteractive = instance.reference.hasAttribute('data-tooltip-interactive');
                 if (!isExplicitlyInteractive) {
-                    const tippyBox = tippyInstance.popper.querySelector('.tippy-box');
+                    const tippyBox = instance.popper.querySelector('.tippy-box');
                     if (tippyBox && tippyBox.scrollHeight > tippyBox.clientHeight) {
-                        tippyInstance.setProps({ interactive: true });
+                        instance.setProps({ interactive: true });
                     }
                 }
             },
+            onHidden(instance) {
+                if (instance === active) {
+                    destroyActive();
+                }
+                else {
+                    instance.destroy();
+                }
+            },
+        });
+        activeObserver.observe(reference, {
+            attributes: true,
+            attributeFilter: ['data-tooltip', 'data-tooltip-id'],
         });
+        activeObserver.observe(document.body, { childList: true, subtree: true });
+    };
+    const handlePointerOrFocus = (event) => {
+        const { target } = event;
+        if (!(target instanceof Element))
+            return;
+        // Moving into an interactive tooltip keeps it open
+        if (active?.popper.contains(target))
+            return;
+        if (dismissed && !dismissed.contains(target))
+            dismissed = null;
+        // Nothing new under the pointer: the shown tooltip hides itself on mouseleave
+        const closest = target.closest(TOOLTIP_TARGET);
+        if (!closest || closest === active?.reference)
+            return;
+        const reference = findTooltipTarget(closest);
+        if (reference &&
+            reference !== active?.reference &&
+            reference !== dismissed) {
+            show(reference);
+        }
+    };
+    // Escape hides the tooltip without moving the pointer or focus (WCAG 1.4.13)
+    const hideOnEscape = (event) => {
+        if (event.key !== 'Escape' || !active)
+            return;
+        dismissed = active.reference;
+        destroyActive();
+    };
+    const hideTooltipsOnScroll = (event) => {
+        const target = event.target;
+        if (target instanceof Element && target.closest('[data-tippy-root]')) {
+            return;
+        }
+        hideAll({ duration: 0 });
+        destroyActive();
+    };
+    document.addEventListener('mouseover', handlePointerOrFocus);
+    document.addEventListener('focusin', handlePointerOrFocus);
+    document.addEventListener('keydown', hideOnEscape);
+    window.addEventListener('scroll', hideTooltipsOnScroll, true);
+    return () => {
+        document.removeEventListener('mouseover', handlePointerOrFocus);
+        document.removeEventListener('focusin', handlePointerOrFocus);
+        document.removeEventListener('keydown', hideOnEscape);
+        window.removeEventListener('scroll', hideTooltipsOnScroll, true);
+        destroyActive();
+    };
+};
+// Every mounted TooltipService shares one set of listeners
+let mountedServices = 0;
+let stopTooltips = null;
+const TooltipService = () => {
+    useEffect(() => {
+        mountedServices += 1;
+        if (mountedServices === 1)
+            stopTooltips = startTooltips();
         return () => {
-            window.removeEventListener('scroll', hideTooltipsOnScroll, true);
-            if (Array.isArray(instance)) {
-                instance.forEach((i) => i.destroy());
-            }
-            else {
-                instance.destroy();
+            mountedServices -= 1;
+            if (mountedServices === 0) {
+                stopTooltips?.();
+                stopTooltips = null;
             }
         };
     }, []);

package/lib/components/TooltipService/TooltipService.js.map

@@ -1 +1 @@
-{"version":3,"file":"TooltipService.js","sourceRoot":"","sources":["../../../src/components/TooltipService/TooltipService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TooltipService.js","sourceRoot":"","sources":["../../../src/components/TooltipService/TooltipService.ts"],"names":[],"mappings":"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"}

package/lib/hooks/useFocusTrap.d.ts

@@ -0,0 +1,29 @@
+import { RefObject } from 'react';
+/**
+ * Remembers the element that had focus when `isOpen` became true, read during
+ * render — before children with autoFocus take focus — so it can be restored.
+ */
+export declare const useOpenerElement: (isOpen: boolean) => import("react").MutableRefObject<HTMLElement | null>;
+interface FocusTrapOptions {
+    active: boolean;
+    /** Element to focus on activation; defaults to the first focusable child. */
+    initialFocusRef?: RefObject<HTMLElement>;
+    /** Return focus to the element that was focused before activation. */
+    restoreFocus?: boolean;
+    /** Explicit element to return focus to (see useOpenerElement). */
+    returnFocusRef?: RefObject<HTMLElement | null>;
+    /**
+     * Keep Tab/Shift+Tab inside the container (modal). When false, focus only
+     * moves in on activation and back out afterwards (non-modal panel).
+     */
+    trapTab?: boolean;
+}
+export declare const isTopMostFocusTrap: (container: HTMLElement | null) => boolean;
+export declare const getTopMostFocusTrap: () => HTMLElement | null;
+/**
+ * Moves keyboard focus into a dialog when it opens, optionally keeps it there
+ * while it is modal, and restores it to the trigger afterwards — WCAG 2.4.3
+ * Focus Order and 2.1.2 No Keyboard Trap (focus is released on close).
+ */
+declare const useFocusTrap: (containerRef: RefObject<HTMLElement>, { active, initialFocusRef, restoreFocus, trapTab, returnFocusRef, }: FocusTrapOptions) => void;
+export default useFocusTrap;

package/lib/hooks/useFocusTrap.js

@@ -0,0 +1,97 @@
+import { useEffect, useRef } from 'react';
+import { getFocusableElements } from '../utils/a11y/a11y';
+/**
+ * Remembers the element that had focus when `isOpen` became true, read during
+ * render — before children with autoFocus take focus — so it can be restored.
+ */
+export const useOpenerElement = (isOpen) => {
+    const openerRef = useRef(null);
+    const wasOpenRef = useRef(false);
+    if (isOpen && !wasOpenRef.current && typeof document !== 'undefined') {
+        const focused = document.activeElement;
+        openerRef.current =
+            focused instanceof HTMLElement && focused !== document.body
+                ? focused
+                : null;
+    }
+    wasOpenRef.current = isOpen;
+    return openerRef;
+};
+// Traps are stacked so only the top-most dialog handles Tab and Escape.
+const trapStack = [];
+export const isTopMostFocusTrap = (container) => !!container && trapStack[trapStack.length - 1] === container;
+export const getTopMostFocusTrap = () => trapStack[trapStack.length - 1] ?? null;
+/**
+ * Moves keyboard focus into a dialog when it opens, optionally keeps it there
+ * while it is modal, and restores it to the trigger afterwards — WCAG 2.4.3
+ * Focus Order and 2.1.2 No Keyboard Trap (focus is released on close).
+ */
+const useFocusTrap = (containerRef, { active, initialFocusRef, restoreFocus = true, trapTab = true, returnFocusRef, }) => {
+    useEffect(() => {
+        const container = containerRef.current;
+        if (!active || !container)
+            return undefined;
+        const focusedNow = document.activeElement instanceof HTMLElement
+            ? document.activeElement
+            : null;
+        // Prefer the opener captured at render; otherwise whatever had focus,
+        // unless that is already inside the container (e.g. an autoFocus field).
+        const previouslyFocused = returnFocusRef?.current ??
+            (focusedNow && !container.contains(focusedNow) ? focusedNow : null);
+        if (trapTab)
+            trapStack.push(container);
+        // Deferred so children using autoFocus win, and portal content is laid out.
+        const frame = requestAnimationFrame(() => {
+            if (container.contains(document.activeElement))
+                return;
+            const target = initialFocusRef?.current ??
+                getFocusableElements(container)[0] ??
+                container;
+            target.focus({ preventScroll: true });
+        });
+        const handleKeyDown = (event) => {
+            if (event.key !== 'Tab' ||
+                // Composite widgets (e.g. a spreadsheet) may use Tab internally.
+                event.defaultPrevented ||
+                !isTopMostFocusTrap(container)) {
+                return;
+            }
+            const focusable = getFocusableElements(container);
+            const first = focusable[0];
+            const last = focusable[focusable.length - 1];
+            if (!first || !last) {
+                event.preventDefault();
+                container.focus({ preventScroll: true });
+                return;
+            }
+            const activeElement = document.activeElement;
+            const focusIsOutside = !container.contains(activeElement);
+            if (event.shiftKey && (activeElement === first || focusIsOutside)) {
+                event.preventDefault();
+                last.focus();
+            }
+            else if (!event.shiftKey && (activeElement === last || focusIsOutside)) {
+                event.preventDefault();
+                first.focus();
+            }
+        };
+        if (trapTab)
+            document.addEventListener('keydown', handleKeyDown);
+        return () => {
+            cancelAnimationFrame(frame);
+            document.removeEventListener('keydown', handleKeyDown);
+            const index = trapStack.lastIndexOf(container);
+            if (index !== -1)
+                trapStack.splice(index, 1);
+            // Only restore when focus would otherwise be lost (inside the closing
+            // container or already on <body>), never steal it from elsewhere.
+            const focused = document.activeElement;
+            const focusWouldBeLost = !focused || focused === document.body || container.contains(focused);
+            if (restoreFocus && focusWouldBeLost && previouslyFocused?.isConnected) {
+                previouslyFocused.focus({ preventScroll: true });
+            }
+        };
+    }, [active, containerRef, initialFocusRef, restoreFocus, trapTab, returnFocusRef]);
+};
+export default useFocusTrap;
+//# sourceMappingURL=useFocusTrap.js.map

package/lib/hooks/useFocusTrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFocusTrap.js","sourceRoot":"","sources":["../../src/hooks/useFocusTrap.tsx"],"names":[],"mappings":"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"}

package/lib/hooks/useInteractiveAncestor.d.ts

@@ -0,0 +1,7 @@
+import { RefObject } from 'react';
+/**
+ * True when the element is rendered inside a control that already handles
+ * keyboard activation, so the element should not add its own tab stop.
+ */
+declare const useInteractiveAncestor: (ref: RefObject<HTMLElement>, enabled: boolean) => boolean;
+export default useInteractiveAncestor;

package/lib/hooks/useInteractiveAncestor.js

@@ -0,0 +1,18 @@
+import { useLayoutEffect, useState } from 'react';
+import { hasInteractiveAncestor } from '../utils/a11y/a11y';
+/**
+ * True when the element is rendered inside a control that already handles
+ * keyboard activation, so the element should not add its own tab stop.
+ */
+const useInteractiveAncestor = (ref, enabled) => {
+    const [isNested, setIsNested] = useState(false);
+    useLayoutEffect(() => {
+        if (!enabled)
+            return;
+        const nested = hasInteractiveAncestor(ref.current);
+        setIsNested((previous) => (previous === nested ? previous : nested));
+    }, [enabled, ref]);
+    return enabled && isNested;
+};
+export default useInteractiveAncestor;
+//# sourceMappingURL=useInteractiveAncestor.js.map

package/lib/hooks/useInteractiveAncestor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInteractiveAncestor.js","sourceRoot":"","sources":["../../src/hooks/useInteractiveAncestor.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,eAAe,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;GAGG;AACH,MAAM,sBAAsB,GAAG,CAC7B,GAA2B,EAC3B,OAAgB,EAChB,EAAE;IACF,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEhD,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnD,WAAW,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACvE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAEnB,OAAO,OAAO,IAAI,QAAQ,CAAC;AAC7B,CAAC,CAAC;AAEF,eAAe,sBAAsB,CAAC"}