@fluentui/react-positioning 9.17.0 → 9.17.2

package/CHANGELOG.md

@@ -1,12 +1,30 @@
 # Change Log - @fluentui/react-positioning
 
-This log was last generated on Wed, 14 May 2025 18:45:47 GMT and should not be manually modified.
+This log was last generated on Wed, 11 Jun 2025 22:29:16 GMT and should not be manually modified.
 
 <!-- Start content -->
 
+## [9.17.2](https://github.com/microsoft/fluentui/tree/@fluentui/react-positioning_v9.17.2)
+
+Wed, 11 Jun 2025 22:29:16 GMT 
+[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-positioning_v9.17.1..@fluentui/react-positioning_v9.17.2)
+
+### Patches
+
+- feat: implement useSafeZoneArea() hook ([PR #34445](https://github.com/microsoft/fluentui/pull/34445) by olfedias@microsoft.com)
+
+## [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)
 
-Wed, 14 May 2025 18:45:47 GMT 
+Wed, 14 May 2025 18:49:18 GMT 
 [Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-positioning_v9.16.7..@fluentui/react-positioning_v9.17.0)
 
 ### Minor changes

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
+        ])
+    };
+}

package/lib/useSafeZoneArea.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useSafeZoneArea.tsx"],"sourcesContent":["import { useFluent_unstable } from '@fluentui/react-shared-contexts';\nimport { useEventCallback, useMergedRefs } from '@fluentui/react-utilities';\nimport type { Placement } from '@floating-ui/dom';\nimport * as React from 'react';\n\nimport { createSafeZoneAreaStateStore, type SafeZoneAreaImperativeHandle, SafeZoneArea } from './SafeZoneArea';\nimport { parseFloatingUIPlacement } from './utils';\n\nexport type SafeBufferAreaOptions = {\n  /** Enables debug mode: makes drawn shapes visible. */\n  debug?: boolean;\n\n  /** Disables the safe zone area. */\n  disabled?: boolean;\n\n  /** The time in milliseconds to wait before clearing the safe zone. */\n  timeout?: number;\n\n  /** Called when the mouse enters the safe zone. */\n  onSafeZoneEnter?: (e: React.MouseEvent) => void;\n\n  /** Called when the mouse moves within the safe zone. */\n  onSafeZoneMove?: (e: React.MouseEvent) => void;\n\n  /** Called when the mouse leaves the safe zone. */\n  onSafeZoneLeave?: (e: React.MouseEvent) => void;\n\n  /** Called when the safe zone times out, even if a cursor is still over a safe zone. */\n  onSafeZoneTimeout?: () => void;\n};\n\nexport function useSafeZoneArea({\n  debug = false,\n  disabled = false,\n\n  onSafeZoneEnter,\n  onSafeZoneMove,\n  onSafeZoneLeave,\n  onSafeZoneTimeout,\n\n  timeout = 1500,\n}: SafeBufferAreaOptions = {}) {\n  const [stateStore] = React.useState(createSafeZoneAreaStateStore);\n  const { targetDocument } = useFluent_unstable();\n\n  const safeZoneAreaRef = React.useRef<SafeZoneAreaImperativeHandle>(null);\n  const containerRef = React.useRef<HTMLElement>(null);\n  const targetRef = React.useRef<HTMLElement>(null);\n\n  const timeoutIdRef = React.useRef<number | null>(null);\n  const mouseMoveIdRef = React.useRef<number | null>(null);\n\n  const containerListenerRef = React.useMemo(() => {\n    if (disabled) {\n      return () => {\n        // do nothing\n      };\n    }\n\n    let containerEl: HTMLElement | null = null;\n\n    function onContainerMouseEnter() {\n      const targetWindow = targetDocument?.defaultView;\n\n      if (!targetWindow) {\n        return;\n      }\n\n      if (timeoutIdRef.current) {\n        targetWindow.clearTimeout(timeoutIdRef.current);\n        timeoutIdRef.current = null;\n      }\n\n      stateStore.toggleActive(false);\n    }\n\n    return (el: HTMLElement | null) => {\n      if (el === null) {\n        containerEl?.removeEventListener('mouseenter', onContainerMouseEnter);\n      }\n\n      containerEl = el;\n      el?.addEventListener('mouseenter', onContainerMouseEnter);\n    };\n  }, [disabled, stateStore, targetDocument]);\n\n  const targetListenerRef = React.useMemo(() => {\n    if (disabled) {\n      return () => {\n        // do nothing\n      };\n    }\n\n    let targetEl: HTMLElement | null = null;\n\n    function onTargetMouseMove(e: MouseEvent) {\n      const targetWindow = targetDocument?.defaultView;\n\n      if (!targetWindow) {\n        return;\n      }\n\n      if (timeoutIdRef.current) {\n        targetWindow.clearTimeout(timeoutIdRef.current);\n        timeoutIdRef.current = null;\n      }\n\n      if (!stateStore.isActive()) {\n        stateStore.toggleActive(true);\n      }\n\n      mouseMoveIdRef.current = targetWindow.requestAnimationFrame(() => {\n        const containerEl = containerRef.current;\n\n        if (!containerEl || !targetEl) {\n          return;\n        }\n\n        safeZoneAreaRef.current?.updateSVG({\n          containerPlacementSide: parseFloatingUIPlacement(containerEl.dataset.popperPlacement as Placement).side,\n          containerRect: containerEl.getBoundingClientRect(),\n          mouseCoordinates: { x: e.clientX, y: e.clientY },\n          targetRect: targetEl.getBoundingClientRect(),\n        });\n      });\n    }\n\n    return (el: HTMLElement | null) => {\n      if (el === null) {\n        const targetWindow = targetDocument?.defaultView;\n\n        if (targetWindow) {\n          if (mouseMoveIdRef.current) {\n            targetWindow.cancelAnimationFrame(mouseMoveIdRef.current);\n            mouseMoveIdRef.current = null;\n          }\n\n          if (timeoutIdRef.current) {\n            targetWindow.clearTimeout(timeoutIdRef.current);\n            timeoutIdRef.current = null;\n          }\n        }\n\n        targetEl?.removeEventListener('mousemove', onTargetMouseMove);\n      }\n\n      targetEl = el;\n      el?.addEventListener('mousemove', onTargetMouseMove);\n    };\n  }, [disabled, stateStore, targetDocument]);\n\n  const onSvgMouseEnter = useEventCallback((e: React.MouseEvent) => {\n    onSafeZoneEnter?.(e);\n\n    const targetWindow = targetDocument?.defaultView;\n\n    if (!targetWindow) {\n      return;\n    }\n\n    if (timeoutIdRef.current) {\n      targetWindow.clearTimeout(timeoutIdRef.current);\n      timeoutIdRef.current = null;\n    }\n\n    // React 17 still uses pooled synthetic events\n    e.persist();\n\n    timeoutIdRef.current = targetWindow.setTimeout(() => {\n      stateStore.toggleActive(false);\n      onSafeZoneTimeout?.();\n    }, timeout);\n  });\n\n  const onSvgMouseMove = useEventCallback((e: React.MouseEvent) => {\n    onSafeZoneMove?.(e);\n  });\n\n  const onSvgMouseLeave = useEventCallback((e: React.MouseEvent) => {\n    onSafeZoneLeave?.(e);\n  });\n\n  return {\n    containerRef: useMergedRefs(containerRef, containerListenerRef),\n    targetRef: useMergedRefs(targetRef, targetListenerRef),\n\n    elementToRender: React.useMemo(\n      () =>\n        disabled ? null : (\n          <SafeZoneArea\n            debug={debug}\n            onMouseEnter={onSvgMouseEnter}\n            onMouseMove={onSvgMouseMove}\n            onMouseLeave={onSvgMouseLeave}\n            imperativeRef={safeZoneAreaRef}\n            stateStore={stateStore}\n          />\n        ),\n      [disabled, debug, onSvgMouseEnter, onSvgMouseMove, onSvgMouseLeave, stateStore],\n    ),\n  };\n}\n"],"names":["useFluent_unstable","useEventCallback","useMergedRefs","React","createSafeZoneAreaStateStore","SafeZoneArea","parseFloatingUIPlacement","useSafeZoneArea","debug","disabled","onSafeZoneEnter","onSafeZoneMove","onSafeZoneLeave","onSafeZoneTimeout","timeout","stateStore","useState","targetDocument","safeZoneAreaRef","useRef","containerRef","targetRef","timeoutIdRef","mouseMoveIdRef","containerListenerRef","useMemo","containerEl","onContainerMouseEnter","targetWindow","defaultView","current","clearTimeout","toggleActive","el","removeEventListener","addEventListener","targetListenerRef","targetEl","onTargetMouseMove","e","isActive","requestAnimationFrame","updateSVG","containerPlacementSide","dataset","popperPlacement","side","containerRect","getBoundingClientRect","mouseCoordinates","x","clientX","y","clientY","targetRect","cancelAnimationFrame","onSvgMouseEnter","persist","setTimeout","onSvgMouseMove","onSvgMouseLeave","elementToRender","onMouseEnter","onMouseMove","onMouseLeave","imperativeRef"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"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"}