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

package/lib-commonjs/components/Tooltip/useTooltipBase.js

@@ -0,0 +1,232 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "useTooltipBase_unstable", {
+    enumerable: true,
+    get: function() {
+        return useTooltipBase_unstable;
+    }
+});
+const _interop_require_wildcard = require("@swc/helpers/_/_interop_require_wildcard");
+const _react = /*#__PURE__*/ _interop_require_wildcard._(require("react"));
+const _reactpositioning = require("@fluentui/react-positioning");
+const _reactsharedcontexts = require("@fluentui/react-shared-contexts");
+const _reacttabster = require("@fluentui/react-tabster");
+const _reactutilities = require("@fluentui/react-utilities");
+const _constants = require("./private/constants");
+const _useTooltipTimeout = require("./private/useTooltipTimeout");
+const _keyboardkeys = require("@fluentui/keyboard-keys");
+const useTooltipBase_unstable = (props)=>{
+    'use no memo';
+    var _child_props, _child_props1, _child_props2, _child_props3, _child_props4, _child_props5, _child_props6;
+    const context = (0, _reactsharedcontexts.useTooltipVisibility_unstable)();
+    const isServerSideRender = (0, _reactutilities.useIsSSR)();
+    const { targetDocument } = (0, _reactsharedcontexts.useFluent_unstable)();
+    const [visible, setVisibleInternal] = (0, _reactutilities.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: _reactutilities.slot.always(content, {
+            defaultProps: {
+                role: 'tooltip'
+            },
+            elementType: 'div'
+        })
+    };
+    state.content.id = (0, _reactutilities.useId)('tooltip-', state.content.id);
+    const positioningOptions = {
+        enabled: state.visible,
+        arrowPadding: 2 * _constants.tooltipBorderRadius,
+        position: 'above',
+        align: 'center',
+        offset: 4,
+        ...(0, _reactpositioning.resolvePositioningShorthand)(state.positioning)
+    };
+    if (state.withArrow) {
+        positioningOptions.offset = (0, _reactpositioning.mergeArrowOffset)(positioningOptions.offset, _constants.arrowHeight);
+    }
+    const { targetRef, containerRef, arrowRef } = (0, _reactpositioning.usePositioning)(positioningOptions);
+    const [setDelayTimeout, clearDelayTimeout] = (0, _useTooltipTimeout.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 = (0, _reactutilities.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
+    (0, _reactutilities.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 === _keyboardkeys.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 = (0, _reacttabster.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(_reacttabster.KEYBORG_FOCUSIN, onKeyborgFocusIn);
+            element === null || element === void 0 ? void 0 : element.addEventListener(_reacttabster.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 = (0, _reactutilities.mergeCallbacks)(state.content.onPointerEnter, clearDelayTimeout);
+    state.content.onPointerLeave = (0, _reactutilities.mergeCallbacks)(state.content.onPointerLeave, onLeaveTrigger);
+    state.content.onFocus = (0, _reactutilities.mergeCallbacks)(state.content.onFocus, clearDelayTimeout);
+    state.content.onBlur = (0, _reactutilities.mergeCallbacks)(state.content.onBlur, onLeaveTrigger);
+    const child = (0, _reactutilities.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 = (0, _reactutilities.applyTriggerPropsToChildren)(children, {
+        ...triggerAriaProps,
+        ...child === null || child === void 0 ? void 0 : child.props,
+        ref: (0, _reactutilities.useMergedRefs)((0, _reactutilities.getReactElementRef)(child), keyborgListenerCallbackRef, positioningOptions.target === undefined ? targetRef : undefined),
+        onPointerEnter: (0, _reactutilities.useEventCallback)((0, _reactutilities.mergeCallbacks)(child === null || child === void 0 ? void 0 : (_child_props3 = child.props) === null || _child_props3 === void 0 ? void 0 : _child_props3.onPointerEnter, onEnterTrigger)),
+        onPointerLeave: (0, _reactutilities.useEventCallback)((0, _reactutilities.mergeCallbacks)(child === null || child === void 0 ? void 0 : (_child_props4 = child.props) === null || _child_props4 === void 0 ? void 0 : _child_props4.onPointerLeave, onLeaveTrigger)),
+        onFocus: (0, _reactutilities.useEventCallback)((0, _reactutilities.mergeCallbacks)(child === null || child === void 0 ? void 0 : (_child_props5 = child.props) === null || _child_props5 === void 0 ? void 0 : _child_props5.onFocus, onEnterTrigger)),
+        onBlur: (0, _reactutilities.useEventCallback)((0, _reactutilities.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-commonjs/components/Tooltip/useTooltipBase.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/Tooltip/useTooltipBase.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 { TooltipBaseProps, TooltipBaseState, 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 useTooltipBase_unstable = (props: TooltipBaseProps): TooltipBaseState => {\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    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: TooltipBaseState = {\n    withArrow,\n    positioning,\n    showDelay,\n    hideDelay,\n    relationship,\n    visible,\n    shouldRenderTooltip: visible,\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","useTooltipBase_unstable","props","child","context","isServerSideRender","targetDocument","visible","setVisibleInternal","state","initialState","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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"}

package/lib-commonjs/index.js

@@ -26,3 +26,6 @@ _export(exports, {
     }
 });
 const _Tooltip = require("./Tooltip");
+ // Experimental APIs - will be uncommented in experimental release
+ // export { useTooltipBase_unstable } from './Tooltip';
+ // export type { TooltipBaseProps, TooltipBaseState } from './Tooltip';

package/lib-commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export {\n  Tooltip,\n  renderTooltip_unstable,\n  tooltipClassNames,\n  useTooltipStyles_unstable,\n  useTooltip_unstable,\n} from './Tooltip';\nexport type {\n  OnVisibleChangeData,\n  TooltipProps,\n  TooltipSlots,\n  TooltipState,\n  TooltipChildProps as TooltipTriggerProps,\n} from './Tooltip';\n"],"names":["Tooltip","renderTooltip_unstable","tooltipClassNames","useTooltipStyles_unstable","useTooltip_unstable"],"mappings":";;;;;;;;;;;;eACEA,gBAAO;;;eACPC,+BAAsB;;;eACtBC,0BAAiB;;;eACjBC,kCAAyB;;;eACzBC,4BAAmB;;;yBACd,YAAY"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export {\n  Tooltip,\n  renderTooltip_unstable,\n  tooltipClassNames,\n  useTooltipStyles_unstable,\n  useTooltip_unstable,\n} from './Tooltip';\nexport type {\n  OnVisibleChangeData,\n  TooltipProps,\n  TooltipSlots,\n  TooltipState,\n  TooltipChildProps as TooltipTriggerProps,\n} from './Tooltip';\n\n// Experimental APIs - will be uncommented in experimental release\n// export { useTooltipBase_unstable } from './Tooltip';\n// export type { TooltipBaseProps, TooltipBaseState } from './Tooltip';\n"],"names":["Tooltip","renderTooltip_unstable","tooltipClassNames","useTooltipStyles_unstable","useTooltip_unstable"],"mappings":";;;;;;;;;;;;eACEA,gBAAO;;;eACPC,+BAAsB;;;eACtBC,0BAAiB;;;eACjBC,kCAAyB;;;eACzBC,4BAAmB;;;yBACd,YAAY;CASnB,kEAAkE;CAClE,uDAAuD;CACvD,uEAAuE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluentui/react-tooltip",
-  "version": "9.8.12",
+  "version": "9.72.9-experimental.component-base-hooks.20260122-49fc330360.0",
   "description": "React components for building web experiences",
   "main": "lib-commonjs/index.js",
   "module": "lib/index.js",
@@ -11,21 +11,15 @@
     "url": "https://github.com/microsoft/fluentui"
   },
   "license": "MIT",
-  "devDependencies": {
-    "@fluentui/react-conformance": "*",
-    "@fluentui/eslint-plugin": "*",
-    "@fluentui/react-conformance-griffel": "*",
-    "@fluentui/scripts-api-extractor": "*"
-  },
   "dependencies": {
-    "@fluentui/keyboard-keys": "^9.0.8",
-    "@fluentui/react-jsx-runtime": "^9.3.4",
-    "@fluentui/react-portal": "^9.8.9",
-    "@fluentui/react-positioning": "^9.20.11",
-    "@fluentui/react-shared-contexts": "^9.26.0",
-    "@fluentui/react-tabster": "^9.26.11",
-    "@fluentui/react-theme": "^9.2.0",
-    "@fluentui/react-utilities": "^9.26.0",
+    "@fluentui/keyboard-keys": "9.72.9-experimental.component-base-hooks.20260122-49fc330360.0",
+    "@fluentui/react-jsx-runtime": "9.72.9-experimental.component-base-hooks.20260122-49fc330360.0",
+    "@fluentui/react-portal": "9.72.9-experimental.component-base-hooks.20260122-49fc330360.0",
+    "@fluentui/react-positioning": "9.72.9-experimental.component-base-hooks.20260122-49fc330360.0",
+    "@fluentui/react-shared-contexts": "9.72.9-experimental.component-base-hooks.20260122-49fc330360.0",
+    "@fluentui/react-tabster": "9.72.9-experimental.component-base-hooks.20260122-49fc330360.0",
+    "@fluentui/react-theme": "9.72.9-experimental.component-base-hooks.20260122-49fc330360.0",
+    "@fluentui/react-utilities": "9.72.9-experimental.component-base-hooks.20260122-49fc330360.0",
     "@griffel/react": "^1.5.32",
     "@swc/helpers": "^0.5.1"
   },
@@ -35,12 +29,7 @@
     "react": ">=16.14.0 <20.0.0",
     "react-dom": ">=16.14.0 <20.0.0"
   },
-  "beachball": {
-    "disallowedChangeTypes": [
-      "major",
-      "prerelease"
-    ]
-  },
+  "beachball": {},
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",