@fluentui/react-positioning 0.0.0-nightly-20250606-0405.1 → 0.0.0-nightly-20250610-0406.1

package/CHANGELOG.md

@@ -1,20 +1,29 @@
 # Change Log - @fluentui/react-positioning
 
-This log was last generated on Fri, 06 Jun 2025 04:21:45 GMT and should not be manually modified.
+This log was last generated on Tue, 10 Jun 2025 04:22:19 GMT and should not be manually modified.
 
 <!-- Start content -->
 
-## [0.0.0-nightly-20250606-0405.1](https://github.com/microsoft/fluentui/tree/@fluentui/react-positioning_v0.0.0-nightly-20250606-0405.1)
+## [0.0.0-nightly-20250610-0406.1](https://github.com/microsoft/fluentui/tree/@fluentui/react-positioning_v0.0.0-nightly-20250610-0406.1)
 
-Fri, 06 Jun 2025 04:21:45 GMT 
-[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-positioning_v9.17.0..@fluentui/react-positioning_v0.0.0-nightly-20250606-0405.1)
+Tue, 10 Jun 2025 04:22:19 GMT 
+[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-positioning_v9.17.1..@fluentui/react-positioning_v0.0.0-nightly-20250610-0406.1)
 
 ### Changes
 
 - Release nightly v9 ([commit](https://github.com/microsoft/fluentui/commit/not available) by fluentui-internal@service.microsoft.com)
-- Bump @fluentui/react-shared-contexts to v0.0.0-nightly-20250606-0405.1 ([commit](https://github.com/microsoft/fluentui/commit/f1523d2bfb54ca4e633a9db2acae43152198f20c) by beachball)
-- Bump @fluentui/react-theme to v0.0.0-nightly-20250606-0405.1 ([commit](https://github.com/microsoft/fluentui/commit/f1523d2bfb54ca4e633a9db2acae43152198f20c) by beachball)
-- Bump @fluentui/react-utilities to v0.0.0-nightly-20250606-0405.1 ([commit](https://github.com/microsoft/fluentui/commit/f1523d2bfb54ca4e633a9db2acae43152198f20c) by beachball)
+- Bump @fluentui/react-shared-contexts to v0.0.0-nightly-20250610-0406.1 ([commit](https://github.com/microsoft/fluentui/commit/a18ca95f71f3fcdd891b8a84b365cb938d37b111) by beachball)
+- Bump @fluentui/react-theme to v0.0.0-nightly-20250610-0406.1 ([commit](https://github.com/microsoft/fluentui/commit/a18ca95f71f3fcdd891b8a84b365cb938d37b111) by beachball)
+- Bump @fluentui/react-utilities to v0.0.0-nightly-20250610-0406.1 ([commit](https://github.com/microsoft/fluentui/commit/a18ca95f71f3fcdd891b8a84b365cb938d37b111) by beachball)
+
+## [9.17.1](https://github.com/microsoft/fluentui/tree/@fluentui/react-positioning_v9.17.1)
+
+Fri, 06 Jun 2025 13:15:17 GMT 
+[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-positioning_v9.17.0..@fluentui/react-positioning_v9.17.1)
+
+### Patches
+
+- Bump @fluentui/react-utilities to v9.20.0 ([PR #34572](https://github.com/microsoft/fluentui/pull/34572) by beachball)
 
 ## [9.17.0](https://github.com/microsoft/fluentui/tree/@fluentui/react-positioning_v9.17.0)
 

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import type { GriffelStyle } from '@griffel/react';
 import * as React_2 from 'react';
+import { RefObjectFunction } from '@fluentui/react-utilities';
 
 export declare type Alignment = 'top' | 'bottom' | 'start' | 'end' | 'center';
 
@@ -296,6 +297,23 @@ export declare type PositioningVirtualElement = {
 
 export declare function resolvePositioningShorthand(shorthand: PositioningShorthand | undefined | null): Readonly<PositioningProps>;
 
+export declare type SafeBufferAreaOptions = {
+    /** Enables debug mode: makes drawn shapes visible. */
+    debug?: boolean;
+    /** Disables the safe zone area. */
+    disabled?: boolean;
+    /** The time in milliseconds to wait before clearing the safe zone. */
+    timeout?: number;
+    /** Called when the mouse enters the safe zone. */
+    onSafeZoneEnter?: (e: React_2.MouseEvent) => void;
+    /** Called when the mouse moves within the safe zone. */
+    onSafeZoneMove?: (e: React_2.MouseEvent) => void;
+    /** Called when the mouse leaves the safe zone. */
+    onSafeZoneLeave?: (e: React_2.MouseEvent) => void;
+    /** Called when the safe zone times out, even if a cursor is still over a safe zone. */
+    onSafeZoneTimeout?: () => void;
+};
+
 export declare type SetVirtualMouseTarget = (event: React_2.MouseEvent | MouseEvent | undefined | null) => void;
 
 declare type TargetElement = HTMLElement | PositioningVirtualElement;
@@ -322,4 +340,10 @@ declare interface UsePositioningReturn {
     arrowRef: React_2.MutableRefObject<any>;
 }
 
+export declare function useSafeZoneArea({ debug, disabled, onSafeZoneEnter, onSafeZoneMove, onSafeZoneLeave, onSafeZoneTimeout, timeout, }?: SafeBufferAreaOptions): {
+    containerRef: RefObjectFunction<HTMLElement>;
+    targetRef: RefObjectFunction<HTMLElement>;
+    elementToRender: JSX.Element | null;
+};
+
 export { }

package/lib/SafeZoneArea.js

@@ -0,0 +1,306 @@
+import { mergeClasses } from '@griffel/react';
+import { useId } from '@fluentui/react-utilities';
+import * as React from 'react';
+import { useSyncExternalStore } from 'use-sync-external-store/shim';
+import { useStyles } from './SafeZoneArea.styles';
+export function createSafeZoneAreaStateStore() {
+    let isActive = false;
+    const listeners = [];
+    return {
+        isActive () {
+            return isActive;
+        },
+        toggleActive (newIsActive) {
+            isActive = newIsActive;
+            listeners.forEach((listener)=>listener(isActive));
+        },
+        subscribe (listener) {
+            listeners.push(listener);
+            return ()=>{
+                const index = listeners.indexOf(listener);
+                if (index > -1) {
+                    listeners.splice(index, 1);
+                }
+            };
+        }
+    };
+}
+/**
+ * A component that renders a safe zone area with SVG shapes. Uses `useSyncExternalStore` to manage its active state
+ * to avoid causing re-renders in `useSafeZoneArea()` as the hook might be used in host components like `Menu`.
+ *
+ * Draws two shapes:
+ * - a triangle that points to the target element which is an actual safe zone
+ * - a rectangle for a clip path that clips out the target element
+ *
+ * @internal
+ */ export const SafeZoneArea = /*#__PURE__*/ React.memo((props)=>{
+    const { debug, onMouseEnter, onMouseMove, onMouseLeave, stateStore } = props;
+    const clipPathId = useId();
+    const styles = useStyles();
+    const active = useSyncExternalStore(stateStore.subscribe, stateStore.isActive);
+    const svgRef = React.useRef(null);
+    React.useImperativeHandle(props.imperativeRef, ()=>({
+            updateSVG ({ containerPlacementSide, containerRect, mouseCoordinates, targetRect }) {
+                const svgEl = svgRef.current;
+                if (!svgEl) {
+                    return;
+                }
+                const trianglePathEl = svgEl.children.item(0);
+                const debugRectEl = svgEl.children.item(2);
+                const clipPathEl = svgEl.children.item(1);
+                const clipPathRect = clipPathEl.firstElementChild;
+                const SIZE_MULTIPLIER = 0.9;
+                let svgStyle;
+                let tringlePoints = [];
+                let clipPoints = [];
+                switch(containerPlacementSide){
+                    case 'top':
+                        svgStyle = {
+                            width: `${containerRect.width}px`,
+                            height: `${targetRect.bottom - containerRect.bottom}px`,
+                            transform: `translate(${containerRect.left}px, ${containerRect.bottom}px)`
+                        };
+                        tringlePoints = [
+                            [
+                                containerRect.width,
+                                0
+                            ],
+                            [
+                                mouseCoordinates.x - containerRect.left,
+                                (mouseCoordinates.y - containerRect.bottom) / SIZE_MULTIPLIER
+                            ],
+                            [
+                                0,
+                                0
+                            ]
+                        ];
+                        clipPoints = [
+                            [
+                                0,
+                                0
+                            ],
+                            [
+                                0,
+                                targetRect.bottom - containerRect.bottom
+                            ],
+                            [
+                                targetRect.left - containerRect.left,
+                                targetRect.bottom - containerRect.bottom
+                            ],
+                            [
+                                targetRect.left - containerRect.left,
+                                targetRect.top - containerRect.bottom
+                            ],
+                            [
+                                targetRect.right - containerRect.left,
+                                targetRect.top - containerRect.bottom
+                            ],
+                            [
+                                targetRect.right - containerRect.left,
+                                targetRect.bottom - containerRect.bottom
+                            ],
+                            [
+                                containerRect.width,
+                                targetRect.bottom - containerRect.bottom
+                            ],
+                            [
+                                containerRect.width,
+                                0
+                            ]
+                        ];
+                        break;
+                    case 'bottom':
+                        svgStyle = {
+                            width: `${containerRect.width}px`,
+                            height: `${containerRect.top - targetRect.top}px`,
+                            transform: `translate(${containerRect.left}px, ${targetRect.top}px)`
+                        };
+                        tringlePoints = [
+                            [
+                                containerRect.width,
+                                containerRect.top - targetRect.top
+                            ],
+                            [
+                                mouseCoordinates.x - containerRect.left,
+                                (mouseCoordinates.y - targetRect.top) * SIZE_MULTIPLIER
+                            ],
+                            [
+                                0,
+                                containerRect.top - targetRect.top
+                            ]
+                        ];
+                        clipPoints = [
+                            [
+                                0,
+                                0
+                            ],
+                            [
+                                0,
+                                containerRect.top - targetRect.top
+                            ],
+                            [
+                                containerRect.width,
+                                containerRect.top - targetRect.top
+                            ],
+                            [
+                                containerRect.width,
+                                0
+                            ],
+                            [
+                                targetRect.right - containerRect.left,
+                                0
+                            ],
+                            [
+                                targetRect.right - containerRect.left,
+                                targetRect.height
+                            ],
+                            [
+                                targetRect.left - containerRect.left,
+                                targetRect.height
+                            ],
+                            [
+                                targetRect.left - containerRect.left,
+                                0
+                            ]
+                        ];
+                        break;
+                    case 'left':
+                        svgStyle = {
+                            width: `${targetRect.right - containerRect.right}px`,
+                            height: `${containerRect.height}px`,
+                            transform: `translate(${containerRect.right}px, ${containerRect.top}px)`
+                        };
+                        tringlePoints = [
+                            [
+                                (mouseCoordinates.x - containerRect.right) / SIZE_MULTIPLIER,
+                                mouseCoordinates.y - containerRect.top
+                            ],
+                            [
+                                0,
+                                containerRect.height
+                            ],
+                            [
+                                0,
+                                0
+                            ]
+                        ];
+                        clipPoints = [
+                            [
+                                0,
+                                0
+                            ],
+                            [
+                                0,
+                                containerRect.height
+                            ],
+                            [
+                                targetRect.right - containerRect.right,
+                                containerRect.height
+                            ],
+                            [
+                                targetRect.right - containerRect.right,
+                                targetRect.bottom - containerRect.top
+                            ],
+                            [
+                                targetRect.left - containerRect.right,
+                                targetRect.bottom - containerRect.top
+                            ],
+                            [
+                                targetRect.left - containerRect.right,
+                                targetRect.top - containerRect.top
+                            ],
+                            [
+                                targetRect.right - containerRect.right,
+                                targetRect.top - containerRect.top
+                            ],
+                            [
+                                targetRect.right - containerRect.right,
+                                0
+                            ]
+                        ];
+                        break;
+                    default:
+                        svgStyle = {
+                            width: `${containerRect.left - targetRect.left}px`,
+                            height: `${containerRect.height}px`,
+                            transform: `translate(${targetRect.left}px, ${containerRect.top}px)`
+                        };
+                        tringlePoints = [
+                            [
+                                (mouseCoordinates.x - targetRect.left) * SIZE_MULTIPLIER,
+                                mouseCoordinates.y - containerRect.y
+                            ],
+                            [
+                                containerRect.left - targetRect.left,
+                                containerRect.height
+                            ],
+                            [
+                                containerRect.left - targetRect.left,
+                                0
+                            ]
+                        ];
+                        clipPoints = [
+                            [
+                                0,
+                                0
+                            ],
+                            [
+                                0,
+                                targetRect.top - containerRect.top
+                            ],
+                            [
+                                targetRect.width,
+                                targetRect.top - containerRect.top
+                            ],
+                            [
+                                targetRect.width,
+                                targetRect.bottom - containerRect.top
+                            ],
+                            [
+                                0,
+                                targetRect.bottom - containerRect.top
+                            ],
+                            [
+                                0,
+                                containerRect.height
+                            ],
+                            [
+                                containerRect.left - targetRect.left,
+                                containerRect.height
+                            ],
+                            [
+                                containerRect.left - targetRect.left,
+                                0
+                            ]
+                        ];
+                        break;
+                }
+                const trianglePath = `M ${tringlePoints.flatMap((p)=>p).join(' ')} z`;
+                const clipPath = `M ${clipPoints.flatMap((p)=>p).join(' ')} z`;
+                Object.assign(svgEl.style, svgStyle);
+                trianglePathEl.setAttributeNS(null, 'd', trianglePath);
+                clipPathRect.setAttributeNS(null, 'd', clipPath);
+                debugRectEl === null || debugRectEl === void 0 ? void 0 : debugRectEl.setAttributeNS(null, 'd', clipPath);
+            }
+        }), []);
+    return /*#__PURE__*/ React.createElement("div", {
+        className: mergeClasses(styles.wrapper, active && styles.wrapperActive),
+        "data-safe-zone": ""
+    }, active ? /*#__PURE__*/ React.createElement("svg", {
+        "aria-hidden": true,
+        className: styles.svg,
+        xmlns: "http://www.w3.org/2000/svg",
+        ref: svgRef
+    }, /*#__PURE__*/ React.createElement("path", {
+        className: mergeClasses(styles.triangle, debug && styles.triangleDebug),
+        clipPath: `url(#${clipPathId})`,
+        onMouseEnter: onMouseEnter,
+        onMouseMove: onMouseMove,
+        onMouseLeave: onMouseLeave
+    }), /*#__PURE__*/ React.createElement("clipPath", {
+        id: clipPathId
+    }, /*#__PURE__*/ React.createElement("path", null)), debug && /*#__PURE__*/ React.createElement("path", {
+        className: styles.rectDebug
+    })) : null);
+});

package/lib/SafeZoneArea.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/SafeZoneArea.tsx"],"sourcesContent":["import { mergeClasses } from '@griffel/react';\nimport { useId } from '@fluentui/react-utilities';\nimport type { Side as PlacementSide } from '@floating-ui/dom';\nimport * as React from 'react';\nimport { useSyncExternalStore } from 'use-sync-external-store/shim';\n\nimport { useStyles } from './SafeZoneArea.styles';\n\nexport type SafeZoneAreaImperativeHandle = {\n  updateSVG: (options: {\n    containerPlacementSide: PlacementSide;\n    containerRect: DOMRect;\n    targetRect: DOMRect;\n    mouseCoordinates: { x: number; y: number };\n  }) => void;\n};\n\nexport type SafeZoneAreaProps = {\n  /** Enables debug mode: makes drawn shapes visible. */\n  debug: boolean;\n\n  /** A reference to the SafeZoneArea imperative handle. */\n  imperativeRef: React.Ref<SafeZoneAreaImperativeHandle>;\n\n  // eslint-disable-next-line @nx/workspace-consistent-callback-type\n  onMouseEnter: (e: React.MouseEvent) => void;\n  // eslint-disable-next-line @nx/workspace-consistent-callback-type\n  onMouseMove: (e: React.MouseEvent) => void;\n  // eslint-disable-next-line @nx/workspace-consistent-callback-type\n  onMouseLeave: (e: React.MouseEvent) => void;\n\n  stateStore: ReturnType<typeof createSafeZoneAreaStateStore>;\n};\n\nexport function createSafeZoneAreaStateStore() {\n  let isActive = false;\n  const listeners: ((value: boolean) => void)[] = [];\n\n  return {\n    isActive() {\n      return isActive;\n    },\n    toggleActive(newIsActive: boolean) {\n      isActive = newIsActive;\n      listeners.forEach(listener => listener(isActive));\n    },\n\n    subscribe(listener: (value: boolean) => void) {\n      listeners.push(listener);\n\n      return () => {\n        const index = listeners.indexOf(listener);\n\n        if (index > -1) {\n          listeners.splice(index, 1);\n        }\n      };\n    },\n  };\n}\n\n/**\n * A component that renders a safe zone area with SVG shapes. Uses `useSyncExternalStore` to manage its active state\n * to avoid causing re-renders in `useSafeZoneArea()` as the hook might be used in host components like `Menu`.\n *\n * Draws two shapes:\n * - a triangle that points to the target element which is an actual safe zone\n * - a rectangle for a clip path that clips out the target element\n *\n * @internal\n */\nexport const SafeZoneArea = React.memo((props: SafeZoneAreaProps) => {\n  const { debug, onMouseEnter, onMouseMove, onMouseLeave, stateStore } = props;\n\n  const clipPathId = useId();\n  const styles = useStyles();\n\n  const active = useSyncExternalStore(stateStore.subscribe, stateStore.isActive);\n  const svgRef = React.useRef<SVGSVGElement>(null);\n\n  React.useImperativeHandle(\n    props.imperativeRef,\n    () => ({\n      updateSVG({ containerPlacementSide, containerRect, mouseCoordinates, targetRect }) {\n        const svgEl = svgRef.current;\n\n        if (!svgEl) {\n          return;\n        }\n\n        const trianglePathEl = svgEl.children.item(0) as SVGPathElement;\n        const debugRectEl = svgEl.children.item(2) as SVGPathElement | null;\n        const clipPathEl = svgEl.children.item(1) as SVGClipPathElement;\n        const clipPathRect = clipPathEl.firstElementChild as SVGRectElement;\n\n        const SIZE_MULTIPLIER = 0.9;\n\n        let svgStyle: Partial<CSSStyleDeclaration>;\n\n        let tringlePoints: [number, number][] = [];\n        let clipPoints: [number, number][] = [];\n\n        switch (containerPlacementSide) {\n          case 'top':\n            svgStyle = {\n              width: `${containerRect.width}px`,\n              height: `${targetRect.bottom - containerRect.bottom}px`,\n              transform: `translate(${containerRect.left}px, ${containerRect.bottom}px)`,\n            };\n\n            tringlePoints = [\n              [containerRect.width, 0],\n              [mouseCoordinates.x - containerRect.left, (mouseCoordinates.y - containerRect.bottom) / SIZE_MULTIPLIER],\n              [0, 0],\n            ];\n            clipPoints = [\n              [0, 0],\n              [0, targetRect.bottom - containerRect.bottom],\n              [targetRect.left - containerRect.left, targetRect.bottom - containerRect.bottom],\n              [targetRect.left - containerRect.left, targetRect.top - containerRect.bottom],\n              [targetRect.right - containerRect.left, targetRect.top - containerRect.bottom],\n              [targetRect.right - containerRect.left, targetRect.bottom - containerRect.bottom],\n              [containerRect.width, targetRect.bottom - containerRect.bottom],\n              [containerRect.width, 0],\n            ];\n\n            break;\n\n          case 'bottom':\n            svgStyle = {\n              width: `${containerRect.width}px`,\n              height: `${containerRect.top - targetRect.top}px`,\n              transform: `translate(${containerRect.left}px, ${targetRect.top}px)`,\n            };\n\n            tringlePoints = [\n              [containerRect.width, containerRect.top - targetRect.top],\n              [mouseCoordinates.x - containerRect.left, (mouseCoordinates.y - targetRect.top) * SIZE_MULTIPLIER],\n              [0, containerRect.top - targetRect.top],\n            ];\n            clipPoints = [\n              [0, 0],\n              [0, containerRect.top - targetRect.top],\n              [containerRect.width, containerRect.top - targetRect.top],\n              [containerRect.width, 0],\n              [targetRect.right - containerRect.left, 0],\n              [targetRect.right - containerRect.left, targetRect.height],\n              [targetRect.left - containerRect.left, targetRect.height],\n              [targetRect.left - containerRect.left, 0],\n            ];\n\n            break;\n\n          case 'left':\n            svgStyle = {\n              width: `${targetRect.right - containerRect.right}px`,\n              height: `${containerRect.height}px`,\n              transform: `translate(${containerRect.right}px, ${containerRect.top}px)`,\n            };\n\n            tringlePoints = [\n              [(mouseCoordinates.x - containerRect.right) / SIZE_MULTIPLIER, mouseCoordinates.y - containerRect.top],\n              [0, containerRect.height],\n              [0, 0],\n            ];\n            clipPoints = [\n              [0, 0],\n              [0, containerRect.height],\n              [targetRect.right - containerRect.right, containerRect.height],\n              [targetRect.right - containerRect.right, targetRect.bottom - containerRect.top],\n              [targetRect.left - containerRect.right, targetRect.bottom - containerRect.top],\n              [targetRect.left - containerRect.right, targetRect.top - containerRect.top],\n              [targetRect.right - containerRect.right, targetRect.top - containerRect.top],\n              [targetRect.right - containerRect.right, 0],\n            ];\n\n            break;\n\n          default:\n            svgStyle = {\n              width: `${containerRect.left - targetRect.left}px`,\n              height: `${containerRect.height}px`,\n              transform: `translate(${targetRect.left}px, ${containerRect.top}px)`,\n            };\n\n            tringlePoints = [\n              [(mouseCoordinates.x - targetRect.left) * SIZE_MULTIPLIER, mouseCoordinates.y - containerRect.y],\n              [containerRect.left - targetRect.left, containerRect.height],\n              [containerRect.left - targetRect.left, 0],\n            ];\n            clipPoints = [\n              [0, 0],\n              [0, targetRect.top - containerRect.top],\n              [targetRect.width, targetRect.top - containerRect.top],\n              [targetRect.width, targetRect.bottom - containerRect.top],\n              [0, targetRect.bottom - containerRect.top],\n              [0, containerRect.height],\n              [containerRect.left - targetRect.left, containerRect.height],\n              [containerRect.left - targetRect.left, 0],\n            ];\n\n            break;\n        }\n\n        const trianglePath = `M ${tringlePoints.flatMap(p => p).join(' ')} z`;\n        const clipPath = `M ${clipPoints.flatMap(p => p).join(' ')} z`;\n\n        Object.assign(svgEl.style, svgStyle);\n\n        trianglePathEl.setAttributeNS(null, 'd', trianglePath);\n        clipPathRect.setAttributeNS(null, 'd', clipPath);\n        debugRectEl?.setAttributeNS(null, 'd', clipPath);\n      },\n    }),\n    [],\n  );\n\n  return (\n    <div className={mergeClasses(styles.wrapper, active && styles.wrapperActive)} data-safe-zone=\"\">\n      {active ? (\n        <svg aria-hidden className={styles.svg} xmlns=\"http://www.w3.org/2000/svg\" ref={svgRef}>\n          <path\n            className={mergeClasses(styles.triangle, debug && styles.triangleDebug)}\n            clipPath={`url(#${clipPathId})`}\n            onMouseEnter={onMouseEnter}\n            onMouseMove={onMouseMove}\n            onMouseLeave={onMouseLeave}\n          />\n          <clipPath id={clipPathId}>\n            <path />\n          </clipPath>\n\n          {debug && <path className={styles.rectDebug} />}\n        </svg>\n      ) : null}\n    </div>\n  );\n});\n"],"names":["mergeClasses","useId","React","useSyncExternalStore","useStyles","createSafeZoneAreaStateStore","isActive","listeners","toggleActive","newIsActive","forEach","listener","subscribe","push","index","indexOf","splice","SafeZoneArea","memo","props","debug","onMouseEnter","onMouseMove","onMouseLeave","stateStore","clipPathId","styles","active","svgRef","useRef","useImperativeHandle","imperativeRef","updateSVG","containerPlacementSide","containerRect","mouseCoordinates","targetRect","svgEl","current","trianglePathEl","children","item","debugRectEl","clipPathEl","clipPathRect","firstElementChild","SIZE_MULTIPLIER","svgStyle","tringlePoints","clipPoints","width","height","bottom","transform","left","x","y","top","right","trianglePath","flatMap","p","join","clipPath","Object","assign","style","setAttributeNS","div","className","wrapper","wrapperActive","data-safe-zone","svg","aria-hidden","xmlns","ref","path","triangle","triangleDebug","id","rectDebug"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"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"}

package/lib/SafeZoneArea.styles.js

@@ -0,0 +1,34 @@
+import { __styles } from '@griffel/react';
+import { tokens } from '@fluentui/react-theme';
+export const useStyles = /*#__PURE__*/__styles({
+  wrapper: {
+    mc9l5x: "fjseox",
+    Bqenvij: "fniina8",
+    a9b677: "f3tsq5r",
+    Bkecrkj: "f1aehjj5"
+  },
+  wrapperActive: {
+    mc9l5x: "ftgm304"
+  },
+  svg: {
+    Bkfmm31: "f1au8mb3",
+    Bkecrkj: "f1aehjj5",
+    qhf8xq: "f19dog8a",
+    Bhzewxz: "f15twtuk",
+    oyh7mz: ["f1vgc2s3", "f1e31b4d"]
+  },
+  triangle: {
+    Bkecrkj: "f1cguypg"
+  },
+  triangleDebug: {
+    Bceei9c: "f7116n6",
+    Bkfmm31: "f1xab38x",
+    ojy3ng: "f1wle4v7",
+    Be5yapy: "f1t0ei4n"
+  },
+  rectDebug: {
+    Bkfmm31: "fyegryc"
+  }
+}, {
+  d: [".fjseox{display:none;}", ".fniina8{height:0;}", ".f3tsq5r{width:0;}", ".f1aehjj5{pointer-events:none;}", ".ftgm304{display:block;}", ".f1au8mb3{fill:transparent;}", ".f19dog8a{position:fixed;}", ".f15twtuk{top:0;}", ".f1vgc2s3{left:0;}", ".f1e31b4d{right:0;}", ".f1cguypg{pointer-events:auto;}", ".f7116n6{cursor:crosshair;}", ".f1xab38x{fill:color-mix(in srgb, var(--colorPaletteGreenBackground3) 20%, transparent);}", ".f1wle4v7{stroke:color-mix(in srgb, var(--colorPaletteGreenBackground3) 60%, transparent);}", ".f1t0ei4n{stroke-width:2px;}", ".fyegryc{fill:color-mix(in srgb, var(--colorPaletteRedBackground3) 20%, transparent);}"]
+});

package/lib/SafeZoneArea.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["__styles","tokens","useStyles","wrapper","mc9l5x","Bqenvij","a9b677","Bkecrkj","wrapperActive","svg","Bkfmm31","qhf8xq","Bhzewxz","oyh7mz","triangle","triangleDebug","Bceei9c","ojy3ng","Be5yapy","rectDebug","d"],"sources":["SafeZoneArea.styles.js"],"sourcesContent":["import { makeStyles } from '@griffel/react';\nimport { tokens } from '@fluentui/react-theme';\nexport const useStyles = makeStyles({\n    wrapper: {\n        display: 'none',\n        height: 0,\n        width: 0,\n        pointerEvents: 'none'\n    },\n    wrapperActive: {\n        display: 'block'\n    },\n    svg: {\n        fill: 'transparent',\n        pointerEvents: 'none',\n        position: 'fixed',\n        top: 0,\n        left: 0\n    },\n    triangle: {\n        pointerEvents: 'auto'\n    },\n    triangleDebug: {\n        cursor: 'crosshair',\n        fill: `color-mix(in srgb, ${tokens.colorPaletteGreenBackground3} 20%, transparent)`,\n        stroke: `color-mix(in srgb, ${tokens.colorPaletteGreenBackground3} 60%, transparent)`,\n        strokeWidth: '2px'\n    },\n    rectDebug: {\n        fill: `color-mix(in srgb, ${tokens.colorPaletteRedBackground3} 20%, transparent)`\n    }\n});\n"],"mappings":"AAAA,SAAAA,QAAA,QAA2B,gBAAgB;AAC3C,SAASC,MAAM,QAAQ,uBAAuB;AAC9C,OAAO,MAAMC,SAAS,gBAAGF,QAAA;EAAAG,OAAA;IAAAC,MAAA;IAAAC,OAAA;IAAAC,MAAA;IAAAC,OAAA;EAAA;EAAAC,aAAA;IAAAJ,MAAA;EAAA;EAAAK,GAAA;IAAAC,OAAA;IAAAH,OAAA;IAAAI,MAAA;IAAAC,OAAA;IAAAC,MAAA;EAAA;EAAAC,QAAA;IAAAP,OAAA;EAAA;EAAAQ,aAAA;IAAAC,OAAA;IAAAN,OAAA;IAAAO,MAAA;IAAAC,OAAA;EAAA;EAAAC,SAAA;IAAAT,OAAA;EAAA;AAAA;EAAAU,CAAA;AAAA,CA6BxB,CAAC","ignoreList":[]}

package/lib/index.js

@@ -4,4 +4,5 @@ export { createSlideStyles } from './createSlideStyles';
 export { PositioningConfigurationProvider } from './PositioningConfigurationContext';
 export { usePositioning } from './usePositioning';
 export { usePositioningMouseTarget } from './usePositioningMouseTarget';
+export { useSafeZoneArea } from './useSafeZoneArea';
 export { resolvePositioningShorthand, mergeArrowOffset } from './utils/index';

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { createVirtualElementFromClick } from './createVirtualElementFromClick';\nexport { createArrowHeightStyles, createArrowStyles } from './createArrowStyles';\nexport { createSlideStyles } from './createSlideStyles';\nexport type { CreateArrowStylesOptions } from './createArrowStyles';\n\nexport { PositioningConfigurationProvider } from './PositioningConfigurationContext';\n\nexport { usePositioning } from './usePositioning';\nexport { usePositioningMouseTarget } from './usePositioningMouseTarget';\nexport { resolvePositioningShorthand, mergeArrowOffset } from './utils/index';\n\nexport type {\n  Alignment,\n  AutoSize,\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  Boundary,\n  Offset,\n  OffsetFunction,\n  OffsetFunctionParam,\n  OffsetObject,\n  OffsetShorthand,\n  Position,\n  PositioningBoundary,\n  PositioningImperativeRef,\n  PositioningProps,\n  PositioningRect,\n  PositioningShorthand,\n  PositioningShorthandValue,\n  PositioningVirtualElement,\n  SetVirtualMouseTarget,\n  PositioningConfigurationFn,\n  PositioningConfigurationFnOptions,\n} from './types';\n"],"names":["createVirtualElementFromClick","createArrowHeightStyles","createArrowStyles","createSlideStyles","PositioningConfigurationProvider","usePositioning","usePositioningMouseTarget","resolvePositioningShorthand","mergeArrowOffset"],"rangeMappings":";;;;;;","mappings":"AAAA,SAASA,6BAA6B,QAAQ,kCAAkC;AAChF,SAASC,uBAAuB,EAAEC,iBAAiB,QAAQ,sBAAsB;AACjF,SAASC,iBAAiB,QAAQ,sBAAsB;AAGxD,SAASC,gCAAgC,QAAQ,oCAAoC;AAErF,SAASC,cAAc,QAAQ,mBAAmB;AAClD,SAASC,yBAAyB,QAAQ,8BAA8B;AACxE,SAASC,2BAA2B,EAAEC,gBAAgB,QAAQ,gBAAgB"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { createVirtualElementFromClick } from './createVirtualElementFromClick';\nexport { createArrowHeightStyles, createArrowStyles } from './createArrowStyles';\nexport { createSlideStyles } from './createSlideStyles';\nexport type { CreateArrowStylesOptions } from './createArrowStyles';\n\nexport { PositioningConfigurationProvider } from './PositioningConfigurationContext';\n\nexport { usePositioning } from './usePositioning';\nexport { usePositioningMouseTarget } from './usePositioningMouseTarget';\nexport { useSafeZoneArea } from './useSafeZoneArea';\nexport type { SafeBufferAreaOptions } from './useSafeZoneArea';\nexport { resolvePositioningShorthand, mergeArrowOffset } from './utils/index';\n\nexport type {\n  Alignment,\n  AutoSize,\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  Boundary,\n  Offset,\n  OffsetFunction,\n  OffsetFunctionParam,\n  OffsetObject,\n  OffsetShorthand,\n  Position,\n  PositioningBoundary,\n  PositioningImperativeRef,\n  PositioningProps,\n  PositioningRect,\n  PositioningShorthand,\n  PositioningShorthandValue,\n  PositioningVirtualElement,\n  SetVirtualMouseTarget,\n  PositioningConfigurationFn,\n  PositioningConfigurationFnOptions,\n} from './types';\n"],"names":["createVirtualElementFromClick","createArrowHeightStyles","createArrowStyles","createSlideStyles","PositioningConfigurationProvider","usePositioning","usePositioningMouseTarget","useSafeZoneArea","resolvePositioningShorthand","mergeArrowOffset"],"rangeMappings":";;;;;;;","mappings":"AAAA,SAASA,6BAA6B,QAAQ,kCAAkC;AAChF,SAASC,uBAAuB,EAAEC,iBAAiB,QAAQ,sBAAsB;AACjF,SAASC,iBAAiB,QAAQ,sBAAsB;AAGxD,SAASC,gCAAgC,QAAQ,oCAAoC;AAErF,SAASC,cAAc,QAAQ,mBAAmB;AAClD,SAASC,yBAAyB,QAAQ,8BAA8B;AACxE,SAASC,eAAe,QAAQ,oBAAoB;AAEpD,SAASC,2BAA2B,EAAEC,gBAAgB,QAAQ,gBAAgB"}

package/lib/useSafeZoneArea.js

@@ -0,0 +1,145 @@
+import { useFluent_unstable } from '@fluentui/react-shared-contexts';
+import { useEventCallback, useMergedRefs } from '@fluentui/react-utilities';
+import * as React from 'react';
+import { createSafeZoneAreaStateStore, SafeZoneArea } from './SafeZoneArea';
+import { parseFloatingUIPlacement } from './utils';
+export function useSafeZoneArea({ debug = false, disabled = false, onSafeZoneEnter, onSafeZoneMove, onSafeZoneLeave, onSafeZoneTimeout, timeout = 1500 } = {}) {
+    const [stateStore] = React.useState(createSafeZoneAreaStateStore);
+    const { targetDocument } = useFluent_unstable();
+    const safeZoneAreaRef = React.useRef(null);
+    const containerRef = React.useRef(null);
+    const targetRef = React.useRef(null);
+    const timeoutIdRef = React.useRef(null);
+    const mouseMoveIdRef = React.useRef(null);
+    const containerListenerRef = React.useMemo(()=>{
+        if (disabled) {
+            return ()=>{
+            // do nothing
+            };
+        }
+        let containerEl = null;
+        function onContainerMouseEnter() {
+            const targetWindow = targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.defaultView;
+            if (!targetWindow) {
+                return;
+            }
+            if (timeoutIdRef.current) {
+                targetWindow.clearTimeout(timeoutIdRef.current);
+                timeoutIdRef.current = null;
+            }
+            stateStore.toggleActive(false);
+        }
+        return (el)=>{
+            if (el === null) {
+                containerEl === null || containerEl === void 0 ? void 0 : containerEl.removeEventListener('mouseenter', onContainerMouseEnter);
+            }
+            containerEl = el;
+            el === null || el === void 0 ? void 0 : el.addEventListener('mouseenter', onContainerMouseEnter);
+        };
+    }, [
+        disabled,
+        stateStore,
+        targetDocument
+    ]);
+    const targetListenerRef = React.useMemo(()=>{
+        if (disabled) {
+            return ()=>{
+            // do nothing
+            };
+        }
+        let targetEl = null;
+        function onTargetMouseMove(e) {
+            const targetWindow = targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.defaultView;
+            if (!targetWindow) {
+                return;
+            }
+            if (timeoutIdRef.current) {
+                targetWindow.clearTimeout(timeoutIdRef.current);
+                timeoutIdRef.current = null;
+            }
+            if (!stateStore.isActive()) {
+                stateStore.toggleActive(true);
+            }
+            mouseMoveIdRef.current = targetWindow.requestAnimationFrame(()=>{
+                var _safeZoneAreaRef_current;
+                const containerEl = containerRef.current;
+                if (!containerEl || !targetEl) {
+                    return;
+                }
+                (_safeZoneAreaRef_current = safeZoneAreaRef.current) === null || _safeZoneAreaRef_current === void 0 ? void 0 : _safeZoneAreaRef_current.updateSVG({
+                    containerPlacementSide: parseFloatingUIPlacement(containerEl.dataset.popperPlacement).side,
+                    containerRect: containerEl.getBoundingClientRect(),
+                    mouseCoordinates: {
+                        x: e.clientX,
+                        y: e.clientY
+                    },
+                    targetRect: targetEl.getBoundingClientRect()
+                });
+            });
+        }
+        return (el)=>{
+            if (el === null) {
+                const targetWindow = targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.defaultView;
+                if (targetWindow) {
+                    if (mouseMoveIdRef.current) {
+                        targetWindow.cancelAnimationFrame(mouseMoveIdRef.current);
+                        mouseMoveIdRef.current = null;
+                    }
+                    if (timeoutIdRef.current) {
+                        targetWindow.clearTimeout(timeoutIdRef.current);
+                        timeoutIdRef.current = null;
+                    }
+                }
+                targetEl === null || targetEl === void 0 ? void 0 : targetEl.removeEventListener('mousemove', onTargetMouseMove);
+            }
+            targetEl = el;
+            el === null || el === void 0 ? void 0 : el.addEventListener('mousemove', onTargetMouseMove);
+        };
+    }, [
+        disabled,
+        stateStore,
+        targetDocument
+    ]);
+    const onSvgMouseEnter = useEventCallback((e)=>{
+        onSafeZoneEnter === null || onSafeZoneEnter === void 0 ? void 0 : onSafeZoneEnter(e);
+        const targetWindow = targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.defaultView;
+        if (!targetWindow) {
+            return;
+        }
+        if (timeoutIdRef.current) {
+            targetWindow.clearTimeout(timeoutIdRef.current);
+            timeoutIdRef.current = null;
+        }
+        // React 17 still uses pooled synthetic events
+        e.persist();
+        timeoutIdRef.current = targetWindow.setTimeout(()=>{
+            stateStore.toggleActive(false);
+            onSafeZoneTimeout === null || onSafeZoneTimeout === void 0 ? void 0 : onSafeZoneTimeout();
+        }, timeout);
+    });
+    const onSvgMouseMove = useEventCallback((e)=>{
+        onSafeZoneMove === null || onSafeZoneMove === void 0 ? void 0 : onSafeZoneMove(e);
+    });
+    const onSvgMouseLeave = useEventCallback((e)=>{
+        onSafeZoneLeave === null || onSafeZoneLeave === void 0 ? void 0 : onSafeZoneLeave(e);
+    });
+    return {
+        containerRef: useMergedRefs(containerRef, containerListenerRef),
+        targetRef: useMergedRefs(targetRef, targetListenerRef),
+        elementToRender: React.useMemo(()=>disabled ? null : /*#__PURE__*/ React.createElement(SafeZoneArea, {
+                debug: debug,
+                onMouseEnter: onSvgMouseEnter,
+                onMouseMove: onSvgMouseMove,
+                onMouseLeave: onSvgMouseLeave,
+                imperativeRef: safeZoneAreaRef,
+                stateStore: stateStore
+            }), [
+            disabled,
+            debug,
+            onSvgMouseEnter,
+            onSvgMouseMove,
+            onSvgMouseLeave,
+            stateStore
+        ])
+    };
+}