@fluentui/react-tooltip 9.8.12 → 9.72.9-experimental.component-base-hooks.20260122-49fc330360.0

package/CHANGELOG.md

@@ -1,12 +1,29 @@
 # Change Log - @fluentui/react-tooltip
 
-This log was last generated on Wed, 17 Dec 2025 18:06:04 GMT and should not be manually modified.
+This log was last generated on Thu, 22 Jan 2026 16:12:52 GMT and should not be manually modified.
 
 <!-- Start content -->
 
+## [9.72.9-experimental.component-base-hooks.20260122-49fc330360.0](https://github.com/microsoft/fluentui/tree/@fluentui/react-tooltip_v9.72.9-experimental.component-base-hooks.20260122-49fc330360.0)
+
+Thu, 22 Jan 2026 16:12:52 GMT 
+[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-tooltip_v9.8.12..@fluentui/react-tooltip_v9.72.9-experimental.component-base-hooks.20260122-49fc330360.0)
+
+### Changes
+
+- Release 9.72.9-experimental.component-base-hooks.20260122-49fc330360 ([commit](https://github.com/microsoft/fluentui/commit/not available) by fluentui-internal@service.microsoft.com)
+- Bump @fluentui/keyboard-keys to v9.72.9-experimental.component-base-hooks.20260122-49fc330360.0 ([commit](https://github.com/microsoft/fluentui/commit/373001c3e19d022ef1fcf745ea96375cf4f3aff1) by beachball)
+- Bump @fluentui/react-jsx-runtime to v9.72.9-experimental.component-base-hooks.20260122-49fc330360.0 ([commit](https://github.com/microsoft/fluentui/commit/373001c3e19d022ef1fcf745ea96375cf4f3aff1) by beachball)
+- Bump @fluentui/react-portal to v9.72.9-experimental.component-base-hooks.20260122-49fc330360.0 ([commit](https://github.com/microsoft/fluentui/commit/373001c3e19d022ef1fcf745ea96375cf4f3aff1) by beachball)
+- Bump @fluentui/react-positioning to v9.72.9-experimental.component-base-hooks.20260122-49fc330360.0 ([commit](https://github.com/microsoft/fluentui/commit/373001c3e19d022ef1fcf745ea96375cf4f3aff1) by beachball)
+- Bump @fluentui/react-shared-contexts to v9.72.9-experimental.component-base-hooks.20260122-49fc330360.0 ([commit](https://github.com/microsoft/fluentui/commit/373001c3e19d022ef1fcf745ea96375cf4f3aff1) by beachball)
+- Bump @fluentui/react-tabster to v9.72.9-experimental.component-base-hooks.20260122-49fc330360.0 ([commit](https://github.com/microsoft/fluentui/commit/373001c3e19d022ef1fcf745ea96375cf4f3aff1) by beachball)
+- Bump @fluentui/react-theme to v9.72.9-experimental.component-base-hooks.20260122-49fc330360.0 ([commit](https://github.com/microsoft/fluentui/commit/373001c3e19d022ef1fcf745ea96375cf4f3aff1) by beachball)
+- Bump @fluentui/react-utilities to v9.72.9-experimental.component-base-hooks.20260122-49fc330360.0 ([commit](https://github.com/microsoft/fluentui/commit/373001c3e19d022ef1fcf745ea96375cf4f3aff1) by beachball)
+
 ## [9.8.12](https://github.com/microsoft/fluentui/tree/@fluentui/react-tooltip_v9.8.12)
 
-Wed, 17 Dec 2025 18:06:04 GMT 
+Wed, 17 Dec 2025 18:10:11 GMT 
 [Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-tooltip_v9.8.11..@fluentui/react-tooltip_v9.8.12)
 
 ### Patches

package/lib/Tooltip.js

@@ -1 +1 @@
-export { Tooltip, renderTooltip_unstable, tooltipClassNames, useTooltipStyles_unstable, useTooltip_unstable } from './components/Tooltip/index';
+export { Tooltip, renderTooltip_unstable, tooltipClassNames, useTooltipStyles_unstable, useTooltip_unstable, useTooltipBase_unstable } from './components/Tooltip/index';

package/lib/Tooltip.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/Tooltip.ts"],"sourcesContent":["export type {\n  OnVisibleChangeData,\n  TooltipChildProps,\n  TooltipProps,\n  TooltipSlots,\n  TooltipState,\n} from './components/Tooltip/index';\nexport {\n  Tooltip,\n  renderTooltip_unstable,\n  tooltipClassNames,\n  useTooltipStyles_unstable,\n  useTooltip_unstable,\n} from './components/Tooltip/index';\n"],"names":["Tooltip","renderTooltip_unstable","tooltipClassNames","useTooltipStyles_unstable","useTooltip_unstable"],"mappings":"AAOA,SACEA,OAAO,EACPC,sBAAsB,EACtBC,iBAAiB,EACjBC,yBAAyB,EACzBC,mBAAmB,QACd,6BAA6B"}
+{"version":3,"sources":["../src/Tooltip.ts"],"sourcesContent":["export type {\n  OnVisibleChangeData,\n  TooltipChildProps,\n  TooltipBaseProps,\n  TooltipProps,\n  TooltipSlots,\n  TooltipBaseState,\n  TooltipState,\n} from './components/Tooltip/index';\nexport {\n  Tooltip,\n  renderTooltip_unstable,\n  tooltipClassNames,\n  useTooltipStyles_unstable,\n  useTooltip_unstable,\n  useTooltipBase_unstable,\n} from './components/Tooltip/index';\n"],"names":["Tooltip","renderTooltip_unstable","tooltipClassNames","useTooltipStyles_unstable","useTooltip_unstable","useTooltipBase_unstable"],"mappings":"AASA,SACEA,OAAO,EACPC,sBAAsB,EACtBC,iBAAiB,EACjBC,yBAAyB,EACzBC,mBAAmB,EACnBC,uBAAuB,QAClB,6BAA6B"}

package/lib/components/Tooltip/Tooltip.types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/Tooltip/Tooltip.types.ts"],"sourcesContent":["import * as React from 'react';\nimport type { PositioningShorthand } from '@fluentui/react-positioning';\nimport type { ComponentProps, ComponentState, JSXElement, Slot, TriggerProps } from '@fluentui/react-utilities';\nimport type { PortalProps } from '@fluentui/react-portal';\n\n/**\n * Slot properties for Tooltip\n */\nexport type TooltipSlots = {\n  /**\n   * The text or JSX content of the tooltip.\n   */\n  content: NonNullable<Slot<'div'>>;\n};\n\n/**\n * The properties that are added to the child of the Tooltip\n */\nexport type TooltipChildProps = {\n  ref?: React.Ref<unknown>;\n} & Pick<\n  React.HTMLAttributes<HTMLElement>,\n  | 'aria-describedby'\n  | 'aria-label'\n  | 'aria-labelledby'\n  | 'onBlur'\n  | 'onFocus'\n  | 'onPointerEnter'\n  | 'onPointerLeave'\n  | 'aria-haspopup'\n  | 'aria-expanded'\n>;\n\n/**\n * Data for the Tooltip's onVisibleChange event.\n */\nexport type OnVisibleChangeData = {\n  visible: boolean;\n\n  /**\n   * The event object, if this visibility change was triggered by a keyboard event on the document element\n   * (such as Escape to hide the visible tooltip). Otherwise undefined.\n   */\n  documentKeyboardEvent?: KeyboardEvent;\n};\n\n/**\n * Properties for Tooltip\n */\nexport type TooltipProps = ComponentProps<TooltipSlots> &\n  TriggerProps<TooltipChildProps> &\n  Pick<PortalProps, 'mountNode'> & {\n    /**\n     * The tooltip's visual appearance.\n     * * `normal` - Uses the theme's background and text colors.\n     * * `inverted` - Higher contrast variant that uses the theme's inverted colors.\n     *\n     * @default normal\n     */\n    appearance?: 'normal' | 'inverted';\n    /**\n     * Delay before the tooltip is hidden, in milliseconds.\n     *\n     * @default 250\n     */\n    hideDelay?: number;\n\n    /**\n     * Notification when the visibility of the tooltip is changing.\n     *\n     * **Note**: for backwards compatibility, `event` will be undefined if this was triggered by a keyboard event on\n     * the document element. Use `data.documentKeyboardEvent` if the keyboard event object is needed.\n     */\n    // eslint-disable-next-line @nx/workspace-consistent-callback-type -- can't change type of existing callback\n    onVisibleChange?: (\n      event: React.PointerEvent<HTMLElement> | React.FocusEvent<HTMLElement> | undefined,\n      data: OnVisibleChangeData,\n    ) => void;\n\n    /**\n     * Configure the positioning of the tooltip\n     *\n     * @default above\n     */\n    positioning?: PositioningShorthand;\n\n    /**\n     * (Required) Specifies whether this tooltip is acting as the description or label of its trigger element.\n     *\n     * * `label` - The tooltip sets the trigger's aria-label or aria-labelledby attribute. This is useful for buttons\n     *    displaying only an icon, for example.\n     * * `description` - The tooltip sets the trigger's aria-description or aria-describedby attribute.\n     * * `inaccessible` - No aria attributes are set on the trigger. This makes the tooltip's content inaccessible to\n     *   screen readers, and should only be used if the tooltip's text is available by some other means.\n     */\n    relationship: 'label' | 'description' | 'inaccessible';\n\n    /**\n     * Delay before the tooltip is shown, in milliseconds.\n     *\n     * @default 250\n     */\n    showDelay?: number;\n\n    /**\n     * Control the tooltip's visibility programatically.\n     *\n     * This can be used in conjunction with onVisibleChange to modify the tooltip's show and hide behavior.\n     *\n     * If not provided, the visibility will be controlled by the tooltip itself, based on hover and focus events on the\n     * trigger (child) element.\n     *\n     * @default false\n     */\n    visible?: boolean;\n\n    /**\n     * Render an arrow pointing to the target element\n     *\n     * @default false\n     */\n    withArrow?: boolean;\n  };\n\n/**\n * State used in rendering Tooltip\n */\nexport type TooltipState = ComponentState<TooltipSlots> &\n  Pick<TooltipProps, 'mountNode' | 'relationship'> &\n  Required<Pick<TooltipProps, 'appearance' | 'hideDelay' | 'positioning' | 'showDelay' | 'visible' | 'withArrow'>> & {\n    children?: JSXElement | null;\n\n    /**\n     * Whether the tooltip should be rendered to the DOM.\n     */\n    shouldRenderTooltip?: boolean;\n\n    /**\n     * Ref to the arrow element\n     */\n    arrowRef?: React.Ref<HTMLDivElement>;\n\n    /**\n     * CSS class for the arrow element\n     */\n    arrowClassName?: string;\n  };\n"],"names":["React"],"mappings":"AAAA,YAAYA,WAAW,QAAQ"}
+{"version":3,"sources":["../src/components/Tooltip/Tooltip.types.ts"],"sourcesContent":["import * as React from 'react';\nimport type { PositioningShorthand } from '@fluentui/react-positioning';\nimport type { ComponentProps, ComponentState, JSXElement, Slot, TriggerProps } from '@fluentui/react-utilities';\nimport type { PortalProps } from '@fluentui/react-portal';\n\n/**\n * Slot properties for Tooltip\n */\nexport type TooltipSlots = {\n  /**\n   * The text or JSX content of the tooltip.\n   */\n  content: NonNullable<Slot<'div'>>;\n};\n\n/**\n * The properties that are added to the child of the Tooltip\n */\nexport type TooltipChildProps = {\n  ref?: React.Ref<unknown>;\n} & Pick<\n  React.HTMLAttributes<HTMLElement>,\n  | 'aria-describedby'\n  | 'aria-label'\n  | 'aria-labelledby'\n  | 'onBlur'\n  | 'onFocus'\n  | 'onPointerEnter'\n  | 'onPointerLeave'\n  | 'aria-haspopup'\n  | 'aria-expanded'\n>;\n\n/**\n * Data for the Tooltip's onVisibleChange event.\n */\nexport type OnVisibleChangeData = {\n  visible: boolean;\n\n  /**\n   * The event object, if this visibility change was triggered by a keyboard event on the document element\n   * (such as Escape to hide the visible tooltip). Otherwise undefined.\n   */\n  documentKeyboardEvent?: KeyboardEvent;\n};\n\n/**\n * Properties for Tooltip\n */\nexport type TooltipProps = ComponentProps<TooltipSlots> &\n  TriggerProps<TooltipChildProps> &\n  Pick<PortalProps, 'mountNode'> & {\n    /**\n     * The tooltip's visual appearance.\n     * * `normal` - Uses the theme's background and text colors.\n     * * `inverted` - Higher contrast variant that uses the theme's inverted colors.\n     *\n     * @default normal\n     */\n    appearance?: 'normal' | 'inverted';\n    /**\n     * Delay before the tooltip is hidden, in milliseconds.\n     *\n     * @default 250\n     */\n    hideDelay?: number;\n\n    /**\n     * Notification when the visibility of the tooltip is changing.\n     *\n     * **Note**: for backwards compatibility, `event` will be undefined if this was triggered by a keyboard event on\n     * the document element. Use `data.documentKeyboardEvent` if the keyboard event object is needed.\n     */\n    // eslint-disable-next-line @nx/workspace-consistent-callback-type -- can't change type of existing callback\n    onVisibleChange?: (\n      event: React.PointerEvent<HTMLElement> | React.FocusEvent<HTMLElement> | undefined,\n      data: OnVisibleChangeData,\n    ) => void;\n\n    /**\n     * Configure the positioning of the tooltip\n     *\n     * @default above\n     */\n    positioning?: PositioningShorthand;\n\n    /**\n     * (Required) Specifies whether this tooltip is acting as the description or label of its trigger element.\n     *\n     * * `label` - The tooltip sets the trigger's aria-label or aria-labelledby attribute. This is useful for buttons\n     *    displaying only an icon, for example.\n     * * `description` - The tooltip sets the trigger's aria-description or aria-describedby attribute.\n     * * `inaccessible` - No aria attributes are set on the trigger. This makes the tooltip's content inaccessible to\n     *   screen readers, and should only be used if the tooltip's text is available by some other means.\n     */\n    relationship: 'label' | 'description' | 'inaccessible';\n\n    /**\n     * Delay before the tooltip is shown, in milliseconds.\n     *\n     * @default 250\n     */\n    showDelay?: number;\n\n    /**\n     * Control the tooltip's visibility programatically.\n     *\n     * This can be used in conjunction with onVisibleChange to modify the tooltip's show and hide behavior.\n     *\n     * If not provided, the visibility will be controlled by the tooltip itself, based on hover and focus events on the\n     * trigger (child) element.\n     *\n     * @default false\n     */\n    visible?: boolean;\n\n    /**\n     * Render an arrow pointing to the target element\n     *\n     * @default false\n     */\n    withArrow?: boolean;\n  };\n\nexport type TooltipBaseProps = Omit<TooltipProps, 'appearance'>;\n\n/**\n * State used in rendering Tooltip\n */\nexport type TooltipState = ComponentState<TooltipSlots> &\n  Pick<TooltipProps, 'mountNode' | 'relationship'> &\n  Required<Pick<TooltipProps, 'appearance' | 'hideDelay' | 'positioning' | 'showDelay' | 'visible' | 'withArrow'>> & {\n    children?: JSXElement | null;\n\n    /**\n     * Whether the tooltip should be rendered to the DOM.\n     */\n    shouldRenderTooltip?: boolean;\n\n    /**\n     * Ref to the arrow element\n     */\n    arrowRef?: React.Ref<HTMLDivElement>;\n\n    /**\n     * CSS class for the arrow element\n     */\n    arrowClassName?: string;\n  };\n\nexport type TooltipBaseState = Omit<TooltipState, 'appearance'>;\n"],"names":["React"],"mappings":"AAAA,YAAYA,WAAW,QAAQ"}

package/lib/components/Tooltip/index.js

@@ -1,4 +1,5 @@
 export { Tooltip } from './Tooltip';
 export { renderTooltip_unstable } from './renderTooltip';
 export { useTooltip_unstable } from './useTooltip';
+export { useTooltipBase_unstable } from './useTooltipBase';
 export { tooltipClassNames, useTooltipStyles_unstable } from './useTooltipStyles.styles';

package/lib/components/Tooltip/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/Tooltip/index.ts"],"sourcesContent":["export { Tooltip } from './Tooltip';\nexport type { OnVisibleChangeData, TooltipChildProps, TooltipProps, TooltipSlots, TooltipState } from './Tooltip.types';\nexport { renderTooltip_unstable } from './renderTooltip';\nexport { useTooltip_unstable } from './useTooltip';\nexport { tooltipClassNames, useTooltipStyles_unstable } from './useTooltipStyles.styles';\n"],"names":["Tooltip","renderTooltip_unstable","useTooltip_unstable","tooltipClassNames","useTooltipStyles_unstable"],"mappings":"AAAA,SAASA,OAAO,QAAQ,YAAY;AAEpC,SAASC,sBAAsB,QAAQ,kBAAkB;AACzD,SAASC,mBAAmB,QAAQ,eAAe;AACnD,SAASC,iBAAiB,EAAEC,yBAAyB,QAAQ,4BAA4B"}
+{"version":3,"sources":["../src/components/Tooltip/index.ts"],"sourcesContent":["export { Tooltip } from './Tooltip';\nexport type {\n  OnVisibleChangeData,\n  TooltipChildProps,\n  TooltipBaseProps,\n  TooltipProps,\n  TooltipSlots,\n  TooltipBaseState,\n  TooltipState,\n} from './Tooltip.types';\nexport { renderTooltip_unstable } from './renderTooltip';\nexport { useTooltip_unstable } from './useTooltip';\nexport { useTooltipBase_unstable } from './useTooltipBase';\nexport { tooltipClassNames, useTooltipStyles_unstable } from './useTooltipStyles.styles';\n"],"names":["Tooltip","renderTooltip_unstable","useTooltip_unstable","useTooltipBase_unstable","tooltipClassNames","useTooltipStyles_unstable"],"mappings":"AAAA,SAASA,OAAO,QAAQ,YAAY;AAUpC,SAASC,sBAAsB,QAAQ,kBAAkB;AACzD,SAASC,mBAAmB,QAAQ,eAAe;AACnD,SAASC,uBAAuB,QAAQ,mBAAmB;AAC3D,SAASC,iBAAiB,EAAEC,yBAAyB,QAAQ,4BAA4B"}

package/lib/components/Tooltip/useTooltip.js

@@ -1,12 +1,5 @@
 'use client';
-import * as React from 'react';
-import { mergeArrowOffset, resolvePositioningShorthand, usePositioning } from '@fluentui/react-positioning';
-import { useTooltipVisibility_unstable as useTooltipVisibility, useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';
-import { KEYBORG_FOCUSIN, useIsNavigatingWithKeyboard } from '@fluentui/react-tabster';
-import { applyTriggerPropsToChildren, useControllableState, useId, useIsomorphicLayoutEffect, useIsSSR, useMergedRefs, getTriggerChild, mergeCallbacks, useEventCallback, slot, getReactElementRef } from '@fluentui/react-utilities';
-import { arrowHeight, tooltipBorderRadius } from './private/constants';
-import { useTooltipTimeout } from './private/useTooltipTimeout';
-import { Escape } from '@fluentui/keyboard-keys';
+import { useTooltipBase_unstable } from './useTooltipBase';
 /**
  * Create the state required to render Tooltip.
  *
@@ -16,215 +9,10 @@ import { Escape } from '@fluentui/keyboard-keys';
  * @param props - props from this instance of Tooltip
  */ export const useTooltip_unstable = (props)=>{
     'use no memo';
-    var _child_props, _child_props1, _child_props2, _child_props3, _child_props4, _child_props5, _child_props6;
-    const context = useTooltipVisibility();
-    const isServerSideRender = useIsSSR();
-    const { targetDocument } = useFluent();
-    const [visible, setVisibleInternal] = useControllableState({
-        state: props.visible,
-        initialState: false
-    });
-    const { appearance = 'normal', children, content, withArrow = false, positioning = 'above', onVisibleChange, relationship, showDelay = 250, hideDelay = 250, mountNode } = props;
-    const state = {
-        withArrow,
-        positioning,
-        showDelay,
-        hideDelay,
-        relationship,
-        visible,
-        shouldRenderTooltip: visible,
+    const { appearance = 'normal' } = props;
+    const state = useTooltipBase_unstable(props);
+    return {
         appearance,
-        mountNode,
-        // Slots
-        components: {
-            content: 'div'
-        },
-        content: slot.always(content, {
-            defaultProps: {
-                role: 'tooltip'
-            },
-            elementType: 'div'
-        })
+        ...state
     };
-    state.content.id = useId('tooltip-', state.content.id);
-    const positioningOptions = {
-        enabled: state.visible,
-        arrowPadding: 2 * tooltipBorderRadius,
-        position: 'above',
-        align: 'center',
-        offset: 4,
-        ...resolvePositioningShorthand(state.positioning)
-    };
-    if (state.withArrow) {
-        positioningOptions.offset = mergeArrowOffset(positioningOptions.offset, arrowHeight);
-    }
-    const { targetRef, containerRef, arrowRef } = usePositioning(positioningOptions);
-    const [setDelayTimeout, clearDelayTimeout] = useTooltipTimeout(containerRef);
-    const setVisible = React.useCallback((ev, data)=>{
-        clearDelayTimeout();
-        setVisibleInternal((oldVisible)=>{
-            if (data.visible !== oldVisible) {
-                onVisibleChange === null || onVisibleChange === void 0 ? void 0 : onVisibleChange(ev, data);
-            }
-            return data.visible;
-        });
-    }, [
-        clearDelayTimeout,
-        setVisibleInternal,
-        onVisibleChange
-    ]);
-    state.content.ref = useMergedRefs(state.content.ref, containerRef);
-    state.arrowRef = arrowRef;
-    // When this tooltip is visible, hide any other tooltips, and register it
-    // as the visibleTooltip with the TooltipContext.
-    // Also add a listener on document to hide the tooltip if Escape is pressed
-    useIsomorphicLayoutEffect(()=>{
-        if (visible) {
-            var _context_visibleTooltip;
-            const thisTooltip = {
-                hide: (ev)=>setVisible(undefined, {
-                        visible: false,
-                        documentKeyboardEvent: ev
-                    })
-            };
-            (_context_visibleTooltip = context.visibleTooltip) === null || _context_visibleTooltip === void 0 ? void 0 : _context_visibleTooltip.hide();
-            context.visibleTooltip = thisTooltip;
-            const onDocumentKeyDown = (ev)=>{
-                if (ev.key === Escape && !ev.defaultPrevented) {
-                    thisTooltip.hide(ev);
-                    // stop propagation to avoid conflicting with other elements that listen for `Escape`
-                    // e,g: Dialog, Popover, Menu and Tooltip
-                    ev.preventDefault();
-                }
-            };
-            targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.addEventListener('keydown', onDocumentKeyDown, {
-                // As this event is added at targeted document,
-                // we need to capture the event to be sure keydown handling from tooltip happens first
-                capture: true
-            });
-            return ()=>{
-                if (context.visibleTooltip === thisTooltip) {
-                    context.visibleTooltip = undefined;
-                }
-                targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.removeEventListener('keydown', onDocumentKeyDown, {
-                    capture: true
-                });
-            };
-        }
-    }, [
-        context,
-        targetDocument,
-        visible,
-        setVisible
-    ]);
-    // Used to skip showing the tooltip  in certain situations when the trigger is focused.
-    // See comments where this is set for more info.
-    const ignoreNextFocusEventRef = React.useRef(false);
-    // Listener for onPointerEnter and onFocus on the trigger element
-    const onEnterTrigger = React.useCallback((ev)=>{
-        if (ev.type === 'focus' && ignoreNextFocusEventRef.current) {
-            ignoreNextFocusEventRef.current = false;
-            return;
-        }
-        // Show immediately if another tooltip is already visible
-        const delay = context.visibleTooltip ? 0 : state.showDelay;
-        setDelayTimeout(()=>{
-            setVisible(ev, {
-                visible: true
-            });
-        }, delay);
-        ev.persist(); // Persist the event since the setVisible call will happen asynchronously
-    }, [
-        setDelayTimeout,
-        setVisible,
-        state.showDelay,
-        context
-    ]);
-    const isNavigatingWithKeyboard = useIsNavigatingWithKeyboard();
-    // Callback ref that attaches a keyborg:focusin event listener.
-    const [keyborgListenerCallbackRef] = React.useState(()=>{
-        const onKeyborgFocusIn = (ev)=>{
-            var _ev_detail;
-            // Skip showing the tooltip if focus moved programmatically.
-            // For example, we don't want to show the tooltip when a dialog is closed
-            // and Tabster programmatically restores focus to the trigger button.
-            // See https://github.com/microsoft/fluentui/issues/27576
-            if (((_ev_detail = ev.detail) === null || _ev_detail === void 0 ? void 0 : _ev_detail.isFocusedProgrammatically) && !isNavigatingWithKeyboard()) {
-                ignoreNextFocusEventRef.current = true;
-            }
-        };
-        // Save the current element to remove the listener when the ref changes
-        let current = null;
-        // Callback ref that attaches the listener to the element
-        return (element)=>{
-            current === null || current === void 0 ? void 0 : current.removeEventListener(KEYBORG_FOCUSIN, onKeyborgFocusIn);
-            element === null || element === void 0 ? void 0 : element.addEventListener(KEYBORG_FOCUSIN, onKeyborgFocusIn);
-            current = element;
-        };
-    });
-    // Listener for onPointerLeave and onBlur on the trigger element
-    const onLeaveTrigger = React.useCallback((ev)=>{
-        let delay = state.hideDelay;
-        if (ev.type === 'blur') {
-            // Hide immediately when losing focus
-            delay = 0;
-            // The focused element gets a blur event when the document loses focus
-            // (e.g. switching tabs in the browser), but we don't want to show the
-            // tooltip again when the document gets focus back. Handle this case by
-            // checking if the blurred element is still the document's activeElement.
-            // See https://github.com/microsoft/fluentui/issues/13541
-            ignoreNextFocusEventRef.current = (targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.activeElement) === ev.target;
-        }
-        setDelayTimeout(()=>{
-            setVisible(ev, {
-                visible: false
-            });
-        }, delay);
-        ev.persist(); // Persist the event since the setVisible call will happen asynchronously
-    }, [
-        setDelayTimeout,
-        setVisible,
-        state.hideDelay,
-        targetDocument
-    ]);
-    // Cancel the hide timer when the mouse or focus enters the tooltip, and restart it when the mouse or focus leaves.
-    // This keeps the tooltip visible when the mouse is moved over it, or it has focus within.
-    state.content.onPointerEnter = mergeCallbacks(state.content.onPointerEnter, clearDelayTimeout);
-    state.content.onPointerLeave = mergeCallbacks(state.content.onPointerLeave, onLeaveTrigger);
-    state.content.onFocus = mergeCallbacks(state.content.onFocus, clearDelayTimeout);
-    state.content.onBlur = mergeCallbacks(state.content.onBlur, onLeaveTrigger);
-    const child = getTriggerChild(children);
-    const triggerAriaProps = {};
-    const isPopupExpanded = (child === null || child === void 0 ? void 0 : (_child_props = child.props) === null || _child_props === void 0 ? void 0 : _child_props['aria-haspopup']) && ((child === null || child === void 0 ? void 0 : (_child_props1 = child.props) === null || _child_props1 === void 0 ? void 0 : _child_props1['aria-expanded']) === true || (child === null || child === void 0 ? void 0 : (_child_props2 = child.props) === null || _child_props2 === void 0 ? void 0 : _child_props2['aria-expanded']) === 'true');
-    if (relationship === 'label') {
-        // aria-label only works if the content is a string. Otherwise, need to use aria-labelledby.
-        if (typeof state.content.children === 'string') {
-            triggerAriaProps['aria-label'] = state.content.children;
-        } else {
-            triggerAriaProps['aria-labelledby'] = state.content.id;
-            // Always render the tooltip even if hidden, so that aria-labelledby refers to a valid element
-            state.shouldRenderTooltip = true;
-        }
-    } else if (relationship === 'description') {
-        triggerAriaProps['aria-describedby'] = state.content.id;
-        // Always render the tooltip even if hidden, so that aria-describedby refers to a valid element
-        state.shouldRenderTooltip = true;
-    }
-    // Case 1: Don't render the Tooltip in SSR to avoid hydration errors
-    // Case 2: Don't render the Tooltip, if it triggers Menu or another popup and it's already opened
-    if (isServerSideRender || isPopupExpanded) {
-        state.shouldRenderTooltip = false;
-    }
-    // Apply the trigger props to the child, either by calling the render function, or cloning with the new props
-    state.children = applyTriggerPropsToChildren(children, {
-        ...triggerAriaProps,
-        ...child === null || child === void 0 ? void 0 : child.props,
-        ref: useMergedRefs(getReactElementRef(child), keyborgListenerCallbackRef, // If the target prop is not provided, attach targetRef to the trigger element's ref prop
-        positioningOptions.target === undefined ? targetRef : undefined),
-        onPointerEnter: useEventCallback(mergeCallbacks(child === null || child === void 0 ? void 0 : (_child_props3 = child.props) === null || _child_props3 === void 0 ? void 0 : _child_props3.onPointerEnter, onEnterTrigger)),
-        onPointerLeave: useEventCallback(mergeCallbacks(child === null || child === void 0 ? void 0 : (_child_props4 = child.props) === null || _child_props4 === void 0 ? void 0 : _child_props4.onPointerLeave, onLeaveTrigger)),
-        onFocus: useEventCallback(mergeCallbacks(child === null || child === void 0 ? void 0 : (_child_props5 = child.props) === null || _child_props5 === void 0 ? void 0 : _child_props5.onFocus, onEnterTrigger)),
-        onBlur: useEventCallback(mergeCallbacks(child === null || child === void 0 ? void 0 : (_child_props6 = child.props) === null || _child_props6 === void 0 ? void 0 : _child_props6.onBlur, onLeaveTrigger))
-    });
-    return state;
 };

package/lib/components/Tooltip/useTooltip.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/Tooltip/useTooltip.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { mergeArrowOffset, resolvePositioningShorthand, usePositioning } from '@fluentui/react-positioning';\nimport {\n  useTooltipVisibility_unstable as useTooltipVisibility,\n  useFluent_unstable as useFluent,\n} from '@fluentui/react-shared-contexts';\nimport type { KeyborgFocusInEvent } from '@fluentui/react-tabster';\nimport { KEYBORG_FOCUSIN, useIsNavigatingWithKeyboard } from '@fluentui/react-tabster';\nimport {\n  applyTriggerPropsToChildren,\n  useControllableState,\n  useId,\n  useIsomorphicLayoutEffect,\n  useIsSSR,\n  useMergedRefs,\n  getTriggerChild,\n  mergeCallbacks,\n  useEventCallback,\n  slot,\n  getReactElementRef,\n} from '@fluentui/react-utilities';\nimport type { TooltipProps, TooltipState, TooltipChildProps, OnVisibleChangeData } from './Tooltip.types';\nimport { arrowHeight, tooltipBorderRadius } from './private/constants';\nimport { useTooltipTimeout } from './private/useTooltipTimeout';\nimport { Escape } from '@fluentui/keyboard-keys';\n\n/**\n * Create the state required to render Tooltip.\n *\n * The returned state can be modified with hooks such as useTooltipStyles_unstable,\n * before being passed to renderTooltip_unstable.\n *\n * @param props - props from this instance of Tooltip\n */\nexport const useTooltip_unstable = (props: TooltipProps): TooltipState => {\n  'use no memo';\n\n  const context = useTooltipVisibility();\n  const isServerSideRender = useIsSSR();\n  const { targetDocument } = useFluent();\n\n  const [visible, setVisibleInternal] = useControllableState({ state: props.visible, initialState: false });\n\n  const {\n    appearance = 'normal',\n    children,\n    content,\n    withArrow = false,\n    positioning = 'above',\n    onVisibleChange,\n    relationship,\n    showDelay = 250,\n    hideDelay = 250,\n    mountNode,\n  } = props;\n\n  const state: TooltipState = {\n    withArrow,\n    positioning,\n    showDelay,\n    hideDelay,\n    relationship,\n    visible,\n    shouldRenderTooltip: visible,\n    appearance,\n    mountNode,\n    // Slots\n    components: {\n      content: 'div',\n    },\n    content: slot.always(content, {\n      defaultProps: {\n        role: 'tooltip',\n      },\n      elementType: 'div',\n    }),\n  };\n\n  state.content.id = useId('tooltip-', state.content.id);\n\n  const positioningOptions = {\n    enabled: state.visible,\n    arrowPadding: 2 * tooltipBorderRadius,\n    position: 'above' as const,\n    align: 'center' as const,\n    offset: 4,\n    ...resolvePositioningShorthand(state.positioning),\n  };\n\n  if (state.withArrow) {\n    positioningOptions.offset = mergeArrowOffset(positioningOptions.offset, arrowHeight);\n  }\n\n  const {\n    targetRef,\n    containerRef,\n    arrowRef,\n  }: {\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    targetRef: React.MutableRefObject<unknown>;\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    containerRef: React.MutableRefObject<HTMLDivElement>;\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    arrowRef: React.MutableRefObject<HTMLDivElement>;\n  } = usePositioning(positioningOptions);\n\n  const [setDelayTimeout, clearDelayTimeout] = useTooltipTimeout(containerRef);\n\n  const setVisible = React.useCallback(\n    (ev: React.PointerEvent<HTMLElement> | React.FocusEvent<HTMLElement> | undefined, data: OnVisibleChangeData) => {\n      clearDelayTimeout();\n      setVisibleInternal(oldVisible => {\n        if (data.visible !== oldVisible) {\n          onVisibleChange?.(ev, data);\n        }\n        return data.visible;\n      });\n    },\n    [clearDelayTimeout, setVisibleInternal, onVisibleChange],\n  );\n\n  state.content.ref = useMergedRefs(state.content.ref, containerRef);\n  state.arrowRef = arrowRef;\n\n  // When this tooltip is visible, hide any other tooltips, and register it\n  // as the visibleTooltip with the TooltipContext.\n  // Also add a listener on document to hide the tooltip if Escape is pressed\n  useIsomorphicLayoutEffect(() => {\n    if (visible) {\n      const thisTooltip = {\n        hide: (ev?: KeyboardEvent) => setVisible(undefined, { visible: false, documentKeyboardEvent: ev }),\n      };\n\n      context.visibleTooltip?.hide();\n      context.visibleTooltip = thisTooltip;\n\n      const onDocumentKeyDown = (ev: KeyboardEvent) => {\n        if (ev.key === Escape && !ev.defaultPrevented) {\n          thisTooltip.hide(ev);\n          // stop propagation to avoid conflicting with other elements that listen for `Escape`\n          // e,g: Dialog, Popover, Menu and Tooltip\n          ev.preventDefault();\n        }\n      };\n\n      targetDocument?.addEventListener('keydown', onDocumentKeyDown, {\n        // As this event is added at targeted document,\n        // we need to capture the event to be sure keydown handling from tooltip happens first\n        capture: true,\n      });\n\n      return () => {\n        if (context.visibleTooltip === thisTooltip) {\n          context.visibleTooltip = undefined;\n        }\n\n        targetDocument?.removeEventListener('keydown', onDocumentKeyDown, { capture: true });\n      };\n    }\n  }, [context, targetDocument, visible, setVisible]);\n\n  // Used to skip showing the tooltip  in certain situations when the trigger is focused.\n  // See comments where this is set for more info.\n  const ignoreNextFocusEventRef = React.useRef(false);\n\n  // Listener for onPointerEnter and onFocus on the trigger element\n  const onEnterTrigger = React.useCallback(\n    (ev: React.PointerEvent<HTMLElement> | React.FocusEvent<HTMLElement>) => {\n      if (ev.type === 'focus' && ignoreNextFocusEventRef.current) {\n        ignoreNextFocusEventRef.current = false;\n        return;\n      }\n\n      // Show immediately if another tooltip is already visible\n      const delay = context.visibleTooltip ? 0 : state.showDelay;\n\n      setDelayTimeout(() => {\n        setVisible(ev, { visible: true });\n      }, delay);\n\n      ev.persist(); // Persist the event since the setVisible call will happen asynchronously\n    },\n    [setDelayTimeout, setVisible, state.showDelay, context],\n  );\n\n  const isNavigatingWithKeyboard = useIsNavigatingWithKeyboard();\n\n  // Callback ref that attaches a keyborg:focusin event listener.\n  const [keyborgListenerCallbackRef] = React.useState(() => {\n    const onKeyborgFocusIn = ((ev: KeyborgFocusInEvent) => {\n      // Skip showing the tooltip if focus moved programmatically.\n      // For example, we don't want to show the tooltip when a dialog is closed\n      // and Tabster programmatically restores focus to the trigger button.\n      // See https://github.com/microsoft/fluentui/issues/27576\n      if (ev.detail?.isFocusedProgrammatically && !isNavigatingWithKeyboard()) {\n        ignoreNextFocusEventRef.current = true;\n      }\n    }) as EventListener;\n\n    // Save the current element to remove the listener when the ref changes\n    let current: Element | null = null;\n\n    // Callback ref that attaches the listener to the element\n    return (element: Element | null) => {\n      current?.removeEventListener(KEYBORG_FOCUSIN, onKeyborgFocusIn);\n      element?.addEventListener(KEYBORG_FOCUSIN, onKeyborgFocusIn);\n      current = element;\n    };\n  });\n\n  // Listener for onPointerLeave and onBlur on the trigger element\n  const onLeaveTrigger = React.useCallback(\n    (ev: React.PointerEvent<HTMLElement> | React.FocusEvent<HTMLElement>) => {\n      let delay = state.hideDelay;\n\n      if (ev.type === 'blur') {\n        // Hide immediately when losing focus\n        delay = 0;\n\n        // The focused element gets a blur event when the document loses focus\n        // (e.g. switching tabs in the browser), but we don't want to show the\n        // tooltip again when the document gets focus back. Handle this case by\n        // checking if the blurred element is still the document's activeElement.\n        // See https://github.com/microsoft/fluentui/issues/13541\n        ignoreNextFocusEventRef.current = targetDocument?.activeElement === ev.target;\n      }\n\n      setDelayTimeout(() => {\n        setVisible(ev, { visible: false });\n      }, delay);\n\n      ev.persist(); // Persist the event since the setVisible call will happen asynchronously\n    },\n    [setDelayTimeout, setVisible, state.hideDelay, targetDocument],\n  );\n\n  // Cancel the hide timer when the mouse or focus enters the tooltip, and restart it when the mouse or focus leaves.\n  // This keeps the tooltip visible when the mouse is moved over it, or it has focus within.\n  state.content.onPointerEnter = mergeCallbacks(state.content.onPointerEnter, clearDelayTimeout);\n  state.content.onPointerLeave = mergeCallbacks(state.content.onPointerLeave, onLeaveTrigger);\n  state.content.onFocus = mergeCallbacks(state.content.onFocus, clearDelayTimeout);\n  state.content.onBlur = mergeCallbacks(state.content.onBlur, onLeaveTrigger);\n\n  const child = getTriggerChild(children);\n\n  const triggerAriaProps: Pick<TooltipChildProps, 'aria-label' | 'aria-labelledby' | 'aria-describedby'> = {};\n  const isPopupExpanded =\n    child?.props?.['aria-haspopup'] &&\n    (child?.props?.['aria-expanded'] === true || child?.props?.['aria-expanded'] === 'true');\n\n  if (relationship === 'label') {\n    // aria-label only works if the content is a string. Otherwise, need to use aria-labelledby.\n    if (typeof state.content.children === 'string') {\n      triggerAriaProps['aria-label'] = state.content.children;\n    } else {\n      triggerAriaProps['aria-labelledby'] = state.content.id;\n      // Always render the tooltip even if hidden, so that aria-labelledby refers to a valid element\n      state.shouldRenderTooltip = true;\n    }\n  } else if (relationship === 'description') {\n    triggerAriaProps['aria-describedby'] = state.content.id;\n    // Always render the tooltip even if hidden, so that aria-describedby refers to a valid element\n    state.shouldRenderTooltip = true;\n  }\n\n  // Case 1: Don't render the Tooltip in SSR to avoid hydration errors\n  // Case 2: Don't render the Tooltip, if it triggers Menu or another popup and it's already opened\n  if (isServerSideRender || isPopupExpanded) {\n    state.shouldRenderTooltip = false;\n  }\n\n  // Apply the trigger props to the child, either by calling the render function, or cloning with the new props\n  state.children = applyTriggerPropsToChildren(children, {\n    ...triggerAriaProps,\n    ...child?.props,\n    ref: useMergedRefs(\n      getReactElementRef<HTMLButtonElement>(child),\n      keyborgListenerCallbackRef,\n      // If the target prop is not provided, attach targetRef to the trigger element's ref prop\n      positioningOptions.target === undefined ? targetRef : undefined,\n    ),\n    onPointerEnter: useEventCallback(mergeCallbacks(child?.props?.onPointerEnter, onEnterTrigger)),\n    onPointerLeave: useEventCallback(mergeCallbacks(child?.props?.onPointerLeave, onLeaveTrigger)),\n    onFocus: useEventCallback(mergeCallbacks(child?.props?.onFocus, onEnterTrigger)),\n    onBlur: useEventCallback(mergeCallbacks(child?.props?.onBlur, onLeaveTrigger)),\n  });\n\n  return state;\n};\n"],"names":["React","mergeArrowOffset","resolvePositioningShorthand","usePositioning","useTooltipVisibility_unstable","useTooltipVisibility","useFluent_unstable","useFluent","KEYBORG_FOCUSIN","useIsNavigatingWithKeyboard","applyTriggerPropsToChildren","useControllableState","useId","useIsomorphicLayoutEffect","useIsSSR","useMergedRefs","getTriggerChild","mergeCallbacks","useEventCallback","slot","getReactElementRef","arrowHeight","tooltipBorderRadius","useTooltipTimeout","Escape","useTooltip_unstable","props","child","context","isServerSideRender","targetDocument","visible","setVisibleInternal","state","initialState","appearance","children","content","withArrow","positioning","onVisibleChange","relationship","showDelay","hideDelay","mountNode","shouldRenderTooltip","components","always","defaultProps","role","elementType","id","positioningOptions","enabled","arrowPadding","position","align","offset","targetRef","containerRef","arrowRef","setDelayTimeout","clearDelayTimeout","setVisible","useCallback","ev","data","oldVisible","ref","thisTooltip","hide","undefined","documentKeyboardEvent","visibleTooltip","onDocumentKeyDown","key","defaultPrevented","preventDefault","addEventListener","capture","removeEventListener","ignoreNextFocusEventRef","useRef","onEnterTrigger","type","current","delay","persist","isNavigatingWithKeyboard","keyborgListenerCallbackRef","useState","onKeyborgFocusIn","detail","isFocusedProgrammatically","element","onLeaveTrigger","activeElement","target","onPointerEnter","onPointerLeave","onFocus","onBlur","triggerAriaProps","isPopupExpanded"],"mappings":"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"}
+{"version":3,"sources":["../src/components/Tooltip/useTooltip.tsx"],"sourcesContent":["'use client';\n\nimport type { TooltipProps, TooltipState } from './Tooltip.types';\nimport { useTooltipBase_unstable } from './useTooltipBase';\n\n/**\n * Create the state required to render Tooltip.\n *\n * The returned state can be modified with hooks such as useTooltipStyles_unstable,\n * before being passed to renderTooltip_unstable.\n *\n * @param props - props from this instance of Tooltip\n */\nexport const useTooltip_unstable = (props: TooltipProps): TooltipState => {\n  'use no memo';\n\n  const { appearance = 'normal' } = props;\n\n  const state = useTooltipBase_unstable(props);\n\n  return {\n    appearance,\n    ...state,\n  };\n};\n"],"names":["useTooltipBase_unstable","useTooltip_unstable","props","appearance","state"],"mappings":"AAAA;AAGA,SAASA,uBAAuB,QAAQ,mBAAmB;AAE3D;;;;;;;CAOC,GACD,OAAO,MAAMC,sBAAsB,CAACC;IAClC;IAEA,MAAM,EAAEC,aAAa,QAAQ,EAAE,GAAGD;IAElC,MAAME,QAAQJ,wBAAwBE;IAEtC,OAAO;QACLC;QACA,GAAGC,KAAK;IACV;AACF,EAAE"}

package/lib/components/Tooltip/useTooltipBase.js

@@ -0,0 +1,229 @@
+'use client';
+import * as React from 'react';
+import { mergeArrowOffset, resolvePositioningShorthand, usePositioning } from '@fluentui/react-positioning';
+import { useTooltipVisibility_unstable as useTooltipVisibility, useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';
+import { KEYBORG_FOCUSIN, useIsNavigatingWithKeyboard } from '@fluentui/react-tabster';
+import { applyTriggerPropsToChildren, useControllableState, useId, useIsomorphicLayoutEffect, useIsSSR, useMergedRefs, getTriggerChild, mergeCallbacks, useEventCallback, slot, getReactElementRef } from '@fluentui/react-utilities';
+import { arrowHeight, tooltipBorderRadius } from './private/constants';
+import { useTooltipTimeout } from './private/useTooltipTimeout';
+import { Escape } from '@fluentui/keyboard-keys';
+/**
+ * Create the state required to render Tooltip.
+ *
+ * The returned state can be modified with hooks such as useTooltipStyles_unstable,
+ * before being passed to renderTooltip_unstable.
+ *
+ * @param props - props from this instance of Tooltip
+ */ export const useTooltipBase_unstable = (props)=>{
+    'use no memo';
+    var _child_props, _child_props1, _child_props2, _child_props3, _child_props4, _child_props5, _child_props6;
+    const context = useTooltipVisibility();
+    const isServerSideRender = useIsSSR();
+    const { targetDocument } = useFluent();
+    const [visible, setVisibleInternal] = useControllableState({
+        state: props.visible,
+        initialState: false
+    });
+    const { children, content, withArrow = false, positioning = 'above', onVisibleChange, relationship, showDelay = 250, hideDelay = 250, mountNode } = props;
+    const state = {
+        withArrow,
+        positioning,
+        showDelay,
+        hideDelay,
+        relationship,
+        visible,
+        shouldRenderTooltip: visible,
+        mountNode,
+        // Slots
+        components: {
+            content: 'div'
+        },
+        content: slot.always(content, {
+            defaultProps: {
+                role: 'tooltip'
+            },
+            elementType: 'div'
+        })
+    };
+    state.content.id = useId('tooltip-', state.content.id);
+    const positioningOptions = {
+        enabled: state.visible,
+        arrowPadding: 2 * tooltipBorderRadius,
+        position: 'above',
+        align: 'center',
+        offset: 4,
+        ...resolvePositioningShorthand(state.positioning)
+    };
+    if (state.withArrow) {
+        positioningOptions.offset = mergeArrowOffset(positioningOptions.offset, arrowHeight);
+    }
+    const { targetRef, containerRef, arrowRef } = usePositioning(positioningOptions);
+    const [setDelayTimeout, clearDelayTimeout] = useTooltipTimeout(containerRef);
+    const setVisible = React.useCallback((ev, data)=>{
+        clearDelayTimeout();
+        setVisibleInternal((oldVisible)=>{
+            if (data.visible !== oldVisible) {
+                onVisibleChange === null || onVisibleChange === void 0 ? void 0 : onVisibleChange(ev, data);
+            }
+            return data.visible;
+        });
+    }, [
+        clearDelayTimeout,
+        setVisibleInternal,
+        onVisibleChange
+    ]);
+    state.content.ref = useMergedRefs(state.content.ref, containerRef);
+    state.arrowRef = arrowRef;
+    // When this tooltip is visible, hide any other tooltips, and register it
+    // as the visibleTooltip with the TooltipContext.
+    // Also add a listener on document to hide the tooltip if Escape is pressed
+    useIsomorphicLayoutEffect(()=>{
+        if (visible) {
+            var _context_visibleTooltip;
+            const thisTooltip = {
+                hide: (ev)=>setVisible(undefined, {
+                        visible: false,
+                        documentKeyboardEvent: ev
+                    })
+            };
+            (_context_visibleTooltip = context.visibleTooltip) === null || _context_visibleTooltip === void 0 ? void 0 : _context_visibleTooltip.hide();
+            context.visibleTooltip = thisTooltip;
+            const onDocumentKeyDown = (ev)=>{
+                if (ev.key === Escape && !ev.defaultPrevented) {
+                    thisTooltip.hide(ev);
+                    // stop propagation to avoid conflicting with other elements that listen for `Escape`
+                    // e,g: Dialog, Popover, Menu and Tooltip
+                    ev.preventDefault();
+                }
+            };
+            targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.addEventListener('keydown', onDocumentKeyDown, {
+                // As this event is added at targeted document,
+                // we need to capture the event to be sure keydown handling from tooltip happens first
+                capture: true
+            });
+            return ()=>{
+                if (context.visibleTooltip === thisTooltip) {
+                    context.visibleTooltip = undefined;
+                }
+                targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.removeEventListener('keydown', onDocumentKeyDown, {
+                    capture: true
+                });
+            };
+        }
+    }, [
+        context,
+        targetDocument,
+        visible,
+        setVisible
+    ]);
+    // Used to skip showing the tooltip  in certain situations when the trigger is focused.
+    // See comments where this is set for more info.
+    const ignoreNextFocusEventRef = React.useRef(false);
+    // Listener for onPointerEnter and onFocus on the trigger element
+    const onEnterTrigger = React.useCallback((ev)=>{
+        if (ev.type === 'focus' && ignoreNextFocusEventRef.current) {
+            ignoreNextFocusEventRef.current = false;
+            return;
+        }
+        // Show immediately if another tooltip is already visible
+        const delay = context.visibleTooltip ? 0 : state.showDelay;
+        setDelayTimeout(()=>{
+            setVisible(ev, {
+                visible: true
+            });
+        }, delay);
+        ev.persist(); // Persist the event since the setVisible call will happen asynchronously
+    }, [
+        setDelayTimeout,
+        setVisible,
+        state.showDelay,
+        context
+    ]);
+    const isNavigatingWithKeyboard = useIsNavigatingWithKeyboard();
+    // Callback ref that attaches a keyborg:focusin event listener.
+    const [keyborgListenerCallbackRef] = React.useState(()=>{
+        const onKeyborgFocusIn = (ev)=>{
+            var _ev_detail;
+            // Skip showing the tooltip if focus moved programmatically.
+            // For example, we don't want to show the tooltip when a dialog is closed
+            // and Tabster programmatically restores focus to the trigger button.
+            // See https://github.com/microsoft/fluentui/issues/27576
+            if (((_ev_detail = ev.detail) === null || _ev_detail === void 0 ? void 0 : _ev_detail.isFocusedProgrammatically) && !isNavigatingWithKeyboard()) {
+                ignoreNextFocusEventRef.current = true;
+            }
+        };
+        // Save the current element to remove the listener when the ref changes
+        let current = null;
+        // Callback ref that attaches the listener to the element
+        return (element)=>{
+            current === null || current === void 0 ? void 0 : current.removeEventListener(KEYBORG_FOCUSIN, onKeyborgFocusIn);
+            element === null || element === void 0 ? void 0 : element.addEventListener(KEYBORG_FOCUSIN, onKeyborgFocusIn);
+            current = element;
+        };
+    });
+    // Listener for onPointerLeave and onBlur on the trigger element
+    const onLeaveTrigger = React.useCallback((ev)=>{
+        let delay = state.hideDelay;
+        if (ev.type === 'blur') {
+            // Hide immediately when losing focus
+            delay = 0;
+            // The focused element gets a blur event when the document loses focus
+            // (e.g. switching tabs in the browser), but we don't want to show the
+            // tooltip again when the document gets focus back. Handle this case by
+            // checking if the blurred element is still the document's activeElement.
+            // See https://github.com/microsoft/fluentui/issues/13541
+            ignoreNextFocusEventRef.current = (targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.activeElement) === ev.target;
+        }
+        setDelayTimeout(()=>{
+            setVisible(ev, {
+                visible: false
+            });
+        }, delay);
+        ev.persist(); // Persist the event since the setVisible call will happen asynchronously
+    }, [
+        setDelayTimeout,
+        setVisible,
+        state.hideDelay,
+        targetDocument
+    ]);
+    // Cancel the hide timer when the mouse or focus enters the tooltip, and restart it when the mouse or focus leaves.
+    // This keeps the tooltip visible when the mouse is moved over it, or it has focus within.
+    state.content.onPointerEnter = mergeCallbacks(state.content.onPointerEnter, clearDelayTimeout);
+    state.content.onPointerLeave = mergeCallbacks(state.content.onPointerLeave, onLeaveTrigger);
+    state.content.onFocus = mergeCallbacks(state.content.onFocus, clearDelayTimeout);
+    state.content.onBlur = mergeCallbacks(state.content.onBlur, onLeaveTrigger);
+    const child = getTriggerChild(children);
+    const triggerAriaProps = {};
+    const isPopupExpanded = (child === null || child === void 0 ? void 0 : (_child_props = child.props) === null || _child_props === void 0 ? void 0 : _child_props['aria-haspopup']) && ((child === null || child === void 0 ? void 0 : (_child_props1 = child.props) === null || _child_props1 === void 0 ? void 0 : _child_props1['aria-expanded']) === true || (child === null || child === void 0 ? void 0 : (_child_props2 = child.props) === null || _child_props2 === void 0 ? void 0 : _child_props2['aria-expanded']) === 'true');
+    if (relationship === 'label') {
+        // aria-label only works if the content is a string. Otherwise, need to use aria-labelledby.
+        if (typeof state.content.children === 'string') {
+            triggerAriaProps['aria-label'] = state.content.children;
+        } else {
+            triggerAriaProps['aria-labelledby'] = state.content.id;
+            // Always render the tooltip even if hidden, so that aria-labelledby refers to a valid element
+            state.shouldRenderTooltip = true;
+        }
+    } else if (relationship === 'description') {
+        triggerAriaProps['aria-describedby'] = state.content.id;
+        // Always render the tooltip even if hidden, so that aria-describedby refers to a valid element
+        state.shouldRenderTooltip = true;
+    }
+    // Case 1: Don't render the Tooltip in SSR to avoid hydration errors
+    // Case 2: Don't render the Tooltip, if it triggers Menu or another popup and it's already opened
+    if (isServerSideRender || isPopupExpanded) {
+        state.shouldRenderTooltip = false;
+    }
+    // Apply the trigger props to the child, either by calling the render function, or cloning with the new props
+    state.children = applyTriggerPropsToChildren(children, {
+        ...triggerAriaProps,
+        ...child === null || child === void 0 ? void 0 : child.props,
+        ref: useMergedRefs(getReactElementRef(child), keyborgListenerCallbackRef, // If the target prop is not provided, attach targetRef to the trigger element's ref prop
+        positioningOptions.target === undefined ? targetRef : undefined),
+        onPointerEnter: useEventCallback(mergeCallbacks(child === null || child === void 0 ? void 0 : (_child_props3 = child.props) === null || _child_props3 === void 0 ? void 0 : _child_props3.onPointerEnter, onEnterTrigger)),
+        onPointerLeave: useEventCallback(mergeCallbacks(child === null || child === void 0 ? void 0 : (_child_props4 = child.props) === null || _child_props4 === void 0 ? void 0 : _child_props4.onPointerLeave, onLeaveTrigger)),
+        onFocus: useEventCallback(mergeCallbacks(child === null || child === void 0 ? void 0 : (_child_props5 = child.props) === null || _child_props5 === void 0 ? void 0 : _child_props5.onFocus, onEnterTrigger)),
+        onBlur: useEventCallback(mergeCallbacks(child === null || child === void 0 ? void 0 : (_child_props6 = child.props) === null || _child_props6 === void 0 ? void 0 : _child_props6.onBlur, onLeaveTrigger))
+    });
+    return state;
+};