@fluentui/react-utilities 9.21.0 → 9.22.0

package/CHANGELOG.md

@@ -1,12 +1,30 @@
 # Change Log - @fluentui/react-utilities
 
-This log was last generated on Thu, 12 Jun 2025 09:39:13 GMT and should not be manually modified.
+This log was last generated on Thu, 26 Jun 2025 14:07:53 GMT and should not be manually modified.
 
 <!-- Start content -->
 
+## [9.22.0](https://github.com/microsoft/fluentui/tree/@fluentui/react-utilities_v9.22.0)
+
+Thu, 26 Jun 2025 14:07:53 GMT 
+[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-utilities_v9.21.1..@fluentui/react-utilities_v9.22.0)
+
+### Minor changes
+
+- Shorten pollDuration to 100ms in useIFrameFocus ([PR #34703](https://github.com/microsoft/fluentui/pull/34703) by xboy2008@live.cn)
+
+## [9.21.1](https://github.com/microsoft/fluentui/tree/@fluentui/react-utilities_v9.21.1)
+
+Wed, 18 Jun 2025 17:34:00 GMT 
+[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-utilities_v9.21.0..@fluentui/react-utilities_v9.21.1)
+
+### Patches
+
+- Bump @fluentui/react-shared-contexts to v9.24.0 ([PR #34675](https://github.com/microsoft/fluentui/pull/34675) by beachball)
+
 ## [9.21.0](https://github.com/microsoft/fluentui/tree/@fluentui/react-utilities_v9.21.0)
 
-Thu, 12 Jun 2025 09:39:13 GMT 
+Thu, 12 Jun 2025 09:43:33 GMT 
 [Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-utilities_v9.20.0..@fluentui/react-utilities_v9.21.0)
 
 ### Minor changes

package/lib/hooks/useOnClickOutside.js

@@ -100,7 +100,7 @@ const FUI_FRAME_EVENT = 'fuiframefocus';
  * Polls the value of `document.activeElement`. If it is an iframe, then dispatch
  * a custom DOM event. When the custom event is received call the provided callback
  */ const useIFrameFocus = (options)=>{
-    const { disabled, element: targetDocument, callback, contains = DEFAULT_CONTAINS, pollDuration = 1000, refs } = options;
+    const { disabled, element: targetDocument, callback, contains = DEFAULT_CONTAINS, pollDuration = 100, refs } = options;
     const timeoutRef = React.useRef();
     const listener = useEventCallback((e)=>{
         const isOutside = refs.every((ref)=>!contains(ref.current || null, e.target));

package/lib/hooks/useOnClickOutside.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hooks/useOnClickOutside.ts"],"sourcesContent":["import * as React from 'react';\nimport { useEventCallback } from './useEventCallback';\nimport { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';\n\n/**\n * @internal\n */\nexport type UseOnClickOrScrollOutsideOptions = {\n  /**\n   * The element to listen for the click event\n   */\n  element: Document | undefined;\n  /**\n   * Refs to elements that check if the click is outside\n   */\n  refs: React.MutableRefObject<HTMLElement | undefined | null>[];\n\n  /**\n   * By default uses element.contains, but custom contain function can be provided\n   *\n   * @param parent - provided parent element\n   * @param child - event target element\n   */\n  contains?(parent: HTMLElement | null, child: HTMLElement): boolean;\n\n  /**\n   * Disables event listeners\n   */\n  disabled?: boolean;\n\n  /**\n   * Disables custom focus event listeners for iframes\n   */\n  disabledFocusOnIframe?: boolean;\n\n  /**\n   * Called if the click is outside the element refs\n   */\n  callback: (ev: MouseEvent | TouchEvent) => void;\n};\n\nconst DEFAULT_CONTAINS: UseOnClickOrScrollOutsideOptions['contains'] = (parent, child) => !!parent?.contains(child);\n\n/**\n * @internal\n * Utility to perform checks where a click/touch event was made outside a component\n */\nexport const useOnClickOutside = (options: UseOnClickOrScrollOutsideOptions) => {\n  const { targetDocument } = useFluent();\n  const win = targetDocument?.defaultView;\n  const { refs, callback, element, disabled, disabledFocusOnIframe, contains = DEFAULT_CONTAINS } = options;\n  const timeoutId = React.useRef<number | undefined>(undefined);\n\n  useIFrameFocus({ element, disabled: disabledFocusOnIframe || disabled, callback, refs, contains });\n\n  const isMouseDownInsideRef = React.useRef(false);\n  const listener = useEventCallback((ev: MouseEvent | TouchEvent) => {\n    if (isMouseDownInsideRef.current) {\n      isMouseDownInsideRef.current = false;\n      return;\n    }\n\n    const target = ev.composedPath()[0] as HTMLElement;\n    const isOutside = refs.every(ref => !contains(ref.current || null, target));\n\n    if (isOutside && !disabled) {\n      callback(ev);\n    }\n  });\n\n  const handleMouseDown = useEventCallback((ev: MouseEvent) => {\n    // Selecting text from inside to outside will rigger click event.\n    // In this case click event target is outside but mouse down event target is inside.\n    // And this click event should be considered as inside click.\n    isMouseDownInsideRef.current = refs.some(ref => contains(ref.current || null, ev.target as HTMLElement));\n  });\n\n  React.useEffect(() => {\n    if (disabled) {\n      return;\n    }\n\n    // Store the current event to avoid triggering handlers immediately\n    // Note this depends on a deprecated but extremely well supported quirk of the web platform\n    // https://github.com/facebook/react/issues/20074\n    let currentEvent = getWindowEvent(win);\n\n    const conditionalHandler = (event: MouseEvent | TouchEvent) => {\n      // Skip if this event is the same as the one running when we added the handlers\n      if (event === currentEvent) {\n        currentEvent = undefined;\n        return;\n      }\n\n      listener(event);\n    };\n\n    // use capture phase because React can update DOM before the event bubbles to the document\n    element?.addEventListener('click', conditionalHandler, true);\n    element?.addEventListener('touchstart', conditionalHandler, true);\n    element?.addEventListener('contextmenu', conditionalHandler, true);\n    element?.addEventListener('mousedown', handleMouseDown, true);\n\n    // Garbage collect this event after it's no longer useful to avoid memory leaks\n    timeoutId.current = win?.setTimeout(() => {\n      currentEvent = undefined;\n    }, 1);\n\n    return () => {\n      element?.removeEventListener('click', conditionalHandler, true);\n      element?.removeEventListener('touchstart', conditionalHandler, true);\n      element?.removeEventListener('contextmenu', conditionalHandler, true);\n      element?.removeEventListener('mousedown', handleMouseDown, true);\n\n      win?.clearTimeout(timeoutId.current);\n      currentEvent = undefined;\n    };\n  }, [listener, element, disabled, handleMouseDown, win]);\n};\n\nconst getWindowEvent = (target: Node | Window | null | undefined): Event | undefined => {\n  if (target) {\n    if (typeof (target as Window).window === 'object' && (target as Window).window === target) {\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\n      return target.event;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    return (target as Node).ownerDocument?.defaultView?.event ?? undefined;\n  }\n\n  return undefined;\n};\n\nconst FUI_FRAME_EVENT = 'fuiframefocus';\n\ninterface UseIFrameFocusOptions\n  extends Pick<UseOnClickOrScrollOutsideOptions, 'disabled' | 'element' | 'callback' | 'contains' | 'refs'> {\n  /**\n   * Millisecond duration to poll\n   */\n  pollDuration?: number;\n}\n\n/**\n * Since click events do not propagate past iframes, we use focus to detect if a\n * click has happened inside an iframe, since the only ways of focusing inside an\n * iframe are:\n *   - clicking inside\n *   - tabbing inside\n *\n * Polls the value of `document.activeElement`. If it is an iframe, then dispatch\n * a custom DOM event. When the custom event is received call the provided callback\n */\nconst useIFrameFocus = (options: UseIFrameFocusOptions) => {\n  const {\n    disabled,\n    element: targetDocument,\n    callback,\n    contains = DEFAULT_CONTAINS,\n    pollDuration = 1000,\n    refs,\n  } = options;\n  const timeoutRef = React.useRef<number>();\n\n  const listener = useEventCallback((e: Event) => {\n    const isOutside = refs.every(ref => !contains(ref.current || null, e.target as HTMLElement));\n\n    if (isOutside && !disabled) {\n      callback(e as MouseEvent);\n    }\n  });\n\n  // Adds listener to the custom iframe focus event\n  React.useEffect(() => {\n    if (disabled) {\n      return;\n    }\n\n    targetDocument?.addEventListener(FUI_FRAME_EVENT, listener, true);\n\n    return () => {\n      targetDocument?.removeEventListener(FUI_FRAME_EVENT, listener, true);\n    };\n  }, [targetDocument, disabled, listener]);\n\n  // Starts polling for the active element\n  React.useEffect(() => {\n    if (disabled) {\n      return;\n    }\n\n    timeoutRef.current = targetDocument?.defaultView?.setInterval(() => {\n      const activeElement = targetDocument?.activeElement;\n\n      if (activeElement?.tagName === 'IFRAME' || activeElement?.tagName === 'WEBVIEW') {\n        const event = new CustomEvent(FUI_FRAME_EVENT, { bubbles: true });\n        activeElement.dispatchEvent(event);\n      }\n    }, pollDuration);\n\n    return () => {\n      targetDocument?.defaultView?.clearTimeout(timeoutRef.current);\n    };\n  }, [targetDocument, disabled, pollDuration]);\n};\n"],"names":["React","useEventCallback","useFluent_unstable","useFluent","DEFAULT_CONTAINS","parent","child","contains","useOnClickOutside","options","targetDocument","win","defaultView","refs","callback","element","disabled","disabledFocusOnIframe","timeoutId","useRef","undefined","useIFrameFocus","isMouseDownInsideRef","listener","ev","current","target","composedPath","isOutside","every","ref","handleMouseDown","some","useEffect","currentEvent","getWindowEvent","conditionalHandler","event","addEventListener","setTimeout","removeEventListener","clearTimeout","window","ownerDocument","FUI_FRAME_EVENT","pollDuration","timeoutRef","e","setInterval","activeElement","tagName","CustomEvent","bubbles","dispatchEvent"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"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"}
+{"version":3,"sources":["../src/hooks/useOnClickOutside.ts"],"sourcesContent":["import * as React from 'react';\nimport { useEventCallback } from './useEventCallback';\nimport { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';\n\n/**\n * @internal\n */\nexport type UseOnClickOrScrollOutsideOptions = {\n  /**\n   * The element to listen for the click event\n   */\n  element: Document | undefined;\n  /**\n   * Refs to elements that check if the click is outside\n   */\n  refs: React.MutableRefObject<HTMLElement | undefined | null>[];\n\n  /**\n   * By default uses element.contains, but custom contain function can be provided\n   *\n   * @param parent - provided parent element\n   * @param child - event target element\n   */\n  contains?(parent: HTMLElement | null, child: HTMLElement): boolean;\n\n  /**\n   * Disables event listeners\n   */\n  disabled?: boolean;\n\n  /**\n   * Disables custom focus event listeners for iframes\n   */\n  disabledFocusOnIframe?: boolean;\n\n  /**\n   * Called if the click is outside the element refs\n   */\n  callback: (ev: MouseEvent | TouchEvent) => void;\n};\n\nconst DEFAULT_CONTAINS: UseOnClickOrScrollOutsideOptions['contains'] = (parent, child) => !!parent?.contains(child);\n\n/**\n * @internal\n * Utility to perform checks where a click/touch event was made outside a component\n */\nexport const useOnClickOutside = (options: UseOnClickOrScrollOutsideOptions) => {\n  const { targetDocument } = useFluent();\n  const win = targetDocument?.defaultView;\n  const { refs, callback, element, disabled, disabledFocusOnIframe, contains = DEFAULT_CONTAINS } = options;\n  const timeoutId = React.useRef<number | undefined>(undefined);\n\n  useIFrameFocus({ element, disabled: disabledFocusOnIframe || disabled, callback, refs, contains });\n\n  const isMouseDownInsideRef = React.useRef(false);\n  const listener = useEventCallback((ev: MouseEvent | TouchEvent) => {\n    if (isMouseDownInsideRef.current) {\n      isMouseDownInsideRef.current = false;\n      return;\n    }\n\n    const target = ev.composedPath()[0] as HTMLElement;\n    const isOutside = refs.every(ref => !contains(ref.current || null, target));\n\n    if (isOutside && !disabled) {\n      callback(ev);\n    }\n  });\n\n  const handleMouseDown = useEventCallback((ev: MouseEvent) => {\n    // Selecting text from inside to outside will rigger click event.\n    // In this case click event target is outside but mouse down event target is inside.\n    // And this click event should be considered as inside click.\n    isMouseDownInsideRef.current = refs.some(ref => contains(ref.current || null, ev.target as HTMLElement));\n  });\n\n  React.useEffect(() => {\n    if (disabled) {\n      return;\n    }\n\n    // Store the current event to avoid triggering handlers immediately\n    // Note this depends on a deprecated but extremely well supported quirk of the web platform\n    // https://github.com/facebook/react/issues/20074\n    let currentEvent = getWindowEvent(win);\n\n    const conditionalHandler = (event: MouseEvent | TouchEvent) => {\n      // Skip if this event is the same as the one running when we added the handlers\n      if (event === currentEvent) {\n        currentEvent = undefined;\n        return;\n      }\n\n      listener(event);\n    };\n\n    // use capture phase because React can update DOM before the event bubbles to the document\n    element?.addEventListener('click', conditionalHandler, true);\n    element?.addEventListener('touchstart', conditionalHandler, true);\n    element?.addEventListener('contextmenu', conditionalHandler, true);\n    element?.addEventListener('mousedown', handleMouseDown, true);\n\n    // Garbage collect this event after it's no longer useful to avoid memory leaks\n    timeoutId.current = win?.setTimeout(() => {\n      currentEvent = undefined;\n    }, 1);\n\n    return () => {\n      element?.removeEventListener('click', conditionalHandler, true);\n      element?.removeEventListener('touchstart', conditionalHandler, true);\n      element?.removeEventListener('contextmenu', conditionalHandler, true);\n      element?.removeEventListener('mousedown', handleMouseDown, true);\n\n      win?.clearTimeout(timeoutId.current);\n      currentEvent = undefined;\n    };\n  }, [listener, element, disabled, handleMouseDown, win]);\n};\n\nconst getWindowEvent = (target: Node | Window | null | undefined): Event | undefined => {\n  if (target) {\n    if (typeof (target as Window).window === 'object' && (target as Window).window === target) {\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\n      return target.event;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    return (target as Node).ownerDocument?.defaultView?.event ?? undefined;\n  }\n\n  return undefined;\n};\n\nconst FUI_FRAME_EVENT = 'fuiframefocus';\n\ninterface UseIFrameFocusOptions\n  extends Pick<UseOnClickOrScrollOutsideOptions, 'disabled' | 'element' | 'callback' | 'contains' | 'refs'> {\n  /**\n   * Millisecond duration to poll\n   */\n  pollDuration?: number;\n}\n\n/**\n * Since click events do not propagate past iframes, we use focus to detect if a\n * click has happened inside an iframe, since the only ways of focusing inside an\n * iframe are:\n *   - clicking inside\n *   - tabbing inside\n *\n * Polls the value of `document.activeElement`. If it is an iframe, then dispatch\n * a custom DOM event. When the custom event is received call the provided callback\n */\nconst useIFrameFocus = (options: UseIFrameFocusOptions) => {\n  const {\n    disabled,\n    element: targetDocument,\n    callback,\n    contains = DEFAULT_CONTAINS,\n    pollDuration = 100,\n    refs,\n  } = options;\n  const timeoutRef = React.useRef<number>();\n\n  const listener = useEventCallback((e: Event) => {\n    const isOutside = refs.every(ref => !contains(ref.current || null, e.target as HTMLElement));\n\n    if (isOutside && !disabled) {\n      callback(e as MouseEvent);\n    }\n  });\n\n  // Adds listener to the custom iframe focus event\n  React.useEffect(() => {\n    if (disabled) {\n      return;\n    }\n\n    targetDocument?.addEventListener(FUI_FRAME_EVENT, listener, true);\n\n    return () => {\n      targetDocument?.removeEventListener(FUI_FRAME_EVENT, listener, true);\n    };\n  }, [targetDocument, disabled, listener]);\n\n  // Starts polling for the active element\n  React.useEffect(() => {\n    if (disabled) {\n      return;\n    }\n\n    timeoutRef.current = targetDocument?.defaultView?.setInterval(() => {\n      const activeElement = targetDocument?.activeElement;\n\n      if (activeElement?.tagName === 'IFRAME' || activeElement?.tagName === 'WEBVIEW') {\n        const event = new CustomEvent(FUI_FRAME_EVENT, { bubbles: true });\n        activeElement.dispatchEvent(event);\n      }\n    }, pollDuration);\n\n    return () => {\n      targetDocument?.defaultView?.clearTimeout(timeoutRef.current);\n    };\n  }, [targetDocument, disabled, pollDuration]);\n};\n"],"names":["React","useEventCallback","useFluent_unstable","useFluent","DEFAULT_CONTAINS","parent","child","contains","useOnClickOutside","options","targetDocument","win","defaultView","refs","callback","element","disabled","disabledFocusOnIframe","timeoutId","useRef","undefined","useIFrameFocus","isMouseDownInsideRef","listener","ev","current","target","composedPath","isOutside","every","ref","handleMouseDown","some","useEffect","currentEvent","getWindowEvent","conditionalHandler","event","addEventListener","setTimeout","removeEventListener","clearTimeout","window","ownerDocument","FUI_FRAME_EVENT","pollDuration","timeoutRef","e","setInterval","activeElement","tagName","CustomEvent","bubbles","dispatchEvent"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"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"}

package/lib-commonjs/hooks/useOnClickOutside.js

@@ -108,7 +108,7 @@ const FUI_FRAME_EVENT = 'fuiframefocus';
  * Polls the value of `document.activeElement`. If it is an iframe, then dispatch
  * a custom DOM event. When the custom event is received call the provided callback
  */ const useIFrameFocus = (options)=>{
-    const { disabled, element: targetDocument, callback, contains = DEFAULT_CONTAINS, pollDuration = 1000, refs } = options;
+    const { disabled, element: targetDocument, callback, contains = DEFAULT_CONTAINS, pollDuration = 100, refs } = options;
     const timeoutRef = _react.useRef();
     const listener = (0, _useEventCallback.useEventCallback)((e)=>{
         const isOutside = refs.every((ref)=>!contains(ref.current || null, e.target));

package/lib-commonjs/hooks/useOnClickOutside.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hooks/useOnClickOutside.ts"],"sourcesContent":["import * as React from 'react';\nimport { useEventCallback } from './useEventCallback';\nimport { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';\n\n/**\n * @internal\n */\nexport type UseOnClickOrScrollOutsideOptions = {\n  /**\n   * The element to listen for the click event\n   */\n  element: Document | undefined;\n  /**\n   * Refs to elements that check if the click is outside\n   */\n  refs: React.MutableRefObject<HTMLElement | undefined | null>[];\n\n  /**\n   * By default uses element.contains, but custom contain function can be provided\n   *\n   * @param parent - provided parent element\n   * @param child - event target element\n   */\n  contains?(parent: HTMLElement | null, child: HTMLElement): boolean;\n\n  /**\n   * Disables event listeners\n   */\n  disabled?: boolean;\n\n  /**\n   * Disables custom focus event listeners for iframes\n   */\n  disabledFocusOnIframe?: boolean;\n\n  /**\n   * Called if the click is outside the element refs\n   */\n  callback: (ev: MouseEvent | TouchEvent) => void;\n};\n\nconst DEFAULT_CONTAINS: UseOnClickOrScrollOutsideOptions['contains'] = (parent, child) => !!parent?.contains(child);\n\n/**\n * @internal\n * Utility to perform checks where a click/touch event was made outside a component\n */\nexport const useOnClickOutside = (options: UseOnClickOrScrollOutsideOptions) => {\n  const { targetDocument } = useFluent();\n  const win = targetDocument?.defaultView;\n  const { refs, callback, element, disabled, disabledFocusOnIframe, contains = DEFAULT_CONTAINS } = options;\n  const timeoutId = React.useRef<number | undefined>(undefined);\n\n  useIFrameFocus({ element, disabled: disabledFocusOnIframe || disabled, callback, refs, contains });\n\n  const isMouseDownInsideRef = React.useRef(false);\n  const listener = useEventCallback((ev: MouseEvent | TouchEvent) => {\n    if (isMouseDownInsideRef.current) {\n      isMouseDownInsideRef.current = false;\n      return;\n    }\n\n    const target = ev.composedPath()[0] as HTMLElement;\n    const isOutside = refs.every(ref => !contains(ref.current || null, target));\n\n    if (isOutside && !disabled) {\n      callback(ev);\n    }\n  });\n\n  const handleMouseDown = useEventCallback((ev: MouseEvent) => {\n    // Selecting text from inside to outside will rigger click event.\n    // In this case click event target is outside but mouse down event target is inside.\n    // And this click event should be considered as inside click.\n    isMouseDownInsideRef.current = refs.some(ref => contains(ref.current || null, ev.target as HTMLElement));\n  });\n\n  React.useEffect(() => {\n    if (disabled) {\n      return;\n    }\n\n    // Store the current event to avoid triggering handlers immediately\n    // Note this depends on a deprecated but extremely well supported quirk of the web platform\n    // https://github.com/facebook/react/issues/20074\n    let currentEvent = getWindowEvent(win);\n\n    const conditionalHandler = (event: MouseEvent | TouchEvent) => {\n      // Skip if this event is the same as the one running when we added the handlers\n      if (event === currentEvent) {\n        currentEvent = undefined;\n        return;\n      }\n\n      listener(event);\n    };\n\n    // use capture phase because React can update DOM before the event bubbles to the document\n    element?.addEventListener('click', conditionalHandler, true);\n    element?.addEventListener('touchstart', conditionalHandler, true);\n    element?.addEventListener('contextmenu', conditionalHandler, true);\n    element?.addEventListener('mousedown', handleMouseDown, true);\n\n    // Garbage collect this event after it's no longer useful to avoid memory leaks\n    timeoutId.current = win?.setTimeout(() => {\n      currentEvent = undefined;\n    }, 1);\n\n    return () => {\n      element?.removeEventListener('click', conditionalHandler, true);\n      element?.removeEventListener('touchstart', conditionalHandler, true);\n      element?.removeEventListener('contextmenu', conditionalHandler, true);\n      element?.removeEventListener('mousedown', handleMouseDown, true);\n\n      win?.clearTimeout(timeoutId.current);\n      currentEvent = undefined;\n    };\n  }, [listener, element, disabled, handleMouseDown, win]);\n};\n\nconst getWindowEvent = (target: Node | Window | null | undefined): Event | undefined => {\n  if (target) {\n    if (typeof (target as Window).window === 'object' && (target as Window).window === target) {\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\n      return target.event;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    return (target as Node).ownerDocument?.defaultView?.event ?? undefined;\n  }\n\n  return undefined;\n};\n\nconst FUI_FRAME_EVENT = 'fuiframefocus';\n\ninterface UseIFrameFocusOptions\n  extends Pick<UseOnClickOrScrollOutsideOptions, 'disabled' | 'element' | 'callback' | 'contains' | 'refs'> {\n  /**\n   * Millisecond duration to poll\n   */\n  pollDuration?: number;\n}\n\n/**\n * Since click events do not propagate past iframes, we use focus to detect if a\n * click has happened inside an iframe, since the only ways of focusing inside an\n * iframe are:\n *   - clicking inside\n *   - tabbing inside\n *\n * Polls the value of `document.activeElement`. If it is an iframe, then dispatch\n * a custom DOM event. When the custom event is received call the provided callback\n */\nconst useIFrameFocus = (options: UseIFrameFocusOptions) => {\n  const {\n    disabled,\n    element: targetDocument,\n    callback,\n    contains = DEFAULT_CONTAINS,\n    pollDuration = 1000,\n    refs,\n  } = options;\n  const timeoutRef = React.useRef<number>();\n\n  const listener = useEventCallback((e: Event) => {\n    const isOutside = refs.every(ref => !contains(ref.current || null, e.target as HTMLElement));\n\n    if (isOutside && !disabled) {\n      callback(e as MouseEvent);\n    }\n  });\n\n  // Adds listener to the custom iframe focus event\n  React.useEffect(() => {\n    if (disabled) {\n      return;\n    }\n\n    targetDocument?.addEventListener(FUI_FRAME_EVENT, listener, true);\n\n    return () => {\n      targetDocument?.removeEventListener(FUI_FRAME_EVENT, listener, true);\n    };\n  }, [targetDocument, disabled, listener]);\n\n  // Starts polling for the active element\n  React.useEffect(() => {\n    if (disabled) {\n      return;\n    }\n\n    timeoutRef.current = targetDocument?.defaultView?.setInterval(() => {\n      const activeElement = targetDocument?.activeElement;\n\n      if (activeElement?.tagName === 'IFRAME' || activeElement?.tagName === 'WEBVIEW') {\n        const event = new CustomEvent(FUI_FRAME_EVENT, { bubbles: true });\n        activeElement.dispatchEvent(event);\n      }\n    }, pollDuration);\n\n    return () => {\n      targetDocument?.defaultView?.clearTimeout(timeoutRef.current);\n    };\n  }, [targetDocument, disabled, pollDuration]);\n};\n"],"names":["useOnClickOutside","DEFAULT_CONTAINS","parent","child","contains","options","targetDocument","useFluent","win","defaultView","refs","callback","element","disabled","disabledFocusOnIframe","timeoutId","React","useRef","undefined","useIFrameFocus","isMouseDownInsideRef","listener","useEventCallback","ev","current","target","composedPath","isOutside","every","ref","handleMouseDown","some","useEffect","currentEvent","getWindowEvent","conditionalHandler","event","addEventListener","setTimeout","removeEventListener","clearTimeout","window","ownerDocument","FUI_FRAME_EVENT","pollDuration","timeoutRef","e","setInterval","activeElement","tagName","CustomEvent","bubbles","dispatchEvent"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"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"}
+{"version":3,"sources":["../src/hooks/useOnClickOutside.ts"],"sourcesContent":["import * as React from 'react';\nimport { useEventCallback } from './useEventCallback';\nimport { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';\n\n/**\n * @internal\n */\nexport type UseOnClickOrScrollOutsideOptions = {\n  /**\n   * The element to listen for the click event\n   */\n  element: Document | undefined;\n  /**\n   * Refs to elements that check if the click is outside\n   */\n  refs: React.MutableRefObject<HTMLElement | undefined | null>[];\n\n  /**\n   * By default uses element.contains, but custom contain function can be provided\n   *\n   * @param parent - provided parent element\n   * @param child - event target element\n   */\n  contains?(parent: HTMLElement | null, child: HTMLElement): boolean;\n\n  /**\n   * Disables event listeners\n   */\n  disabled?: boolean;\n\n  /**\n   * Disables custom focus event listeners for iframes\n   */\n  disabledFocusOnIframe?: boolean;\n\n  /**\n   * Called if the click is outside the element refs\n   */\n  callback: (ev: MouseEvent | TouchEvent) => void;\n};\n\nconst DEFAULT_CONTAINS: UseOnClickOrScrollOutsideOptions['contains'] = (parent, child) => !!parent?.contains(child);\n\n/**\n * @internal\n * Utility to perform checks where a click/touch event was made outside a component\n */\nexport const useOnClickOutside = (options: UseOnClickOrScrollOutsideOptions) => {\n  const { targetDocument } = useFluent();\n  const win = targetDocument?.defaultView;\n  const { refs, callback, element, disabled, disabledFocusOnIframe, contains = DEFAULT_CONTAINS } = options;\n  const timeoutId = React.useRef<number | undefined>(undefined);\n\n  useIFrameFocus({ element, disabled: disabledFocusOnIframe || disabled, callback, refs, contains });\n\n  const isMouseDownInsideRef = React.useRef(false);\n  const listener = useEventCallback((ev: MouseEvent | TouchEvent) => {\n    if (isMouseDownInsideRef.current) {\n      isMouseDownInsideRef.current = false;\n      return;\n    }\n\n    const target = ev.composedPath()[0] as HTMLElement;\n    const isOutside = refs.every(ref => !contains(ref.current || null, target));\n\n    if (isOutside && !disabled) {\n      callback(ev);\n    }\n  });\n\n  const handleMouseDown = useEventCallback((ev: MouseEvent) => {\n    // Selecting text from inside to outside will rigger click event.\n    // In this case click event target is outside but mouse down event target is inside.\n    // And this click event should be considered as inside click.\n    isMouseDownInsideRef.current = refs.some(ref => contains(ref.current || null, ev.target as HTMLElement));\n  });\n\n  React.useEffect(() => {\n    if (disabled) {\n      return;\n    }\n\n    // Store the current event to avoid triggering handlers immediately\n    // Note this depends on a deprecated but extremely well supported quirk of the web platform\n    // https://github.com/facebook/react/issues/20074\n    let currentEvent = getWindowEvent(win);\n\n    const conditionalHandler = (event: MouseEvent | TouchEvent) => {\n      // Skip if this event is the same as the one running when we added the handlers\n      if (event === currentEvent) {\n        currentEvent = undefined;\n        return;\n      }\n\n      listener(event);\n    };\n\n    // use capture phase because React can update DOM before the event bubbles to the document\n    element?.addEventListener('click', conditionalHandler, true);\n    element?.addEventListener('touchstart', conditionalHandler, true);\n    element?.addEventListener('contextmenu', conditionalHandler, true);\n    element?.addEventListener('mousedown', handleMouseDown, true);\n\n    // Garbage collect this event after it's no longer useful to avoid memory leaks\n    timeoutId.current = win?.setTimeout(() => {\n      currentEvent = undefined;\n    }, 1);\n\n    return () => {\n      element?.removeEventListener('click', conditionalHandler, true);\n      element?.removeEventListener('touchstart', conditionalHandler, true);\n      element?.removeEventListener('contextmenu', conditionalHandler, true);\n      element?.removeEventListener('mousedown', handleMouseDown, true);\n\n      win?.clearTimeout(timeoutId.current);\n      currentEvent = undefined;\n    };\n  }, [listener, element, disabled, handleMouseDown, win]);\n};\n\nconst getWindowEvent = (target: Node | Window | null | undefined): Event | undefined => {\n  if (target) {\n    if (typeof (target as Window).window === 'object' && (target as Window).window === target) {\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\n      return target.event;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    return (target as Node).ownerDocument?.defaultView?.event ?? undefined;\n  }\n\n  return undefined;\n};\n\nconst FUI_FRAME_EVENT = 'fuiframefocus';\n\ninterface UseIFrameFocusOptions\n  extends Pick<UseOnClickOrScrollOutsideOptions, 'disabled' | 'element' | 'callback' | 'contains' | 'refs'> {\n  /**\n   * Millisecond duration to poll\n   */\n  pollDuration?: number;\n}\n\n/**\n * Since click events do not propagate past iframes, we use focus to detect if a\n * click has happened inside an iframe, since the only ways of focusing inside an\n * iframe are:\n *   - clicking inside\n *   - tabbing inside\n *\n * Polls the value of `document.activeElement`. If it is an iframe, then dispatch\n * a custom DOM event. When the custom event is received call the provided callback\n */\nconst useIFrameFocus = (options: UseIFrameFocusOptions) => {\n  const {\n    disabled,\n    element: targetDocument,\n    callback,\n    contains = DEFAULT_CONTAINS,\n    pollDuration = 100,\n    refs,\n  } = options;\n  const timeoutRef = React.useRef<number>();\n\n  const listener = useEventCallback((e: Event) => {\n    const isOutside = refs.every(ref => !contains(ref.current || null, e.target as HTMLElement));\n\n    if (isOutside && !disabled) {\n      callback(e as MouseEvent);\n    }\n  });\n\n  // Adds listener to the custom iframe focus event\n  React.useEffect(() => {\n    if (disabled) {\n      return;\n    }\n\n    targetDocument?.addEventListener(FUI_FRAME_EVENT, listener, true);\n\n    return () => {\n      targetDocument?.removeEventListener(FUI_FRAME_EVENT, listener, true);\n    };\n  }, [targetDocument, disabled, listener]);\n\n  // Starts polling for the active element\n  React.useEffect(() => {\n    if (disabled) {\n      return;\n    }\n\n    timeoutRef.current = targetDocument?.defaultView?.setInterval(() => {\n      const activeElement = targetDocument?.activeElement;\n\n      if (activeElement?.tagName === 'IFRAME' || activeElement?.tagName === 'WEBVIEW') {\n        const event = new CustomEvent(FUI_FRAME_EVENT, { bubbles: true });\n        activeElement.dispatchEvent(event);\n      }\n    }, pollDuration);\n\n    return () => {\n      targetDocument?.defaultView?.clearTimeout(timeoutRef.current);\n    };\n  }, [targetDocument, disabled, pollDuration]);\n};\n"],"names":["useOnClickOutside","DEFAULT_CONTAINS","parent","child","contains","options","targetDocument","useFluent","win","defaultView","refs","callback","element","disabled","disabledFocusOnIframe","timeoutId","React","useRef","undefined","useIFrameFocus","isMouseDownInsideRef","listener","useEventCallback","ev","current","target","composedPath","isOutside","every","ref","handleMouseDown","some","useEffect","currentEvent","getWindowEvent","conditionalHandler","event","addEventListener","setTimeout","removeEventListener","clearTimeout","window","ownerDocument","FUI_FRAME_EVENT","pollDuration","timeoutRef","e","setInterval","activeElement","tagName","CustomEvent","bubbles","dispatchEvent"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluentui/react-utilities",
-  "version": "9.21.0",
+  "version": "9.22.0",
   "description": "A set of general React-specific utilities.",
   "main": "lib-commonjs/index.js",
   "module": "lib/index.js",
@@ -18,7 +18,7 @@
   },
   "dependencies": {
     "@fluentui/keyboard-keys": "^9.0.8",
-    "@fluentui/react-shared-contexts": "^9.23.1",
+    "@fluentui/react-shared-contexts": "^9.24.0",
     "@swc/helpers": "^0.5.1"
   },
   "peerDependencies": {