@navikt/ds-react 7.32.1 → 7.32.3

package/esm/util/focus-boundary/FocusBoundary.js

@@ -0,0 +1,329 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import React, { forwardRef, useCallback, useEffect, useRef, useState, } from "react";
+import { Slot } from "../../slot/Slot.js";
+import { useMergeRefs } from "../../util/hooks/index.js";
+import { useEventCallback } from "../hooks/useEventCallback.js";
+const AUTOFOCUS_ON_MOUNT = "focusBoundary.autoFocusOnMount";
+const AUTOFOCUS_ON_UNMOUNT = "focusBoundary.autoFocusOnUnmount";
+const EVENT_OPTIONS = { bubbles: false, cancelable: true };
+const FocusBoundary = forwardRef((_a, forwardedRef) => {
+    var { loop = false, trapped = false, onMountAutoFocus: onMountAutoFocusProp, onUnmountAutoFocus: onUnmountAutoFocusProp } = _a, restProps = __rest(_a, ["loop", "trapped", "onMountAutoFocus", "onUnmountAutoFocus"]);
+    const onMountAutoFocus = useEventCallback(onMountAutoFocusProp);
+    const onUnmountAutoFocus = useEventCallback(onUnmountAutoFocusProp);
+    const lastFocusedElementRef = useRef(null);
+    const [container, setContainer] = useState(null);
+    const mergedRefs = useMergeRefs(forwardedRef, setContainer);
+    const focusBoundary = useRef({
+        paused: false,
+        pause() {
+            this.paused = true;
+        },
+        resume() {
+            this.paused = false;
+        },
+    }).current;
+    /* Handles trapped state */
+    useEffect(() => {
+        if (!trapped || !container) {
+            return;
+        }
+        function handleFocusIn(event) {
+            if (focusBoundary.paused || container === null) {
+                return;
+            }
+            const target = event.target;
+            if (container.contains(target)) {
+                lastFocusedElementRef.current = target;
+            }
+            else {
+                focus(lastFocusedElementRef.current, { select: true });
+            }
+        }
+        function handleFocusOut(event) {
+            if (focusBoundary.paused || container === null) {
+                return;
+            }
+            const relatedTarget = event.relatedTarget;
+            /*
+             * `focusout` event with a `null` `relatedTarget` will happen in a few known cases:
+             * 1. When the user switches app/tabs/windows/the browser itself loses focus.
+             * 2. In Google Chrome, when the focused element is removed from the DOM.
+             * 3. When clicking on an element that cannot receive focus.
+             *
+             * We let the browser do its thing here because:
+             * 1. The browser already keeps a memory of what's focused for when the page gets refocused.
+             * 2. In Google Chrome, if we try to focus the deleted focused element (as per below), it
+             * throws the CPU to 100%, so we avoid doing anything for this reason here too.
+             */
+            if (relatedTarget === null) {
+                return;
+            }
+            /*
+             * If the focus has moved to an element outside the container, we move focus to the last valid focused element inside.
+             * This makes sure to "trap" focus inside the container.
+             * We handle focus on focusout instead of focusin to avoid elements recieving focusin events
+             * when they are not supposed to (like when clicking on elements outside the container
+             */
+            if (!container.contains(relatedTarget)) {
+                focus(lastFocusedElementRef.current, { select: true });
+            }
+        }
+        /**
+         * When the currently focused element is removed from the DOM, browsers move focus
+         * to the document.body. In this case, we move focus to the container
+         * to keep focus trapped correctly instead.
+         */
+        const handleMutations = (mutations) => {
+            if (document.activeElement !== document.body) {
+                return;
+            }
+            if (mutations.some((mutation) => mutation.removedNodes.length > 0)) {
+                focus(container);
+            }
+        };
+        document.addEventListener("focusin", handleFocusIn);
+        document.addEventListener("focusout", handleFocusOut);
+        const observer = new MutationObserver(handleMutations);
+        observer.observe(container, { childList: true, subtree: true });
+        return () => {
+            document.removeEventListener("focusin", handleFocusIn);
+            document.removeEventListener("focusout", handleFocusOut);
+            observer.disconnect();
+        };
+    }, [trapped, container, focusBoundary.paused]);
+    /* Handles autofocus on mount and unmount */
+    useEffect(() => {
+        if (!container) {
+            return;
+        }
+        focusBoundarysStack.add(focusBoundary);
+        const initialFocusedElement = document.activeElement;
+        const containsActiveElement = initialFocusedElement && container.contains(initialFocusedElement);
+        /*
+         * We only autofocus on mount if container does not contain active element.
+         * If container has an element with `autoFocus` attribute, browser will
+         * have already moved focus there before this effect runs.
+         */
+        if (!containsActiveElement) {
+            const mountEvent = new CustomEvent(AUTOFOCUS_ON_MOUNT, EVENT_OPTIONS);
+            container.addEventListener(AUTOFOCUS_ON_MOUNT, onMountAutoFocus);
+            container.dispatchEvent(mountEvent);
+            /* If consumer does not manually prevent event and handle focus themselves */
+            if (!mountEvent.defaultPrevented) {
+                /**
+                 * Attempts focusing the first element in a list of candidates.
+                 * Stops when focus has actually moved.
+                 */
+                const candidates = removeLinks(getTabbableCandidates(container));
+                const previouslyFocusedElement = document.activeElement;
+                for (const candidate of candidates) {
+                    focus(candidate, { select: true });
+                    if (document.activeElement !== previouslyFocusedElement) {
+                        break;
+                    }
+                }
+                /* focusFirst might not find any candidates, so we fall back to focusing container */
+                if (document.activeElement === initialFocusedElement) {
+                    focus(container);
+                }
+            }
+        }
+        return () => {
+            container.removeEventListener(AUTOFOCUS_ON_MOUNT, onMountAutoFocus);
+            /**
+             * https://github.com/facebook/react/issues/17894
+             * We delay to next tick to avoid issues with React's event system
+             * where calling `focus` inside a effect cleanup causes React to not call onFocus handlers.
+             */
+            setTimeout(() => {
+                const unmountEvent = new CustomEvent(AUTOFOCUS_ON_UNMOUNT, EVENT_OPTIONS);
+                container.addEventListener(AUTOFOCUS_ON_UNMOUNT, onUnmountAutoFocus);
+                container.dispatchEvent(unmountEvent);
+                /* If consumer does not manually prevent event and handle focus themselves */
+                if (!unmountEvent.defaultPrevented) {
+                    /* To avoid CPU-spikes on Chrome, we make sure element is still connected to the DOM. */
+                    focus((initialFocusedElement === null || initialFocusedElement === void 0 ? void 0 : initialFocusedElement.isConnected)
+                        ? initialFocusedElement
+                        : document.body, {
+                        select: true,
+                    });
+                }
+                /* Since this is inside a cleanup, we need to instantly remove the listener ourselves */
+                container.removeEventListener(AUTOFOCUS_ON_UNMOUNT, onUnmountAutoFocus);
+                focusBoundarysStack.remove(focusBoundary);
+            }, 0);
+        };
+    }, [container, onMountAutoFocus, onUnmountAutoFocus, focusBoundary]);
+    /* Takes care of looping focus */
+    const handleKeyDown = useCallback((event) => {
+        if ((!loop && !trapped) || focusBoundary.paused) {
+            return;
+        }
+        const isTabKey = event.key === "Tab" &&
+            !event.altKey &&
+            !event.ctrlKey &&
+            !event.metaKey;
+        const focusedElement = document.activeElement;
+        if (isTabKey && focusedElement) {
+            const containerTarget = event.currentTarget;
+            const [first, last] = getTabbableEdges(containerTarget);
+            /* We can only wrap focus if we have tabbable edges */
+            if (!(first && last)) {
+                /*
+                 * No need to do anything if active element is the expected focus-target
+                 * Case: No tabbable elements, focus should stay on container. If we don't preventDefault, the container will lose focus
+                 * and potentially lose controll of focus to browser (like focusing address bar).
+                 */
+                if (focusedElement === containerTarget) {
+                    event.preventDefault();
+                }
+                return;
+            }
+            /**
+             * Since we are either trapped + looping, or one of them we will do nothing when trapped and focus first element when looping.
+             */
+            if (!event.shiftKey && focusedElement === last) {
+                event.preventDefault();
+                if (loop) {
+                    focus(first, { select: true });
+                }
+            }
+            else if (event.shiftKey && focusedElement === first) {
+                event.preventDefault();
+                if (loop) {
+                    focus(last, { select: true });
+                }
+            }
+        }
+    }, [loop, trapped, focusBoundary.paused]);
+    return (React.createElement(Slot, Object.assign({ tabIndex: -1 }, restProps, { ref: mergedRefs, onKeyDown: handleKeyDown })));
+});
+/* ---------------------------- FocusBoundary utils ---------------------------- */
+/**
+ * Returns the first and last tabbable elements inside a container as a tuple.
+ */
+function getTabbableEdges(container) {
+    const candidates = getTabbableCandidates(container);
+    return [
+        findFirstVisible(candidates, container),
+        findFirstVisible(candidates.reverse(), container),
+    ];
+}
+/**
+ * Returns a list of potential tabbable candidates.
+ * We do not take into account tabindex values.
+ *
+ * See: https://developer.mozilla.org/en-US/docs/Web/API/TreeWalker
+ * Credit: https://github.com/discord/focus-layers/blob/master/src/util/wrapFocus.tsx#L1
+ */
+function getTabbableCandidates(container) {
+    const nodes = [];
+    const walker = document.createTreeWalker(container, NodeFilter.SHOW_ELEMENT, {
+        acceptNode: (node) => {
+            const isHiddenInput = node.tagName === "INPUT" && node.type === "hidden";
+            if (node.disabled || node.hidden || isHiddenInput) {
+                return NodeFilter.FILTER_SKIP;
+            }
+            /**
+             * `.tabIndex` is not the same as the `tabindex` attribute. It works on the
+             * runtime's understanding of tabbability, so this automatically accounts
+             * for any kind of element that could be tabbed to.
+             */
+            return node.tabIndex >= 0
+                ? NodeFilter.FILTER_ACCEPT
+                : NodeFilter.FILTER_SKIP;
+        },
+    });
+    while (walker.nextNode()) {
+        nodes.push(walker.currentNode);
+    }
+    return nodes;
+}
+/**
+ * Returns the first visible element in a list.
+ * NOTE: Only checks visibility up to the `container`.
+ */
+function findFirstVisible(elements, container) {
+    for (const element of elements) {
+        if (!isHidden(element, { upTo: container })) {
+            return element;
+        }
+    }
+}
+function isHidden(node, { upTo }) {
+    if (getComputedStyle(node).visibility === "hidden") {
+        return true;
+    }
+    while (node) {
+        /* we stop at `upTo` */
+        if (upTo !== undefined && node === upTo) {
+            return false;
+        }
+        if (getComputedStyle(node).display === "none") {
+            return true;
+        }
+        node = node.parentElement;
+    }
+    return false;
+}
+function focus(element, { select = false } = {}) {
+    if (!(element === null || element === void 0 ? void 0 : element.focus)) {
+        return;
+    }
+    const previouslyFocusedElement = document.activeElement;
+    /* Prevent scrolling on focus, to minimize jarring transitions */
+    element.focus({ preventScroll: true });
+    if (!select) {
+        return;
+    }
+    /* By default, inputs that gets focus should select its contents */
+    if (element !== previouslyFocusedElement &&
+        element instanceof HTMLInputElement &&
+        "select" in element)
+        element.select();
+}
+const focusBoundarysStack = createFocusBoundarysStack();
+function createFocusBoundarysStack() {
+    /* A stack of focus-boundaries, with the active one at the top */
+    let stack = [];
+    return {
+        add(focusBoundary) {
+            /* Pause the currently active focus-boundary (at the top of the stack) */
+            const activeFocusBoundary = stack[0];
+            if (focusBoundary !== activeFocusBoundary) {
+                activeFocusBoundary === null || activeFocusBoundary === void 0 ? void 0 : activeFocusBoundary.pause();
+            }
+            /* remove in case it already exists (because we'll re-add it at the top of the stack) */
+            stack = arrayRemove(stack, focusBoundary);
+            stack.unshift(focusBoundary);
+        },
+        remove(focusBoundary) {
+            var _a;
+            stack = arrayRemove(stack, focusBoundary);
+            (_a = stack[0]) === null || _a === void 0 ? void 0 : _a.resume();
+        },
+    };
+}
+function arrayRemove(array, item) {
+    const updatedArray = [...array];
+    const index = updatedArray.indexOf(item);
+    if (index !== -1) {
+        updatedArray.splice(index, 1);
+    }
+    return updatedArray;
+}
+function removeLinks(items) {
+    return items.filter((item) => item.tagName !== "A");
+}
+export { FocusBoundary };
+//# sourceMappingURL=FocusBoundary.js.map

package/esm/util/focus-boundary/FocusBoundary.js.map

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

package/esm/util/focus-guards/FocusGuards.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+type FocusGuardsProps = {
+    children: React.ReactNode;
+    startRef?: React.RefObject<HTMLSpanElement>;
+    endRef?: React.RefObject<HTMLSpanElement>;
+};
+declare function FocusGuards({ children, startRef: forwardedStartRef, endRef: forwardedEndRef, }: FocusGuardsProps): React.JSX.Element;
+export { FocusGuards };

package/esm/util/focus-guards/FocusGuards.js

@@ -0,0 +1,31 @@
+import React from "react";
+import { useMergeRefs } from "../hooks/index.js";
+const visuallyHidden = {
+    clip: "rect(0 0 0 0)",
+    overflow: "hidden",
+    whiteSpace: "nowrap",
+    position: "fixed",
+    top: 0,
+    left: 0,
+    border: 0,
+    padding: 0,
+    width: 1,
+    height: 1,
+    margin: -1,
+};
+function FocusGuards({ children, startRef: forwardedStartRef, endRef: forwardedEndRef, }) {
+    const startRef = React.useRef(null);
+    const endRef = React.useRef(null);
+    const startRefCombined = useMergeRefs(startRef, forwardedStartRef);
+    const endRefCombined = useMergeRefs(endRef, forwardedEndRef);
+    return (React.createElement(React.Fragment, null,
+        React.createElement("span", { ref: startRefCombined, 
+            // eslint-disable-next-line jsx-a11y/no-noninteractive-tabindex
+            tabIndex: 0, style: visuallyHidden, "data-aksel-focus-guard": "" }),
+        children,
+        React.createElement("span", { ref: endRefCombined, 
+            // eslint-disable-next-line jsx-a11y/no-noninteractive-tabindex
+            tabIndex: 0, style: visuallyHidden, "data-aksel-focus-guard": "" })));
+}
+export { FocusGuards };
+//# sourceMappingURL=FocusGuards.js.map

package/esm/util/focus-guards/FocusGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusGuards.js","sourceRoot":"","sources":["../../../src/util/focus-guards/FocusGuards.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,cAAc,GAAwB;IAC1C,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,OAAO;IACjB,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC,CAAC;CACX,CAAC;AAQF,SAAS,WAAW,CAAC,EACnB,QAAQ,EACR,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,eAAe,GACN;IACjB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAyB,IAAI,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAyB,IAAI,CAAC,CAAC;IAE1D,MAAM,gBAAgB,GAAG,YAAY,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAE7D,OAAO,CACL,oBAAC,KAAK,CAAC,QAAQ;QACb,8BACE,GAAG,EAAE,gBAAgB;YACrB,+DAA+D;YAC/D,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,cAAc,4BACE,EAAE,GACzB;QACD,QAAQ;QACT,8BACE,GAAG,EAAE,cAAc;YACnB,+DAA+D;YAC/D,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,cAAc,4BACE,EAAE,GACzB,CACa,CAClB,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/esm/util/hooks/descendants/useDescendant.js

@@ -31,9 +31,12 @@ export function createDescendantContext() {
             return () => {
                 if (!ref.current)
                     return;
+                // eslint-disable-next-line react-hooks/exhaustive-deps
                 descendants.unregister(ref.current);
             };
+            // eslint-disable-next-line react-hooks/exhaustive-deps
         }, []);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
         useClientLayoutEffect(() => {
             if (!ref.current)
                 return;

package/esm/util/hooks/descendants/useDescendant.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDescendant.js","sourceRoot":"","sources":["../../../../src/util/hooks/descendants/useDescendant.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAqB,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B;;GAEG;AACH,MAAM,UAAU,uBAAuB;IAIrC,MAAM,CAAC,0BAA0B,EAAE,qBAAqB,CAAC,GAAG,aAAa,CAEvE;QACA,IAAI,EAAE,qBAAqB;QAC3B,YAAY,EACV,+DAA+D;KAClE,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,IAAI,CAC1B,CAAC,KAAK,EAAE,EAAE,CAAC,CACT,oBAAC,0BAA0B,oBAAK,KAAK,CAAC,KAAK,GACxC,KAAK,CAAC,QAAQ,CACY,CAC9B,CACF,CAAC;IAEF;;;;;;OAMG;IACH,SAAS,aAAa,CAAC,OAA8B;QACnD,MAAM,WAAW,GAAG,qBAAqB,EAAE,CAAC;QAC5C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,CAAI,IAAI,CAAC,CAAC;QAE5B,qBAAqB,CAAC,GAAG,EAAE;YACzB,OAAO,GAAG,EAAE;gBACV,IAAI,CAAC,GAAG,CAAC,OAAO;oBAAE,OAAO;gBACzB,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtC,CAAC,CAAC;QACJ,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,qBAAqB,CAAC,GAAG,EAAE;YACzB,IAAI,CAAC,GAAG,CAAC,OAAO;gBAAE,OAAO;YACzB,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBACpD,QAAQ,CAAC,SAAS,CAAC,CAAC;YACtB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,OAAO;YACzB,CAAC,CAAC,IAAI,CAAuB,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC3D,CAAC,CAAC,IAAI,CAAuB,WAAW,CAAC,QAAQ,CAAC,CAAC;QAErD,OAAO;YACL,WAAW;YACX,KAAK;YACL,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC;YACrD,QAAQ,EAAE,SAAS,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;SACxC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,SAAS,cAAc;QACrB,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,kBAAkB,EAAQ,CAAC,CAAC,OAAO,CAAC;QAEnE,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO;QACL,mBAAmB;QACnB,eAAe;QACf,+CAA+C;QAC/C,qBAAqB;QACrB,8EAA8E;QAC9E,cAAc;QACd,+BAA+B;QAC/B,aAAa;KACL,CAAC;AACb,CAAC"}
+{"version":3,"file":"useDescendant.js","sourceRoot":"","sources":["../../../../src/util/hooks/descendants/useDescendant.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAqB,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B;;GAEG;AACH,MAAM,UAAU,uBAAuB;IAIrC,MAAM,CAAC,0BAA0B,EAAE,qBAAqB,CAAC,GAAG,aAAa,CAEvE;QACA,IAAI,EAAE,qBAAqB;QAC3B,YAAY,EACV,+DAA+D;KAClE,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,IAAI,CAC1B,CAAC,KAAK,EAAE,EAAE,CAAC,CACT,oBAAC,0BAA0B,oBAAK,KAAK,CAAC,KAAK,GACxC,KAAK,CAAC,QAAQ,CACY,CAC9B,CACF,CAAC;IAEF;;;;;;OAMG;IACH,SAAS,aAAa,CAAC,OAA8B;QACnD,MAAM,WAAW,GAAG,qBAAqB,EAAE,CAAC;QAC5C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,CAAI,IAAI,CAAC,CAAC;QAE5B,qBAAqB,CAAC,GAAG,EAAE;YACzB,OAAO,GAAG,EAAE;gBACV,IAAI,CAAC,GAAG,CAAC,OAAO;oBAAE,OAAO;gBACzB,uDAAuD;gBACvD,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtC,CAAC,CAAC;YACF,uDAAuD;QACzD,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,uDAAuD;QACvD,qBAAqB,CAAC,GAAG,EAAE;YACzB,IAAI,CAAC,GAAG,CAAC,OAAO;gBAAE,OAAO;YACzB,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBACpD,QAAQ,CAAC,SAAS,CAAC,CAAC;YACtB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,OAAO;YACzB,CAAC,CAAC,IAAI,CAAuB,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC3D,CAAC,CAAC,IAAI,CAAuB,WAAW,CAAC,QAAQ,CAAC,CAAC;QAErD,OAAO;YACL,WAAW;YACX,KAAK;YACL,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC;YACrD,QAAQ,EAAE,SAAS,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;SACxC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,SAAS,cAAc;QACrB,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,kBAAkB,EAAQ,CAAC,CAAC,OAAO,CAAC;QAEnE,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO;QACL,mBAAmB;QACnB,eAAe;QACf,+CAA+C;QAC/C,qBAAqB;QACrB,8EAA8E;QAC9E,cAAc;QACd,+BAA+B;QAC/B,aAAa;KACL,CAAC;AACb,CAAC"}

package/esm/util/hooks/useEventCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEventCallback.js","sourceRoot":"","sources":["../../../src/util/hooks/useEventCallback.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,6EAA6E;AAC7E,MAAM,kBAAkB,GAAI,KAAa,CACvC,qBAAqB,IAAI,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAC7D,CAAC;AAEF,MAAM,sBAAsB;AAC1B,4CAA4C;AAC5C,kBAAkB;IAClB,8EAA8E;IAC9E,kBAAkB,KAAK,eAAe;IACpC,CAAC,CAAC,kBAAkB;IACpB,CAAC,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;AAaxB;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAuB;IAEvB,MAAM,MAAM,GAAG,cAAc,CAAC,oBAAoB,CAAC,CAAC,OAAoB,CAAC;IACzE,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;IACvB,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,UAAU,CAAC;AAC3B,CAAC;AAED,SAAS,oBAAoB;IAC3B,MAAM,MAAM,GAAqB;QAC/B,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,eAAe;QACzB,UAAU,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE,WAAC,OAAA,MAAA,MAAM,CAAC,QAAQ,uDAAG,GAAG,IAAI,CAAC,CAAA,EAAA;QAC1D,MAAM,EAAE,GAAG,EAAE;YACX,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;QAChC,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/esm/{overlays/overlay → util}/hooks/useLatestRef.js

@@ -1,9 +1,10 @@
 "use client";
-import { useClientLayoutEffect } from "../../../util/index.js";
+import { useClientLayoutEffect } from "./useClientLayoutEffect.js";
 import { useRefWithInit } from "./useRefWithInit.js";
 export function useLatestRef(value) {
     const latest = useRefWithInit(createLatestRef, value).current;
     latest.next = value;
+    // eslint-disable-next-line react-hooks/exhaustive-deps
     useClientLayoutEffect(latest.effect);
     return latest;
 }

package/esm/util/hooks/useLatestRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLatestRef.js","sourceRoot":"","sources":["../../../src/util/hooks/useLatestRef.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,UAAU,YAAY,CAAI,KAAQ;IACtC,MAAM,MAAM,GAAG,cAAc,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,OAAQ,CAAC;IAE/D,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC;IAEpB,uDAAuD;IACvD,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAI,KAAQ;IAClC,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,GAAG,EAAE;YACX,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;QAC/B,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/esm/util/hooks/useRefWithInit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRefWithInit.js","sourceRoot":"","sources":["../../../src/util/hooks/useRefWithInit.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAc,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEtC,MAAM,aAAa,GAAG,EAAE,CAAC;AAUzB,SAAS,cAAc,CAAC,IAAgC,EAAE,OAAiB;IACzE,MAAM,GAAG,GAAG,MAAM,CAAC,aAAoB,CAAC,CAAC;IAEzC,IAAI,GAAG,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;QAClC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/esm/util/hooks/useTimeout.d.ts

@@ -0,0 +1,16 @@
+declare class Timeout {
+    static create(): Timeout;
+    currentId: number;
+    /**
+     * Executes `fn` after `delay`, clearing any previously scheduled call.
+     */
+    start(delay: number, fn: () => void): void;
+    isStarted(): boolean;
+    clear: () => void;
+    disposeEffect: () => () => void;
+}
+/**
+ * A `setTimeout` with automatic cleanup and guard.
+ */
+declare function useTimeout(): Timeout;
+export { Timeout, useTimeout };

package/esm/util/hooks/useTimeout.js

@@ -0,0 +1,45 @@
+"use client";
+import { useEffect } from "react";
+import { useRefWithInit } from "./useRefWithInit.js";
+const EMPTY = 0;
+class Timeout {
+    constructor() {
+        this.currentId = EMPTY;
+        this.clear = () => {
+            if (this.currentId !== EMPTY) {
+                clearTimeout(this.currentId);
+                this.currentId = EMPTY;
+            }
+        };
+        this.disposeEffect = () => {
+            return this.clear;
+        };
+    }
+    static create() {
+        return new Timeout();
+    }
+    /**
+     * Executes `fn` after `delay`, clearing any previously scheduled call.
+     */
+    start(delay, fn) {
+        this.clear();
+        this.currentId = setTimeout(() => {
+            this.currentId = EMPTY;
+            fn();
+        }, delay); /* Node.js types are enabled in development */
+    }
+    isStarted() {
+        return this.currentId !== EMPTY;
+    }
+}
+/**
+ * A `setTimeout` with automatic cleanup and guard.
+ */
+function useTimeout() {
+    const timeout = useRefWithInit(Timeout.create).current;
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    useEffect(timeout.disposeEffect, []);
+    return timeout;
+}
+export { Timeout, useTimeout };
+//# sourceMappingURL=useTimeout.js.map

package/esm/util/hooks/useTimeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTimeout.js","sourceRoot":"","sources":["../../../src/util/hooks/useTimeout.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,KAAK,GAAG,CAAC,CAAC;AAEhB,MAAM,OAAO;IAAb;QAKE,cAAS,GAAW,KAAK,CAAC;QAiB1B,UAAK,GAAG,GAAG,EAAE;YACX,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;gBAC7B,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC7B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACzB,CAAC;QACH,CAAC,CAAC;QAEF,kBAAa,GAAG,GAAG,EAAE;YACnB,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC;IA/BC,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,OAAO,EAAE,CAAC;IACvB,CAAC;IAID;;OAEG;IACH,KAAK,CAAC,KAAa,EAAE,EAAc;QACjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC/B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,EAAE,EAAE,CAAC;QACP,CAAC,EAAE,KAAK,CAAsB,CAAC,CAAC,8CAA8C;IAChF,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC;IAClC,CAAC;CAYF;AAED;;GAEG;AACH,SAAS,UAAU;IACjB,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAQ,CAAC;IAExD,uDAAuD;IACvD,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAErC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/esm/util/link-anchor/LinkAnchor.js

@@ -16,6 +16,7 @@ import { useRenameCSS } from "../../theme/Theme.js";
 import { composeEventHandlers } from "../composeEventHandlers.js";
 import { createContext } from "../create-context.js";
 import { useMergeRefs } from "../hooks/useMergeRefs.js";
+import { ownerWindow } from "../owner.js";
 const [LinkAnchorContextProvider, useLinkAnchorContext] = createContext({
     name: "LinkAnchorOverlayContext",
 });
@@ -27,7 +28,8 @@ const LinkAnchorOverlay = forwardRef((_a, forwardedRef) => {
     return (React.createElement(LinkAnchorContextProvider, { anchorRef: anchorRef },
         React.createElement(Component, Object.assign({ ref: forwardedRef }, restProps, { className: cn("navds-link-anchor__overlay", className), onClick: composeEventHandlers(onClick, (e) => {
                 var _a;
-                if (e.target === anchorRef.current || isTextSelected()) {
+                if (e.target === anchorRef.current ||
+                    isTextSelected(anchorRef.current)) {
                     return;
                 }
                 const event = new MouseEvent("click", {
@@ -61,12 +63,9 @@ const LinkAnchorArrow = forwardRef((_a, forwardedRef) => {
     return (React.createElement(ArrowRightIcon, Object.assign({ ref: forwardedRef, "aria-hidden": true, className: cn("navds-link-anchor__arrow", className) }, restProps)));
 });
 /* -------------------------- LinkAnchor Utilities -------------------------- */
-function isTextSelected() {
-    var _a;
-    if (typeof window === "undefined") {
-        return false;
-    }
-    return !!((_a = window.getSelection()) === null || _a === void 0 ? void 0 : _a.toString());
+function isTextSelected(refElement) {
+    var _a, _b;
+    return !!((_b = (_a = ownerWindow(refElement)) === null || _a === void 0 ? void 0 : _a.getSelection()) === null || _b === void 0 ? void 0 : _b.toString());
 }
 export { LinkAnchor, LinkAnchorArrow, LinkAnchorOverlay };
 //# sourceMappingURL=LinkAnchor.js.map

package/esm/util/link-anchor/LinkAnchor.js.map

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

package/esm/util/owner.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Returns the owner document of a given element.
+ *
+ * Use this when the node might live in a different browsing context than the code
+ * invoking the utility (portals, iframes, custom documents).
+ *
+ * Examples:
+ * - Focus guards for portaled menus: pass the menu root so guards are created in the portal document.
+ * - Components rendered inside an iframe preview: scope listeners to the iframe-document.
+ * - Element opened with `window.open`: scope listeners to the new window-document.
+ *
+ * Scenarios:
+ * - Modal content rendered to parent `document.body` via a portal while running inside an iframe.
+ * - Tooltips or popovers that live outside the component't immediate DOM tree.
+ *
+ * https://github.com/radix-ui/primitives/issues/1676
+ * https://github.com/radix-ui/primitives/issues/1721
+ * https://github.com/radix-ui/primitives/discussions/1715
+ */
+declare function ownerDocument(node: Element | null): Document;
+/**
+ * Returns the owner window of a given element.
+ *
+ * Examples:
+ * - Keyboard listeners for portaled overlays.
+ * - Resize/scroll observers applied to iframe widgets.
+ */
+declare function ownerWindow(node: Document | Element | null): typeof window;
+export { ownerDocument, ownerWindow };

package/esm/util/owner.js

@@ -0,0 +1,35 @@
+/**
+ * Returns the owner document of a given element.
+ *
+ * Use this when the node might live in a different browsing context than the code
+ * invoking the utility (portals, iframes, custom documents).
+ *
+ * Examples:
+ * - Focus guards for portaled menus: pass the menu root so guards are created in the portal document.
+ * - Components rendered inside an iframe preview: scope listeners to the iframe-document.
+ * - Element opened with `window.open`: scope listeners to the new window-document.
+ *
+ * Scenarios:
+ * - Modal content rendered to parent `document.body` via a portal while running inside an iframe.
+ * - Tooltips or popovers that live outside the component't immediate DOM tree.
+ *
+ * https://github.com/radix-ui/primitives/issues/1676
+ * https://github.com/radix-ui/primitives/issues/1721
+ * https://github.com/radix-ui/primitives/discussions/1715
+ */
+function ownerDocument(node) {
+    return (node === null || node === void 0 ? void 0 : node.ownerDocument) || (globalThis === null || globalThis === void 0 ? void 0 : globalThis.document);
+}
+/**
+ * Returns the owner window of a given element.
+ *
+ * Examples:
+ * - Keyboard listeners for portaled overlays.
+ * - Resize/scroll observers applied to iframe widgets.
+ */
+function ownerWindow(node) {
+    var _a;
+    return ((_a = node === null || node === void 0 ? void 0 : node.ownerDocument) === null || _a === void 0 ? void 0 : _a.defaultView) || window;
+}
+export { ownerDocument, ownerWindow };
+//# sourceMappingURL=owner.js.map

package/esm/util/owner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner.js","sourceRoot":"","sources":["../../src/util/owner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAS,aAAa,CAAC,IAAoB;IACzC,OAAO,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,aAAa,MAAI,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,QAAQ,CAAA,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,IAA+B;;IAClD,OAAO,CAAA,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,aAAa,0CAAE,WAAW,KAAI,MAAM,CAAC;AACpD,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC"}