@primitiv-ui/react 0.1.38 → 0.1.40

package/dist/Tooltip/hooks/useTooltipContent.d.ts

@@ -0,0 +1,289 @@
+import type { TooltipContentProps } from "../types.js";
+export declare function useTooltipContent({ onEscapeKeyDown, onPointerDownOutside, onPointerEnter, onPointerLeave, ...rest }?: Omit<TooltipContentProps, "forceMount">): {
+    getContentProps: () => {
+        id: string;
+        role: "tooltip";
+        "data-state": "open" | "closed";
+        onPointerEnter: (event: import("react").PointerEvent<HTMLDivElement>) => void;
+        onPointerLeave: (event: import("react").PointerEvent<HTMLDivElement>) => void;
+        ref?: import("react").Ref<HTMLDivElement> | undefined;
+        style?: import("react").CSSProperties | undefined;
+        className?: string | undefined | undefined;
+        defaultChecked?: boolean | undefined | undefined;
+        defaultValue?: string | number | readonly string[] | undefined;
+        suppressContentEditableWarning?: boolean | undefined | undefined;
+        suppressHydrationWarning?: boolean | undefined | undefined;
+        accessKey?: string | undefined | undefined;
+        autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {}) | undefined;
+        autoFocus?: boolean | undefined | undefined;
+        contentEditable?: "inherit" | (boolean | "false" | "true") | "plaintext-only" | undefined;
+        contextMenu?: string | undefined | undefined;
+        dir?: string | undefined | undefined;
+        draggable?: (boolean | "false" | "true") | undefined;
+        enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
+        hidden?: boolean | undefined | undefined;
+        lang?: string | undefined | undefined;
+        nonce?: string | undefined | undefined;
+        slot?: string | undefined | undefined;
+        spellCheck?: (boolean | "false" | "true") | undefined;
+        tabIndex?: number | undefined | undefined;
+        title?: string | undefined | undefined;
+        translate?: "yes" | "no" | undefined | undefined;
+        radioGroup?: string | undefined | undefined;
+        about?: string | undefined | undefined;
+        content?: string | undefined | undefined;
+        datatype?: string | undefined | undefined;
+        inlist?: any;
+        prefix?: string | undefined | undefined;
+        property?: string | undefined | undefined;
+        rel?: string | undefined | undefined;
+        resource?: string | undefined | undefined;
+        rev?: string | undefined | undefined;
+        typeof?: string | undefined | undefined;
+        vocab?: string | undefined | undefined;
+        autoCorrect?: string | undefined | undefined;
+        autoSave?: string | undefined | undefined;
+        color?: string | undefined | undefined;
+        itemProp?: string | undefined | undefined;
+        itemScope?: boolean | undefined | undefined;
+        itemType?: string | undefined | undefined;
+        itemID?: string | undefined | undefined;
+        itemRef?: string | undefined | undefined;
+        results?: number | undefined | undefined;
+        security?: string | undefined | undefined;
+        unselectable?: "on" | "off" | undefined | undefined;
+        popover?: "" | "auto" | "manual" | "hint" | undefined | undefined;
+        popoverTargetAction?: "toggle" | "show" | "hide" | undefined | undefined;
+        popoverTarget?: string | undefined | undefined;
+        inert?: boolean | undefined | undefined;
+        inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined | undefined;
+        is?: string | undefined | undefined;
+        exportparts?: string | undefined | undefined;
+        part?: string | undefined | undefined;
+        "aria-activedescendant"?: string | undefined | undefined;
+        "aria-atomic"?: (boolean | "false" | "true") | undefined;
+        "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined | undefined;
+        "aria-braillelabel"?: string | undefined | undefined;
+        "aria-brailleroledescription"?: string | undefined | undefined;
+        "aria-busy"?: (boolean | "false" | "true") | undefined;
+        "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+        "aria-colcount"?: number | undefined | undefined;
+        "aria-colindex"?: number | undefined | undefined;
+        "aria-colindextext"?: string | undefined | undefined;
+        "aria-colspan"?: number | undefined | undefined;
+        "aria-controls"?: string | undefined | undefined;
+        "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
+        "aria-describedby"?: string | undefined | undefined;
+        "aria-description"?: string | undefined | undefined;
+        "aria-details"?: string | undefined | undefined;
+        "aria-disabled"?: (boolean | "false" | "true") | undefined;
+        "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined | undefined;
+        "aria-errormessage"?: string | undefined | undefined;
+        "aria-expanded"?: (boolean | "false" | "true") | undefined;
+        "aria-flowto"?: string | undefined | undefined;
+        "aria-grabbed"?: (boolean | "false" | "true") | undefined;
+        "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined | undefined;
+        "aria-hidden"?: (boolean | "false" | "true") | undefined;
+        "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined | undefined;
+        "aria-keyshortcuts"?: string | undefined | undefined;
+        "aria-label"?: string | undefined | undefined;
+        "aria-labelledby"?: string | undefined | undefined;
+        "aria-level"?: number | undefined | undefined;
+        "aria-live"?: "off" | "assertive" | "polite" | undefined | undefined;
+        "aria-modal"?: (boolean | "false" | "true") | undefined;
+        "aria-multiline"?: (boolean | "false" | "true") | undefined;
+        "aria-multiselectable"?: (boolean | "false" | "true") | undefined;
+        "aria-orientation"?: "horizontal" | "vertical" | undefined | undefined;
+        "aria-owns"?: string | undefined | undefined;
+        "aria-placeholder"?: string | undefined | undefined;
+        "aria-posinset"?: number | undefined | undefined;
+        "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+        "aria-readonly"?: (boolean | "false" | "true") | undefined;
+        "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined | undefined;
+        "aria-required"?: (boolean | "false" | "true") | undefined;
+        "aria-roledescription"?: string | undefined | undefined;
+        "aria-rowcount"?: number | undefined | undefined;
+        "aria-rowindex"?: number | undefined | undefined;
+        "aria-rowindextext"?: string | undefined | undefined;
+        "aria-rowspan"?: number | undefined | undefined;
+        "aria-selected"?: (boolean | "false" | "true") | undefined;
+        "aria-setsize"?: number | undefined | undefined;
+        "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined | undefined;
+        "aria-valuemax"?: number | undefined | undefined;
+        "aria-valuemin"?: number | undefined | undefined;
+        "aria-valuenow"?: number | undefined | undefined;
+        "aria-valuetext"?: string | undefined | undefined;
+        children?: import("react").ReactNode;
+        dangerouslySetInnerHTML?: {
+            __html: string | TrustedHTML;
+        } | undefined | undefined;
+        onCopy?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
+        onCopyCapture?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
+        onCut?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
+        onCutCapture?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
+        onPaste?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
+        onPasteCapture?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
+        onCompositionEnd?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
+        onCompositionEndCapture?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
+        onCompositionStart?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
+        onCompositionStartCapture?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
+        onCompositionUpdate?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
+        onCompositionUpdateCapture?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
+        onFocus?: import("react").FocusEventHandler<HTMLDivElement> | undefined;
+        onFocusCapture?: import("react").FocusEventHandler<HTMLDivElement> | undefined;
+        onBlur?: import("react").FocusEventHandler<HTMLDivElement> | undefined;
+        onBlurCapture?: import("react").FocusEventHandler<HTMLDivElement> | undefined;
+        onChange?: import("react").ChangeEventHandler<HTMLDivElement, Element> | undefined;
+        onChangeCapture?: import("react").ChangeEventHandler<HTMLDivElement, Element> | undefined;
+        onBeforeInput?: import("react").InputEventHandler<HTMLDivElement> | undefined;
+        onBeforeInputCapture?: import("react").InputEventHandler<HTMLDivElement> | undefined;
+        onInput?: import("react").InputEventHandler<HTMLDivElement> | undefined;
+        onInputCapture?: import("react").InputEventHandler<HTMLDivElement> | undefined;
+        onReset?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onResetCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onSubmit?: import("react").SubmitEventHandler<HTMLDivElement> | undefined;
+        onSubmitCapture?: import("react").SubmitEventHandler<HTMLDivElement> | undefined;
+        onInvalid?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onInvalidCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onLoad?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onLoadCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onError?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onErrorCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onKeyDown?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
+        onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
+        onKeyPress?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
+        onKeyPressCapture?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
+        onKeyUp?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
+        onKeyUpCapture?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
+        onAbort?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onAbortCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onCanPlay?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onCanPlayCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onCanPlayThrough?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onCanPlayThroughCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onDurationChange?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onDurationChangeCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onEmptied?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onEmptiedCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onEncrypted?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onEncryptedCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onEnded?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onEndedCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onLoadedData?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onLoadedDataCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onLoadedMetadata?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onLoadedMetadataCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onLoadStart?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onLoadStartCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onPause?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onPauseCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onPlay?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onPlayCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onPlaying?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onPlayingCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onProgress?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onProgressCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onRateChange?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onRateChangeCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onSeeked?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onSeekedCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onSeeking?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onSeekingCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onStalled?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onStalledCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onSuspend?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onSuspendCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onTimeUpdate?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onTimeUpdateCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onVolumeChange?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onVolumeChangeCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onWaiting?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onWaitingCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onAuxClick?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onAuxClickCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onClick?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onClickCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onContextMenu?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onContextMenuCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onDoubleClick?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onDoubleClickCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onDrag?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDragCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDragEnd?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDragEndCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDragEnter?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDragEnterCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDragExit?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDragExitCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDragLeave?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDragLeaveCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDragOver?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDragOverCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDragStart?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDragStartCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDrop?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onDropCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
+        onMouseDown?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onMouseDownCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onMouseEnter?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onMouseLeave?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onMouseMove?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onMouseMoveCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onMouseOut?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onMouseOutCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onMouseOver?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onMouseOverCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onMouseUp?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onMouseUpCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
+        onSelect?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onSelectCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
+        onTouchCancel?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+        onTouchCancelCapture?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+        onTouchEnd?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+        onTouchEndCapture?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+        onTouchMove?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+        onTouchMoveCapture?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+        onTouchStart?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+        onTouchStartCapture?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
+        onPointerDown?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onPointerDownCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onPointerMove?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onPointerMoveCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onPointerUp?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onPointerUpCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onPointerCancel?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onPointerCancelCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onPointerOver?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onPointerOverCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onPointerOut?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onPointerOutCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onGotPointerCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onGotPointerCaptureCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onLostPointerCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onLostPointerCaptureCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
+        onScroll?: import("react").UIEventHandler<HTMLDivElement> | undefined;
+        onScrollCapture?: import("react").UIEventHandler<HTMLDivElement> | undefined;
+        onScrollEnd?: import("react").UIEventHandler<HTMLDivElement> | undefined;
+        onScrollEndCapture?: import("react").UIEventHandler<HTMLDivElement> | undefined;
+        onWheel?: import("react").WheelEventHandler<HTMLDivElement> | undefined;
+        onWheelCapture?: import("react").WheelEventHandler<HTMLDivElement> | undefined;
+        onAnimationStart?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
+        onAnimationStartCapture?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
+        onAnimationEnd?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
+        onAnimationEndCapture?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
+        onAnimationIteration?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
+        onAnimationIterationCapture?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
+        onToggle?: import("react").ToggleEventHandler<HTMLDivElement> | undefined;
+        onBeforeToggle?: import("react").ToggleEventHandler<HTMLDivElement> | undefined;
+        onTransitionCancel?: import("react").TransitionEventHandler<HTMLDivElement> | undefined;
+        onTransitionCancelCapture?: import("react").TransitionEventHandler<HTMLDivElement> | undefined;
+        onTransitionEnd?: import("react").TransitionEventHandler<HTMLDivElement> | undefined;
+        onTransitionEndCapture?: import("react").TransitionEventHandler<HTMLDivElement> | undefined;
+        onTransitionRun?: import("react").TransitionEventHandler<HTMLDivElement> | undefined;
+        onTransitionRunCapture?: import("react").TransitionEventHandler<HTMLDivElement> | undefined;
+        onTransitionStart?: import("react").TransitionEventHandler<HTMLDivElement> | undefined;
+        onTransitionStartCapture?: import("react").TransitionEventHandler<HTMLDivElement> | undefined;
+        key?: import("react").Key | null | undefined;
+    };
+    internalRef: import("react").RefObject<HTMLDivElement | null>;
+};

package/dist/Tooltip/hooks/useTooltipContent.js

@@ -0,0 +1,50 @@
+"use client";
+import { useEffect, useRef } from "react";
+import { composeEventHandlers } from "../../Slot/index.js";
+import { useTooltipContext } from "../TooltipContext.js";
+export function useTooltipContent({ onEscapeKeyDown, onPointerDownOutside, onPointerEnter, onPointerLeave, ...rest } = {}) {
+    const { open, contentId, cancelGrace, closeImmediate } = useTooltipContext();
+    const internalRef = useRef(null);
+    useEffect(() => {
+        if (!open)
+            return;
+        const handleKeyDown = (event) => {
+            if (event.key !== "Escape")
+                return;
+            onEscapeKeyDown?.(event);
+            if (event.defaultPrevented)
+                return;
+            closeImmediate();
+        };
+        document.addEventListener("keydown", handleKeyDown);
+        return () => document.removeEventListener("keydown", handleKeyDown);
+    }, [open, onEscapeKeyDown, closeImmediate]);
+    useEffect(() => {
+        if (!open)
+            return;
+        const handlePointerDown = (event) => {
+            // Stryker disable next-line OptionalChaining: equivalent — this listener
+            // is only attached while `open` is true, and the Content `<div>` (and
+            // therefore internalRef.current) is always mounted whenever open is true.
+            if (internalRef.current?.contains(event.target))
+                return;
+            onPointerDownOutside?.(event);
+            if (event.defaultPrevented)
+                return;
+            closeImmediate();
+        };
+        document.addEventListener("pointerdown", handlePointerDown);
+        return () => document.removeEventListener("pointerdown", handlePointerDown);
+    }, [open, onPointerDownOutside, closeImmediate]);
+    function getContentProps() {
+        return {
+            ...rest,
+            id: contentId,
+            role: "tooltip",
+            "data-state": (open ? "open" : "closed"),
+            onPointerEnter: composeEventHandlers(onPointerEnter, cancelGrace),
+            onPointerLeave: composeEventHandlers(onPointerLeave, closeImmediate),
+        };
+    }
+    return { getContentProps, internalRef };
+}

package/dist/Tooltip/hooks/useTooltipProvider.d.ts

@@ -0,0 +1,9 @@
+import type { TooltipProviderContextValue } from "../types.js";
+type UseTooltipProviderArgs = {
+    delayDuration: number;
+    skipDelayDuration: number;
+};
+export declare function useTooltipProvider({ delayDuration, skipDelayDuration, }: UseTooltipProviderArgs): {
+    contextValue: TooltipProviderContextValue;
+};
+export {};

package/dist/Tooltip/hooks/useTooltipProvider.js

@@ -0,0 +1,60 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+export function useTooltipProvider({ delayDuration, skipDelayDuration, }) {
+    const [isOpenGlobally, setIsOpenGlobally] = useState(false);
+    const skipDelayTimerRef = useRef(null);
+    const onOpenGlobally = useCallback(() => {
+        // Stryker disable next-line ConditionalExpression: equivalent —
+        // clearTimeout(null) is a spec'd no-op, so forcing this guard true is
+        // harmless when no skip-delay timer is pending; the false / never-clear
+        // variant is killed by the "clears a pending skip-delay timer when a
+        // tooltip opens again within the skip window" test.
+        if (skipDelayTimerRef.current !== null) {
+            clearTimeout(skipDelayTimerRef.current);
+            skipDelayTimerRef.current = null;
+        }
+        setIsOpenGlobally(true);
+    }, 
+    // Stryker disable next-line ArrayDeclaration: equivalent — no dependency to freeze.
+    []);
+    const onCloseGlobally = useCallback(() => {
+        // Cancel before re-scheduling. The ref tracks only the newest timer, so
+        // overwriting it without cancelling orphans the previous one: it survives,
+        // fires unobserved, and can no longer be cancelled by a later open. Two
+        // closes in a row is not hypothetical — `closeImmediate` is unguarded and
+        // both Escape and blur are wired straight to it, so pressing Escape and then
+        // tabbing away leaks a timer. `clearTimeout(undefined)` is a spec'd no-op, so
+        // this needs no guard for the first close.
+        clearTimeout(skipDelayTimerRef.current ?? undefined);
+        skipDelayTimerRef.current = setTimeout(() => {
+            setIsOpenGlobally(false);
+            skipDelayTimerRef.current = null;
+        }, skipDelayDuration);
+    }, [skipDelayDuration]);
+    // The skip-delay reset is a raw `setTimeout`, so it outlives the
+    // component it was scheduled from unless explicitly cancelled — without
+    // this, an in-flight timer fires after unmount and can throw once its
+    // surrounding environment (e.g. a test's jsdom `window`) is gone.
+    useEffect(() => {
+        return () => {
+            // Stryker disable next-line ConditionalExpression: equivalent —
+            // clearTimeout(null) is a spec'd no-op, so forcing this guard true is
+            // harmless when no skip-delay timer is pending; the false / never-clear
+            // variant is killed by the "clears the pending skip-delay timeout on
+            // unmount" test.
+            if (skipDelayTimerRef.current !== null) {
+                clearTimeout(skipDelayTimerRef.current);
+            }
+        };
+    }, 
+    // Stryker disable next-line ArrayDeclaration: equivalent — no dependency to freeze (mount/unmount only).
+    []);
+    const contextValue = {
+        delayDuration,
+        skipDelayDuration,
+        isOpenGlobally,
+        onOpenGlobally,
+        onCloseGlobally,
+    };
+    return { contextValue };
+}

package/dist/Tooltip/hooks/useTooltipRoot.d.ts

@@ -0,0 +1,6 @@
+import type { TooltipContextValue, TooltipRootProps } from "../types.js";
+type UseTooltipRootArgs = Pick<TooltipRootProps, "defaultOpen" | "open" | "onOpenChange" | "delayDuration" | "disableHoverableContent">;
+export declare function useTooltipRoot({ defaultOpen, open: controlledOpen, onOpenChange, delayDuration: instanceDelayDuration, disableHoverableContent, }: UseTooltipRootArgs): {
+    contextValue: TooltipContextValue;
+};
+export {};

package/dist/Tooltip/hooks/useTooltipRoot.js

@@ -0,0 +1,100 @@
+"use client";
+import { useCallback, useId, useMemo, useRef } from "react";
+import { useControllableState } from "../../hooks/index.js";
+import { useTooltipProviderContext } from "../TooltipContext.js";
+const GRACE_PERIOD_MS = 100;
+export function useTooltipRoot({ defaultOpen = false, open: controlledOpen, onOpenChange, delayDuration: instanceDelayDuration, disableHoverableContent = false, }) {
+    const providerCtx = useTooltipProviderContext();
+    const [open, setOpen] = useControllableState(controlledOpen, defaultOpen, onOpenChange);
+    const contentId = useId();
+    const effectiveDelayDuration = instanceDelayDuration ?? providerCtx.delayDuration;
+    const openTimerRef = useRef(null);
+    const gracePeriodTimerRef = useRef(null);
+    const openImmediate = useCallback(() => {
+        // Stryker disable next-line ConditionalExpression: equivalent —
+        // clearTimeout(null) is a spec'd no-op, so forcing this guard true is
+        // harmless when no open timer is pending; the false / never-clear variant
+        // is killed by the "cancels a pending hover-delay open timer when the
+        // trigger is focused before it elapses" test.
+        if (openTimerRef.current !== null) {
+            clearTimeout(openTimerRef.current);
+            openTimerRef.current = null;
+        }
+        setOpen(true);
+        providerCtx.onOpenGlobally();
+    }, [setOpen, providerCtx]);
+    const openWithDelay = useCallback(() => {
+        const delay = providerCtx.isOpenGlobally ? 0 : effectiveDelayDuration;
+        if (delay === 0) {
+            openImmediate();
+        }
+        else {
+            openTimerRef.current = setTimeout(() => {
+                openImmediate();
+                openTimerRef.current = null;
+            }, delay);
+        }
+    }, [openImmediate, effectiveDelayDuration, providerCtx.isOpenGlobally]);
+    const closeImmediate = useCallback(() => {
+        // Stryker disable next-line ConditionalExpression: equivalent —
+        // clearTimeout(null) is a spec'd no-op, so forcing this guard true is
+        // harmless when no grace timer is pending; the false / never-clear variant
+        // is killed by the "cancels a pending grace-period timer when the tooltip
+        // closes immediately during the grace window" test.
+        if (gracePeriodTimerRef.current !== null) {
+            clearTimeout(gracePeriodTimerRef.current);
+            gracePeriodTimerRef.current = null;
+        }
+        setOpen(false);
+        providerCtx.onCloseGlobally();
+    }, [setOpen, providerCtx]);
+    const cancelGrace = useCallback(() => {
+        // Stryker disable next-line ConditionalExpression: equivalent —
+        // clearTimeout(null) is a spec'd no-op, so forcing this guard true is
+        // harmless when no grace timer is pending; the false / never-clear
+        // variant is killed by the "cancels the grace-period close timer when
+        // the pointer moves into the content" test.
+        if (gracePeriodTimerRef.current !== null) {
+            clearTimeout(gracePeriodTimerRef.current);
+            gracePeriodTimerRef.current = null;
+        }
+    }, 
+    // Stryker disable next-line ArrayDeclaration: equivalent — no dependency to freeze.
+    []);
+    const closeWithGrace = useCallback(() => {
+        // Stryker disable next-line ConditionalExpression: equivalent —
+        // clearTimeout(null) is a spec'd no-op, so forcing this guard true is
+        // harmless when no open timer is pending; the false / never-clear variant
+        // is killed by the "cancels a pending hover-delay open timer when the
+        // pointer leaves before it elapses" test.
+        if (openTimerRef.current !== null) {
+            clearTimeout(openTimerRef.current);
+            openTimerRef.current = null;
+        }
+        gracePeriodTimerRef.current = setTimeout(() => {
+            setOpen(false);
+            providerCtx.onCloseGlobally();
+            gracePeriodTimerRef.current = null;
+        }, GRACE_PERIOD_MS);
+    }, [setOpen, providerCtx]);
+    const contextValue = useMemo(() => ({
+        open,
+        contentId,
+        disableHoverableContent,
+        openWithDelay,
+        openImmediate,
+        closeImmediate,
+        closeWithGrace,
+        cancelGrace,
+    }), [
+        open,
+        contentId,
+        disableHoverableContent,
+        openWithDelay,
+        openImmediate,
+        closeImmediate,
+        closeWithGrace,
+        cancelGrace,
+    ]);
+    return { contextValue };
+}