@fluentui/react-positioning 0.0.0-nightlyff78d1e27a20220217.1 → 0.0.0

package/dist/{react-positioning.d.ts → index.d.ts}

@@ -1,14 +1,14 @@
 import type { GriffelStyle } from '@griffel/react';
-import * as PopperJs from '@popperjs/core';
 import * as React_2 from 'react';
 
 export declare type Alignment = 'top' | 'bottom' | 'start' | 'end' | 'center';
 
 export declare type AutoSize = 'height' | 'height-always' | 'width' | 'width-always' | 'always' | boolean;
 
-export declare type Boundary = PopperJs.Boundary | 'scrollParent' | 'window';
+export declare type Boundary = HTMLElement | Array<HTMLElement> | 'clippingParents' | 'scrollParent' | 'window';
 
 /**
+ * @internal
  * Creates CSS styles to size the arrow created by createArrowStyles to the given height.
  *
  * Use this when you need to create classes for several different arrow sizes. If you only need a
@@ -20,6 +20,7 @@ export declare function createArrowHeightStyles(arrowHeight: number): {
 };
 
 /**
+ * @internal
  * Helper that creates a makeStyles rule for an arrow element.
  * For runtime arrow size toggling simply create extra classnames to apply to the arrow element
  *
@@ -44,6 +45,7 @@ export declare function createArrowHeightStyles(arrowHeight: number): {
 export declare function createArrowStyles(options: CreateArrowStylesOptions): GriffelStyle;
 
 /**
+ * @internal
  * Options parameter for the createArrowStyles function
  */
 export declare type CreateArrowStylesOptions = {
@@ -78,9 +80,10 @@ export declare type CreateArrowStylesOptions = {
  * Creates a virtual element based on the position of a click event
  * Can be used as a target for popper in scenarios such as context menus
  */
-export declare function createVirtualElementFromClick(nativeEvent: MouseEvent): PopperVirtualElement;
+export declare function createVirtualElementFromClick(nativeEvent: MouseEvent): PositioningVirtualElement;
 
 /**
+ * @internal
  * Generally when adding an arrow to popper, it's necessary to offset the position of the popper by the
  * height of the arrow. A simple utility to merge a provided offset with an arrow height to return the final offset
  *
@@ -90,22 +93,45 @@ export declare function createVirtualElementFromClick(nativeEvent: MouseEvent):
  */
 export declare function mergeArrowOffset(userOffset: Offset | undefined | null, arrowHeight: number): Offset;
 
-export declare type Offset = OffsetFunction | [number | null | undefined, number | null | undefined];
+export declare type Offset = OffsetFunction | OffsetObject | OffsetShorthand;
 
-export declare type OffsetFunction = (param: OffsetFunctionParam) => [number | null | undefined, number | null | undefined];
+export declare type OffsetFunction = (param: OffsetFunctionParam) => OffsetObject | OffsetShorthand;
 
 export declare type OffsetFunctionParam = {
-    popper: PopperJs.Rect;
-    reference: PopperJs.Rect;
-    placement: PopperJs.Placement;
+    positionedRect: Rect;
+    targetRect: Rect;
+    position: Position;
+    alignment?: Alignment;
 };
 
-export declare interface PopperOptions {
+export declare type OffsetObject = {
+    crossAxis?: number;
+    mainAxis: number;
+};
+
+export declare type OffsetShorthand = number;
+
+export declare type Position = 'above' | 'below' | 'before' | 'after';
+
+export declare type PositioningImperativeRef = {
+    /**
+     * Updates the position imperatively.
+     * Useful when the position of the target changes from other factors than scrolling of window resize.
+     */
+    updatePosition: () => void;
+    /**
+     * Sets the target and updates positioning imperatively.
+     * Useful for avoiding double renders with the target option.
+     */
+    setTarget: (target: HTMLElement | PositioningVirtualElement) => void;
+};
+
+declare interface PositioningOptions {
     /** Alignment for the component. Only has an effect if used with the @see position option */
     align?: Alignment;
-    /** The element which will define the boundaries of the popper position for the flip behavior. */
+    /** The element which will define the boundaries of the positioned element for the flip behavior. */
     flipBoundary?: Boundary;
-    /** The element which will define the boundaries of the popper position for the overflow behavior. */
+    /** The element which will define the boundaries of the positioned element for the overflow behavior. */
     overflowBoundary?: Boundary;
     /**
      * Position for the component. Position has higher priority than align. If position is vertical ('above' | 'below')
@@ -115,12 +141,12 @@ export declare interface PopperOptions {
      */
     position?: Position;
     /**
-     * Enables the Popper box to position itself in 'fixed' mode (default value is position: 'absolute')
+     * Enables the position element to be positioned with 'fixed' (default value is position: 'absolute')
      * @default false
      */
     positionFixed?: boolean;
     /**
-     * Lets you displace a popper element from its reference element.
+     * Lets you displace a positioned element from its reference element.
      * This can be useful if you need to apply some margin between them or if you need to fine tune the
      * position according to some custom logic.
      */
@@ -131,7 +157,7 @@ export declare interface PopperOptions {
      */
     arrowPadding?: number;
     /**
-     * Applies max-height and max-width on popper to fit it within the available space in viewport.
+     * Applies max-height and max-width on the positioned element to fit it within the available space in viewport.
      * true enables this for both width and height when overflow happens.
      * 'always' applies `max-height`/`max-width` regardless of overflow.
      * 'height' applies `max-height` when overflow happens, and 'width' for `max-width`
@@ -148,45 +174,58 @@ export declare interface PopperOptions {
      */
     pinned?: boolean;
     /**
-     * When the reference element or the viewport is outside viewport allows a popper element to be fully in viewport.
+     * When the reference element or the viewport is outside viewport allows a positioned element to be fully in viewport.
      * "all" enables this behavior for all axis.
      */
     unstable_disableTether?: boolean | 'all';
 }
 
-export declare type PopperRefHandle = {
-    /**
-     * Updates the position of the popper imperatively.
-     * Useful when the position of the target changes from other factors than scrolling of window resize.
-     */
-    updatePosition: () => void;
-    /**
-     * Sets the target and updates positioning imperatively.
-     * Useful for avoiding double renders with the target option.
-     */
-    setTarget: (target: HTMLElement) => void;
-};
-
-export declare type PopperVirtualElement = PopperJs.VirtualElement;
-
-export declare type Position = 'above' | 'below' | 'before' | 'after';
-
-export declare interface PositioningProps extends Omit<PopperOptions, 'positionFixed' | 'unstable_disableTether'> {
+export declare interface PositioningProps extends Omit<PositioningOptions, 'positionFixed' | 'unstable_disableTether'> {
     /** An imperative handle to Popper methods. */
-    popperRef?: React_2.Ref<PopperRefHandle>;
+    positioningRef?: React_2.Ref<PositioningImperativeRef>;
     /**
-     * Manual override for popper target. Useful for scenarios where a component accepts user prop to override target
+     * Manual override for the target element. Useful for scenarios where a component accepts user prop to override target
      */
-    target?: HTMLElement | PopperVirtualElement | null;
+    target?: HTMLElement | PositioningVirtualElement | null;
 }
 
 export declare type PositioningShorthand = PositioningProps | PositioningShorthandValue;
 
 export declare type PositioningShorthandValue = 'above' | 'above-start' | 'above-end' | 'below' | 'below-start' | 'below-end' | 'before' | 'before-top' | 'before-bottom' | 'after' | 'after-top' | 'after-bottom';
 
+export declare type PositioningVirtualElement = {
+    getBoundingClientRect: () => {
+        x: number;
+        y: number;
+        top: number;
+        left: number;
+        bottom: number;
+        right: number;
+        width: number;
+        height: number;
+    };
+    contextElement?: Element;
+};
+
+declare type Rect = {
+    width: number;
+    height: number;
+    x: number;
+    y: number;
+};
+
 export declare function resolvePositioningShorthand(shorthand: PositioningShorthand | undefined | null): Readonly<PositioningProps>;
 
+declare interface UsePopperOptions extends PositioningProps {
+    /**
+     * If false, delays Popper's creation.
+     * @default true
+     */
+    enabled?: boolean;
+}
+
 /**
+ * @internal
  * Exposes Popper positioning API via React hook. Contains few important differences between an official "react-popper"
  * package:
  * - style attributes are applied directly on DOM to avoid re-renders
@@ -194,13 +233,14 @@ export declare function resolvePositioningShorthand(shorthand: PositioningShorth
  * - contains a specific to React fix related to initial positioning when containers have components with managed focus
  *   to avoid focus jumps
  */
-export declare function usePopper(options?: UsePopperOptions): {
+export declare function usePositioning(options?: UsePopperOptions): {
     targetRef: React_2.MutableRefObject<any>;
     containerRef: React_2.MutableRefObject<any>;
     arrowRef: React_2.MutableRefObject<any>;
 };
 
 /**
+ * @internal
  * A state hook that manages a popper virtual element from mouseevents.
  * Useful for scenarios where a component needs to be positioned by mouse click (e.g. contextmenu)
  * React synthetic events are not persisted by this hook
@@ -208,14 +248,6 @@ export declare function usePopper(options?: UsePopperOptions): {
  * @param initialState - initializes a user provided state similare to useState
  * @returns state and dispatcher for a Popper virtual element that uses native/synthetic mouse events
  */
-export declare const usePopperMouseTarget: (initialState?: PopperJs.VirtualElement | (() => PopperJs.VirtualElement) | undefined) => readonly [PopperJs.VirtualElement | undefined, (event: React_2.MouseEvent | MouseEvent | undefined | null) => void];
-
-declare interface UsePopperOptions extends PositioningProps {
-    /**
-     * If false, delays Popper's creation.
-     * @default true
-     */
-    enabled?: boolean;
-}
+export declare const usePositioningMouseTarget: (initialState?: PositioningVirtualElement | (() => PositioningVirtualElement) | undefined) => readonly [PositioningVirtualElement | undefined, (event: React_2.MouseEvent | MouseEvent | undefined | null) => void];
 
 export { }

package/lib/createArrowStyles.js

@@ -1,6 +1,7 @@
 import { shorthands } from '@griffel/react';
 import { tokens } from '@fluentui/react-theme';
 /**
+ * @internal
  * Helper that creates a makeStyles rule for an arrow element.
  * For runtime arrow size toggling simply create extra classnames to apply to the arrow element
  *
@@ -36,7 +37,7 @@ export function createArrowStyles(options) {
     visibility: 'hidden',
     zIndex: -1,
     ...(arrowHeight && createArrowHeightStyles(arrowHeight)),
-    ':before': {
+    '::before': {
       content: '""',
       visibility: 'visible',
       position: 'absolute',
@@ -69,6 +70,7 @@ export function createArrowStyles(options) {
   };
 }
 /**
+ * @internal
  * Creates CSS styles to size the arrow created by createArrowStyles to the given height.
  *
  * Use this when you need to create classes for several different arrow sizes. If you only need a

package/lib/createArrowStyles.js.map

@@ -1 +1 @@
-{"version":3,"sources":["createArrowStyles.ts"],"names":[],"mappings":"AAAA,SAAS,UAAT,QAA2B,gBAA3B;AACA,SAAS,MAAT,QAAuB,uBAAvB;AAqCA;;;;;;;;;;;;;;;;;;;;;AAqBG;;AACH,OAAM,SAAU,iBAAV,CAA4B,OAA5B,EAA6D;AACjE,QAAM;AACJ,IAAA,WADI;AAEJ,IAAA,WAAW,GAAG,KAFV;AAGJ,IAAA,WAAW,GAAG,OAHV;AAIJ,IAAA,WAAW,GAAG,MAAM,CAAC;AAJjB,MAKF,OALJ;AAOA,SAAO;AACL,IAAA,QAAQ,EAAE,UADL;AAEL,IAAA,eAAe,EAAE,SAFZ;AAGL,IAAA,UAAU,EAAE,QAHP;AAIL,IAAA,MAAM,EAAE,CAAC,CAJJ;AAML,QAAI,WAAW,IAAI,uBAAuB,CAAC,WAAD,CAA1C,CANK;AAQL,eAAW;AACT,MAAA,OAAO,EAAE,IADA;AAET,MAAA,UAAU,EAAE,SAFH;AAGT,MAAA,QAAQ,EAAE,UAHD;AAIT,MAAA,SAAS,EAAE,YAJF;AAKT,MAAA,KAAK,EAAE,SALE;AAMT,MAAA,MAAM,EAAE,SANC;AAOT,MAAA,eAAe,EAAE,SAPR;AAQT,SAAG,UAAU,CAAC,WAAX,CACD,GAAG,WAAW,gBADb,EAED,GAAG,WAAW,gBAFb,EAGD,GAAG,WAAW,gBAHb,CARM;AAaT,SAAG,UAAU,CAAC,YAAX,CAAwB,WAAxB,EAAqC,WAArC,EAAkD,WAAlD,CAbM;AAcT,MAAA,uBAAuB,EAAE,MAAM,CAAC,iBAdvB;AAeT,MAAA,SAAS,EAAE;AAfF,KARN;AA0BL;AACA,+CAA2C;AACzC,MAAA,MAAM,EAAE,IAAI,WAAW,EADkB;AAEzC,iBAAW;AAF8B,KA3BtC;AA+BL,iDAA6C;AAC3C,MAAA,IAAI,EAAE,IAAI,WAAW,gBADsB;AAE3C,iBAAW;AAFgC,KA/BxC;AAmCL,kDAA8C;AAC5C,MAAA,GAAG,EAAE,IAAI,WAAW,EADwB;AAE5C,iBAAW;AAFiC,KAnCzC;AAuCL,gDAA4C;AAC1C,MAAA,KAAK,EAAE,IAAI,WAAW,gBADoB;AAE1C,iBAAW;AAF+B;AAvCvC,GAAP;AA4CD;AAED;;;;;AAKG;;AACH,OAAM,SAAU,uBAAV,CAAkC,WAAlC,EAAqD;AACzD;AACA;AACA,QAAM,UAAU,GAAG,GAAG,QAAQ,WAAW,IAAzC;AACA,SAAO;AAAE,IAAA,KAAK,EAAE,UAAT;AAAqB,IAAA,MAAM,EAAE;AAA7B,GAAP;AACD","sourcesContent":["import { shorthands } from '@griffel/react';\nimport { tokens } from '@fluentui/react-theme';\nimport type { GriffelStyle } from '@griffel/react';\n\n/**\n * Options parameter for the createArrowStyles function\n */\nexport type CreateArrowStylesOptions = {\n  /**\n   * The height of the arrow from the base to the tip, in px. The base width of the arrow is always twice its height.\n   *\n   * This can be undefined to leave out the arrow size styles. You must then add styles created by\n   * createArrowHeightStyles to set the arrow's size correctly. This can be useful if the arrow can be different sizes.\n   */\n  arrowHeight: number | undefined;\n\n  /**\n   * The borderWidth of the arrow. Should be the same borderWidth as the parent element.\n   *\n   * @defaultvalue 1px\n   */\n  borderWidth?: GriffelStyle['borderBottomWidth'];\n\n  /**\n   * The borderStyle for the arrow. Should be the same borderStyle as the parent element.\n   *\n   * @defaultvalue solid\n   */\n  borderStyle?: GriffelStyle['borderBottomStyle'];\n\n  /**\n   * The borderColor of the arrow. Should be the same borderColor as the parent element.\n   *\n   * @defaultvalue tokens.colorTransparentStroke\n   */\n  borderColor?: GriffelStyle['borderBottomColor'];\n};\n\n/**\n * Helper that creates a makeStyles rule for an arrow element.\n * For runtime arrow size toggling simply create extra classnames to apply to the arrow element\n *\n * ```ts\n *   makeStyles({\n *     arrowWithSize: createArrowStyles({ arrowHeight: 6 }),\n *\n *     arrowWithoutSize: createArrowStyles({ arrowHeight: undefined }),\n *     mediumArrow: createArrowHeightStyles(4),\n *     smallArrow: createArrowHeightStyles(2),\n *   })\n *   ...\n *\n *   state.arrowWithSize.className = styles.arrowWithSize;\n *   state.arrowWithoutSize.className = mergeClasses(\n *     styles.arrowWithoutSize,\n *     state.smallArrow && styles.smallArrow,\n *     state.mediumArrow && styles.mediumArrow,\n *   )\n * ```\n */\nexport function createArrowStyles(options: CreateArrowStylesOptions): GriffelStyle {\n  const {\n    arrowHeight,\n    borderWidth = '1px',\n    borderStyle = 'solid',\n    borderColor = tokens.colorTransparentStroke,\n  } = options;\n\n  return {\n    position: 'absolute',\n    backgroundColor: 'inherit',\n    visibility: 'hidden',\n    zIndex: -1,\n\n    ...(arrowHeight && createArrowHeightStyles(arrowHeight)),\n\n    ':before': {\n      content: '\"\"',\n      visibility: 'visible',\n      position: 'absolute',\n      boxSizing: 'border-box',\n      width: 'inherit',\n      height: 'inherit',\n      backgroundColor: 'inherit',\n      ...shorthands.borderRight(\n        `${borderWidth} /* @noflip */`,\n        `${borderStyle} /* @noflip */`,\n        `${borderColor} /* @noflip */`,\n      ),\n      ...shorthands.borderBottom(borderWidth, borderStyle, borderColor),\n      borderBottomRightRadius: tokens.borderRadiusSmall,\n      transform: 'rotate(var(--angle)) translate(0, 50%) rotate(45deg)',\n    },\n\n    // Popper sets data-popper-placement on the root element, which is used to align the arrow\n    ':global([data-popper-placement^=\"top\"])': {\n      bottom: `-${borderWidth}`,\n      '--angle': '0',\n    },\n    ':global([data-popper-placement^=\"right\"])': {\n      left: `-${borderWidth} /* @noflip */`,\n      '--angle': '90deg',\n    },\n    ':global([data-popper-placement^=\"bottom\"])': {\n      top: `-${borderWidth}`,\n      '--angle': '180deg',\n    },\n    ':global([data-popper-placement^=\"left\"])': {\n      right: `-${borderWidth} /* @noflip */`,\n      '--angle': '270deg',\n    },\n  };\n}\n\n/**\n * Creates CSS styles to size the arrow created by createArrowStyles to the given height.\n *\n * Use this when you need to create classes for several different arrow sizes. If you only need a\n * constant arrow size, you can pass the `arrowHeight` param to createArrowStyles instead.\n */\nexport function createArrowHeightStyles(arrowHeight: number) {\n  // The arrow is a square rotated 45 degrees to have its bottom and right edges form a right triangle.\n  // Multiply the triangle's height by sqrt(2) to get length of its edges.\n  const edgeLength = `${1.414 * arrowHeight}px`;\n  return { width: edgeLength, height: edgeLength };\n}\n"],"sourceRoot":"../src/"}
+{"version":3,"sources":["createArrowStyles.ts"],"names":[],"mappings":"AAAA,SAAS,UAAT,QAA2B,gBAA3B;AACA,SAAS,MAAT,QAAuB,uBAAvB;AAsCA;;;;;;;;;;;;;;;;;;;;;;AAsBG;;AACH,OAAM,SAAU,iBAAV,CAA4B,OAA5B,EAA6D;EACjE,MAAM;IACJ,WADI;IAEJ,WAAW,GAAG,KAFV;IAGJ,WAAW,GAAG,OAHV;IAIJ,WAAW,GAAG,MAAM,CAAC;EAJjB,IAKF,OALJ;EAOA,OAAO;IACL,QAAQ,EAAE,UADL;IAEL,eAAe,EAAE,SAFZ;IAGL,UAAU,EAAE,QAHP;IAIL,MAAM,EAAE,CAAC,CAJJ;IAML,IAAI,WAAW,IAAI,uBAAuB,CAAC,WAAD,CAA1C,CANK;IAQL,YAAY;MACV,OAAO,EAAE,IADC;MAEV,UAAU,EAAE,SAFF;MAGV,QAAQ,EAAE,UAHA;MAIV,SAAS,EAAE,YAJD;MAKV,KAAK,EAAE,SALG;MAMV,MAAM,EAAE,SANE;MAOV,eAAe,EAAE,SAPP;MAQV,GAAG,UAAU,CAAC,WAAX,CACD,GAAG,WAAW,gBADb,EAED,GAAG,WAAW,gBAFb,EAGD,GAAG,WAAW,gBAHb,CARO;MAaV,GAAG,UAAU,CAAC,YAAX,CAAwB,WAAxB,EAAqC,WAArC,EAAkD,WAAlD,CAbO;MAcV,uBAAuB,EAAE,MAAM,CAAC,iBAdtB;MAeV,SAAS,EAAE;IAfD,CARP;IA0BL;IACA,2CAA2C;MACzC,MAAM,EAAE,IAAI,WAAW,EADkB;MAEzC,WAAW;IAF8B,CA3BtC;IA+BL,6CAA6C;MAC3C,IAAI,EAAE,IAAI,WAAW,gBADsB;MAE3C,WAAW;IAFgC,CA/BxC;IAmCL,8CAA8C;MAC5C,GAAG,EAAE,IAAI,WAAW,EADwB;MAE5C,WAAW;IAFiC,CAnCzC;IAuCL,4CAA4C;MAC1C,KAAK,EAAE,IAAI,WAAW,gBADoB;MAE1C,WAAW;IAF+B;EAvCvC,CAAP;AA4CD;AAED;;;;;;AAMG;;AACH,OAAM,SAAU,uBAAV,CAAkC,WAAlC,EAAqD;EACzD;EACA;EACA,MAAM,UAAU,GAAG,GAAG,QAAQ,WAAW,IAAzC;EACA,OAAO;IAAE,KAAK,EAAE,UAAT;IAAqB,MAAM,EAAE;EAA7B,CAAP;AACD","sourcesContent":["import { shorthands } from '@griffel/react';\nimport { tokens } from '@fluentui/react-theme';\nimport type { GriffelStyle } from '@griffel/react';\n\n/**\n * @internal\n * Options parameter for the createArrowStyles function\n */\nexport type CreateArrowStylesOptions = {\n  /**\n   * The height of the arrow from the base to the tip, in px. The base width of the arrow is always twice its height.\n   *\n   * This can be undefined to leave out the arrow size styles. You must then add styles created by\n   * createArrowHeightStyles to set the arrow's size correctly. This can be useful if the arrow can be different sizes.\n   */\n  arrowHeight: number | undefined;\n\n  /**\n   * The borderWidth of the arrow. Should be the same borderWidth as the parent element.\n   *\n   * @defaultvalue 1px\n   */\n  borderWidth?: GriffelStyle['borderBottomWidth'];\n\n  /**\n   * The borderStyle for the arrow. Should be the same borderStyle as the parent element.\n   *\n   * @defaultvalue solid\n   */\n  borderStyle?: GriffelStyle['borderBottomStyle'];\n\n  /**\n   * The borderColor of the arrow. Should be the same borderColor as the parent element.\n   *\n   * @defaultvalue tokens.colorTransparentStroke\n   */\n  borderColor?: GriffelStyle['borderBottomColor'];\n};\n\n/**\n * @internal\n * Helper that creates a makeStyles rule for an arrow element.\n * For runtime arrow size toggling simply create extra classnames to apply to the arrow element\n *\n * ```ts\n *   makeStyles({\n *     arrowWithSize: createArrowStyles({ arrowHeight: 6 }),\n *\n *     arrowWithoutSize: createArrowStyles({ arrowHeight: undefined }),\n *     mediumArrow: createArrowHeightStyles(4),\n *     smallArrow: createArrowHeightStyles(2),\n *   })\n *   ...\n *\n *   state.arrowWithSize.className = styles.arrowWithSize;\n *   state.arrowWithoutSize.className = mergeClasses(\n *     styles.arrowWithoutSize,\n *     state.smallArrow && styles.smallArrow,\n *     state.mediumArrow && styles.mediumArrow,\n *   )\n * ```\n */\nexport function createArrowStyles(options: CreateArrowStylesOptions): GriffelStyle {\n  const {\n    arrowHeight,\n    borderWidth = '1px',\n    borderStyle = 'solid',\n    borderColor = tokens.colorTransparentStroke,\n  } = options;\n\n  return {\n    position: 'absolute',\n    backgroundColor: 'inherit',\n    visibility: 'hidden',\n    zIndex: -1,\n\n    ...(arrowHeight && createArrowHeightStyles(arrowHeight)),\n\n    '::before': {\n      content: '\"\"',\n      visibility: 'visible',\n      position: 'absolute',\n      boxSizing: 'border-box',\n      width: 'inherit',\n      height: 'inherit',\n      backgroundColor: 'inherit',\n      ...shorthands.borderRight(\n        `${borderWidth} /* @noflip */`,\n        `${borderStyle} /* @noflip */`,\n        `${borderColor} /* @noflip */`,\n      ),\n      ...shorthands.borderBottom(borderWidth, borderStyle, borderColor),\n      borderBottomRightRadius: tokens.borderRadiusSmall,\n      transform: 'rotate(var(--angle)) translate(0, 50%) rotate(45deg)',\n    },\n\n    // Popper sets data-popper-placement on the root element, which is used to align the arrow\n    ':global([data-popper-placement^=\"top\"])': {\n      bottom: `-${borderWidth}`,\n      '--angle': '0',\n    },\n    ':global([data-popper-placement^=\"right\"])': {\n      left: `-${borderWidth} /* @noflip */`,\n      '--angle': '90deg',\n    },\n    ':global([data-popper-placement^=\"bottom\"])': {\n      top: `-${borderWidth}`,\n      '--angle': '180deg',\n    },\n    ':global([data-popper-placement^=\"left\"])': {\n      right: `-${borderWidth} /* @noflip */`,\n      '--angle': '270deg',\n    },\n  };\n}\n\n/**\n * @internal\n * Creates CSS styles to size the arrow created by createArrowStyles to the given height.\n *\n * Use this when you need to create classes for several different arrow sizes. If you only need a\n * constant arrow size, you can pass the `arrowHeight` param to createArrowStyles instead.\n */\nexport function createArrowHeightStyles(arrowHeight: number) {\n  // The arrow is a square rotated 45 degrees to have its bottom and right edges form a right triangle.\n  // Multiply the triangle's height by sqrt(2) to get length of its edges.\n  const edgeLength = `${1.414 * arrowHeight}px`;\n  return { width: edgeLength, height: edgeLength };\n}\n"],"sourceRoot":"../src/"}

package/lib/createVirtualElementFromClick.js

@@ -14,6 +14,8 @@ export function createVirtualElementFromClick(nativeEvent) {
       top,
       right,
       bottom,
+      x: left,
+      y: top,
       height: 1,
       width: 1
     };

package/lib/createVirtualElementFromClick.js.map

@@ -1 +1 @@
-{"version":3,"sources":["createVirtualElementFromClick.ts"],"names":[],"mappings":"AAEA;;;AAGG;AACH,OAAM,SAAU,6BAAV,CAAwC,WAAxC,EAA+D;AACnE,QAAM,IAAI,GAAG,WAAW,CAAC,OAAzB;AACA,QAAM,GAAG,GAAG,WAAW,CAAC,OAAxB;AACA,QAAM,KAAK,GAAG,IAAI,GAAG,CAArB;AACA,QAAM,MAAM,GAAG,GAAG,GAAG,CAArB;;AAEA,WAAS,qBAAT,GAA8B;AAC5B,WAAO;AACL,MAAA,IADK;AAEL,MAAA,GAFK;AAGL,MAAA,KAHK;AAIL,MAAA,MAJK;AAML,MAAA,MAAM,EAAE,CANH;AAOL,MAAA,KAAK,EAAE;AAPF,KAAP;AASD;;AAED,SAAO;AACL,IAAA;AADK,GAAP;AAGD","sourcesContent":["import type { PopperVirtualElement } from './types';\n\n/**\n * Creates a virtual element based on the position of a click event\n * Can be used as a target for popper in scenarios such as context menus\n */\nexport function createVirtualElementFromClick(nativeEvent: MouseEvent): PopperVirtualElement {\n  const left = nativeEvent.clientX;\n  const top = nativeEvent.clientY;\n  const right = left + 1;\n  const bottom = top + 1;\n\n  function getBoundingClientRect(): ClientRect {\n    return {\n      left,\n      top,\n      right,\n      bottom,\n\n      height: 1,\n      width: 1,\n    };\n  }\n\n  return {\n    getBoundingClientRect,\n  };\n}\n"],"sourceRoot":"../src/"}
+{"version":3,"sources":["createVirtualElementFromClick.ts"],"names":[],"mappings":"AAEA;;;AAGG;AACH,OAAM,SAAU,6BAAV,CAAwC,WAAxC,EAA+D;EACnE,MAAM,IAAI,GAAG,WAAW,CAAC,OAAzB;EACA,MAAM,GAAG,GAAG,WAAW,CAAC,OAAxB;EACA,MAAM,KAAK,GAAG,IAAI,GAAG,CAArB;EACA,MAAM,MAAM,GAAG,GAAG,GAAG,CAArB;;EAEA,SAAS,qBAAT,GAA8B;IAC5B,OAAO;MACL,IADK;MAEL,GAFK;MAGL,KAHK;MAIL,MAJK;MAKL,CAAC,EAAE,IALE;MAML,CAAC,EAAE,GANE;MAOL,MAAM,EAAE,CAPH;MAQL,KAAK,EAAE;IARF,CAAP;EAUD;;EAED,OAAO;IACL;EADK,CAAP;AAGD","sourcesContent":["import type { PositioningVirtualElement } from './types';\n\n/**\n * Creates a virtual element based on the position of a click event\n * Can be used as a target for popper in scenarios such as context menus\n */\nexport function createVirtualElementFromClick(nativeEvent: MouseEvent): PositioningVirtualElement {\n  const left = nativeEvent.clientX;\n  const top = nativeEvent.clientY;\n  const right = left + 1;\n  const bottom = top + 1;\n\n  function getBoundingClientRect() {\n    return {\n      left,\n      top,\n      right,\n      bottom,\n      x: left,\n      y: top,\n      height: 1,\n      width: 1,\n    };\n  }\n\n  return {\n    getBoundingClientRect,\n  };\n}\n"],"sourceRoot":"../src/"}

package/lib/index.js

@@ -1,7 +1,6 @@
-export * from './createVirtualElementFromClick';
-export * from './createArrowStyles';
-export * from './usePopper';
-export * from './usePopperMouseTarget';
+export { createVirtualElementFromClick } from './createVirtualElementFromClick';
+export { createArrowHeightStyles, createArrowStyles } from './createArrowStyles';
+export { usePositioning } from './usePositioning';
+export { usePositioningMouseTarget } from './usePositioningMouseTarget';
 export { resolvePositioningShorthand, mergeArrowOffset } from './utils/index';
-export * from './types';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"../src/","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC9E,cAAc,SAAS,CAAC","sourcesContent":["export * from './createVirtualElementFromClick';\nexport * from './createArrowStyles';\nexport * from './usePopper';\nexport * from './usePopperMouseTarget';\nexport { resolvePositioningShorthand, mergeArrowOffset } from './utils/index';\nexport * from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"../src/","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC","sourcesContent":["export { createVirtualElementFromClick } from './createVirtualElementFromClick';\nexport { createArrowHeightStyles, createArrowStyles } from './createArrowStyles';\nexport type { CreateArrowStylesOptions } from './createArrowStyles';\nexport { usePositioning } from './usePositioning';\nexport { usePositioningMouseTarget } from './usePositioningMouseTarget';\nexport { resolvePositioningShorthand, mergeArrowOffset } from './utils/index';\nexport type {\n  Alignment,\n  AutoSize,\n  Boundary,\n  Offset,\n  OffsetFunction,\n  OffsetFunctionParam,\n  OffsetObject,\n  OffsetShorthand,\n  Position,\n  PositioningImperativeRef,\n  PositioningProps,\n  PositioningShorthand,\n  PositioningShorthandValue,\n  PositioningVirtualElement,\n} from './types';\n"]}

package/lib/isIntersectingModifier.js

@@ -0,0 +1,26 @@
+import { detectOverflow } from '@popperjs/core';
+export const isIntersectingModifier = {
+  name: 'is-intersecting-modifier',
+  enabled: true,
+  phase: 'main',
+  requires: ['preventOverflow'],
+  fn: ({
+    state,
+    name
+  }) => {
+    const popperRect = state.rects.popper;
+    const popperAltOverflow = detectOverflow(state, {
+      altBoundary: true
+    });
+    const isIntersectingTop = popperAltOverflow.top < popperRect.height && popperAltOverflow.top > 0;
+    const isIntersectingBottom = popperAltOverflow.bottom < popperRect.height && popperAltOverflow.bottom > 0;
+    const isIntersecting = isIntersectingTop || isIntersectingBottom;
+    state.modifiersData[name] = {
+      isIntersecting
+    };
+    state.attributes.popper = { ...state.attributes.popper,
+      'data-popper-is-intersecting': isIntersecting
+    };
+  }
+};
+//# sourceMappingURL=isIntersectingModifier.js.map

package/lib/isIntersectingModifier.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["isIntersectingModifier.ts"],"names":[],"mappings":"AAAA,SAAS,cAAT,QAAyC,gBAAzC;AAEA,OAAO,MAAM,sBAAsB,GAA2B;EAC5D,IAAI,EAAE,0BADsD;EAE5D,OAAO,EAAE,IAFmD;EAG5D,KAAK,EAAE,MAHqD;EAI5D,QAAQ,EAAE,CAAC,iBAAD,CAJkD;EAK5D,EAAE,EAAE,CAAC;IAAE,KAAF;IAAS;EAAT,CAAD,KAAoB;IACtB,MAAM,UAAU,GAAG,KAAK,CAAC,KAAN,CAAY,MAA/B;IACA,MAAM,iBAAiB,GAAG,cAAc,CAAC,KAAD,EAAQ;MAAE,WAAW,EAAE;IAAf,CAAR,CAAxC;IAEA,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,GAAlB,GAAwB,UAAU,CAAC,MAAnC,IAA6C,iBAAiB,CAAC,GAAlB,GAAwB,CAA/F;IACA,MAAM,oBAAoB,GAAG,iBAAiB,CAAC,MAAlB,GAA2B,UAAU,CAAC,MAAtC,IAAgD,iBAAiB,CAAC,MAAlB,GAA2B,CAAxG;IAEA,MAAM,cAAc,GAAG,iBAAiB,IAAI,oBAA5C;IAEA,KAAK,CAAC,aAAN,CAAoB,IAApB,IAA4B;MAC1B;IAD0B,CAA5B;IAGA,KAAK,CAAC,UAAN,CAAiB,MAAjB,GAA0B,EACxB,GAAG,KAAK,CAAC,UAAN,CAAiB,MADI;MAExB,+BAA+B;IAFP,CAA1B;EAID;AArB2D,CAAvD","sourcesContent":["import { detectOverflow, Modifier } from '@popperjs/core';\n\nexport const isIntersectingModifier: IsIntersectingModifier = {\n  name: 'is-intersecting-modifier',\n  enabled: true,\n  phase: 'main',\n  requires: ['preventOverflow'],\n  fn: ({ state, name }) => {\n    const popperRect = state.rects.popper;\n    const popperAltOverflow = detectOverflow(state, { altBoundary: true });\n\n    const isIntersectingTop = popperAltOverflow.top < popperRect.height && popperAltOverflow.top > 0;\n    const isIntersectingBottom = popperAltOverflow.bottom < popperRect.height && popperAltOverflow.bottom > 0;\n\n    const isIntersecting = isIntersectingTop || isIntersectingBottom;\n\n    state.modifiersData[name] = {\n      isIntersecting,\n    };\n    state.attributes.popper = {\n      ...state.attributes.popper,\n      'data-popper-is-intersecting': isIntersecting,\n    };\n  },\n};\n\ntype IsIntersectingModifier = Modifier<'is-intersecting-modifier', never>;\n"],"sourceRoot":"../src/"}

package/lib/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"../src/","sources":["types.ts"],"names":[],"mappings":"","sourcesContent":["import * as PopperJs from '@popperjs/core';\nimport * as React from 'react';\n\nexport type OffsetFunctionParam = {\n  popper: PopperJs.Rect;\n  reference: PopperJs.Rect;\n  placement: PopperJs.Placement;\n};\n\nexport type OffsetFunction = (param: OffsetFunctionParam) => [number | null | undefined, number | null | undefined];\n\nexport type Offset = OffsetFunction | [number | null | undefined, number | null | undefined];\n\nexport type Position = 'above' | 'below' | 'before' | 'after';\nexport type Alignment = 'top' | 'bottom' | 'start' | 'end' | 'center';\n\nexport type AutoSize = 'height' | 'height-always' | 'width' | 'width-always' | 'always' | boolean;\n\nexport type Boundary = PopperJs.Boundary | 'scrollParent' | 'window';\n\nexport type PopperRefHandle = {\n  /**\n   * Updates the position of the popper imperatively.\n   * Useful when the position of the target changes from other factors than scrolling of window resize.\n   */\n  updatePosition: () => void;\n\n  /**\n   * Sets the target and updates positioning imperatively.\n   * Useful for avoiding double renders with the target option.\n   */\n  setTarget: (target: HTMLElement) => void;\n};\n\nexport type PopperVirtualElement = PopperJs.VirtualElement;\n\nexport interface PopperOptions {\n  /** Alignment for the component. Only has an effect if used with the @see position option */\n  align?: Alignment;\n\n  /** The element which will define the boundaries of the popper position for the flip behavior. */\n  flipBoundary?: Boundary;\n\n  /** The element which will define the boundaries of the popper position for the overflow behavior. */\n  overflowBoundary?: Boundary;\n\n  /**\n   * Position for the component. Position has higher priority than align. If position is vertical ('above' | 'below')\n   * and align is also vertical ('top' | 'bottom') or if both position and align are horizontal ('before' | 'after'\n   * and 'start' | 'end' respectively),\n   * then provided value for 'align' will be ignored and 'center' will be used instead.\n   */\n  position?: Position;\n\n  /**\n   * Enables the Popper box to position itself in 'fixed' mode (default value is position: 'absolute')\n   * @default false\n   */\n  positionFixed?: boolean;\n\n  /**\n   * Lets you displace a popper element from its reference element.\n   * This can be useful if you need to apply some margin between them or if you need to fine tune the\n   * position according to some custom logic.\n   */\n  offset?: Offset;\n\n  /**\n   * Defines padding between the corner of the popup element and the arrow.\n   * Use to prevent the arrow from overlapping a rounded corner, for example.\n   */\n  arrowPadding?: number;\n\n  /**\n   * Applies max-height and max-width on popper to fit it within the available space in viewport.\n   * true enables this for both width and height when overflow happens.\n   * 'always' applies `max-height`/`max-width` regardless of overflow.\n   * 'height' applies `max-height` when overflow happens, and 'width' for `max-width`\n   * `height-always` applies `max-height` regardless of overflow, and 'width-always' for always applying `max-width`\n   */\n  autoSize?: AutoSize;\n\n  /**\n   * Modifies position and alignment to cover the target\n   */\n  coverTarget?: boolean;\n\n  /**\n   * Disables automatic repositioning of the component; it will always be placed according to the values of `align` and\n   * `position` props, regardless of the size of the component, the reference element or the viewport.\n   */\n  pinned?: boolean;\n\n  /**\n   * When the reference element or the viewport is outside viewport allows a popper element to be fully in viewport.\n   * \"all\" enables this behavior for all axis.\n   */\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  unstable_disableTether?: boolean | 'all';\n}\n\nexport interface PositioningProps\n  // \"positionFixed\" & \"unstable_disableTether\" are not exported as public API (yet)\n  extends Omit<PopperOptions, 'positionFixed' | 'unstable_disableTether'> {\n  /** An imperative handle to Popper methods. */\n  popperRef?: React.Ref<PopperRefHandle>;\n\n  /**\n   * Manual override for popper target. Useful for scenarios where a component accepts user prop to override target\n   */\n  target?: HTMLElement | PopperVirtualElement | null;\n}\n\nexport type PositioningShorthandValue =\n  | 'above'\n  | 'above-start'\n  | 'above-end'\n  | 'below'\n  | 'below-start'\n  | 'below-end'\n  | 'before'\n  | 'before-top'\n  | 'before-bottom'\n  | 'after'\n  | 'after-top'\n  | 'after-bottom';\n\nexport type PositioningShorthand = PositioningProps | PositioningShorthandValue;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"../src/","sources":["types.ts"],"names":[],"mappings":"","sourcesContent":["import * as React from 'react';\n\ntype Rect = {\n  width: number;\n  height: number;\n  x: number;\n  y: number;\n};\n\nexport type OffsetFunctionParam = {\n  positionedRect: Rect;\n  targetRect: Rect;\n  position: Position;\n  alignment?: Alignment;\n};\n\nexport type OffsetObject = { crossAxis?: number; mainAxis: number };\n\nexport type OffsetShorthand = number;\n\nexport type OffsetFunction = (param: OffsetFunctionParam) => OffsetObject | OffsetShorthand;\n\nexport type Offset = OffsetFunction | OffsetObject | OffsetShorthand;\n\nexport type Position = 'above' | 'below' | 'before' | 'after';\nexport type Alignment = 'top' | 'bottom' | 'start' | 'end' | 'center';\n\nexport type AutoSize = 'height' | 'height-always' | 'width' | 'width-always' | 'always' | boolean;\n\nexport type Boundary = HTMLElement | Array<HTMLElement> | 'clippingParents' | 'scrollParent' | 'window';\n\nexport type PositioningImperativeRef = {\n  /**\n   * Updates the position imperatively.\n   * Useful when the position of the target changes from other factors than scrolling of window resize.\n   */\n  updatePosition: () => void;\n\n  /**\n   * Sets the target and updates positioning imperatively.\n   * Useful for avoiding double renders with the target option.\n   */\n  setTarget: (target: HTMLElement | PositioningVirtualElement) => void;\n};\n\nexport type PositioningVirtualElement = {\n  getBoundingClientRect: () => {\n    x: number;\n    y: number;\n    top: number;\n    left: number;\n    bottom: number;\n    right: number;\n    width: number;\n    height: number;\n  };\n  contextElement?: Element;\n};\n\nexport interface PositioningOptions {\n  /** Alignment for the component. Only has an effect if used with the @see position option */\n  align?: Alignment;\n\n  /** The element which will define the boundaries of the positioned element for the flip behavior. */\n  flipBoundary?: Boundary;\n\n  /** The element which will define the boundaries of the positioned element for the overflow behavior. */\n  overflowBoundary?: Boundary;\n\n  /**\n   * Position for the component. Position has higher priority than align. If position is vertical ('above' | 'below')\n   * and align is also vertical ('top' | 'bottom') or if both position and align are horizontal ('before' | 'after'\n   * and 'start' | 'end' respectively),\n   * then provided value for 'align' will be ignored and 'center' will be used instead.\n   */\n  position?: Position;\n\n  /**\n   * Enables the position element to be positioned with 'fixed' (default value is position: 'absolute')\n   * @default false\n   */\n  positionFixed?: boolean;\n\n  /**\n   * Lets you displace a positioned element from its reference element.\n   * This can be useful if you need to apply some margin between them or if you need to fine tune the\n   * position according to some custom logic.\n   */\n  offset?: Offset;\n\n  /**\n   * Defines padding between the corner of the popup element and the arrow.\n   * Use to prevent the arrow from overlapping a rounded corner, for example.\n   */\n  arrowPadding?: number;\n\n  /**\n   * Applies max-height and max-width on the positioned element to fit it within the available space in viewport.\n   * true enables this for both width and height when overflow happens.\n   * 'always' applies `max-height`/`max-width` regardless of overflow.\n   * 'height' applies `max-height` when overflow happens, and 'width' for `max-width`\n   * `height-always` applies `max-height` regardless of overflow, and 'width-always' for always applying `max-width`\n   */\n  autoSize?: AutoSize;\n\n  /**\n   * Modifies position and alignment to cover the target\n   */\n  coverTarget?: boolean;\n\n  /**\n   * Disables automatic repositioning of the component; it will always be placed according to the values of `align` and\n   * `position` props, regardless of the size of the component, the reference element or the viewport.\n   */\n  pinned?: boolean;\n\n  /**\n   * When the reference element or the viewport is outside viewport allows a positioned element to be fully in viewport.\n   * \"all\" enables this behavior for all axis.\n   */\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  unstable_disableTether?: boolean | 'all';\n}\n\nexport interface PositioningProps\n  // \"positionFixed\" & \"unstable_disableTether\" are not exported as public API (yet)\n  extends Omit<PositioningOptions, 'positionFixed' | 'unstable_disableTether'> {\n  /** An imperative handle to Popper methods. */\n  positioningRef?: React.Ref<PositioningImperativeRef>;\n\n  /**\n   * Manual override for the target element. Useful for scenarios where a component accepts user prop to override target\n   */\n  target?: HTMLElement | PositioningVirtualElement | null;\n}\n\nexport type PositioningShorthandValue =\n  | 'above'\n  | 'above-start'\n  | 'above-end'\n  | 'below'\n  | 'below-start'\n  | 'below-end'\n  | 'before'\n  | 'before-top'\n  | 'before-bottom'\n  | 'after'\n  | 'after-top'\n  | 'after-bottom';\n\nexport type PositioningShorthand = PositioningProps | PositioningShorthandValue;\n"]}

package/lib/{usePopper.js → usePositioning.js}

@@ -1,8 +1,10 @@
 import { useEventCallback, useIsomorphicLayoutEffect, useFirstMount, canUseDOM } from '@fluentui/react-utilities';
-import { useFluent } from '@fluentui/react-shared-contexts';
+import { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';
 import * as PopperJs from '@popperjs/core';
 import * as React from 'react';
-import { getScrollParent, applyRtlToOffset, getPlacement, getReactFiberFromNode, getBoundary, useCallbackRef, getBasePlacement } from './utils/index'; //
+import { isIntersectingModifier } from './isIntersectingModifier';
+import { getScrollParent, applyRtlToOffset, getPlacement, getReactFiberFromNode, getBoundary, useCallbackRef, parsePopperPlacement } from './utils/index';
+import { getPopperOffset } from './utils/getPopperOffset'; //
 // Dev utils to detect if nodes have "autoFocus" props.
 //
 
@@ -57,7 +59,7 @@ function usePopperOptions(options, popperOriginalPositionRef) {
   const offsetModifier = React.useMemo(() => offset ? {
     name: 'offset',
     options: {
-      offset: isRtl ? applyRtlToOffset(offset) : offset
+      offset: isRtl ? applyRtlToOffset(getPopperOffset(offset)) : getPopperOffset(offset)
     }
   } : null, [offset, isRtl]);
   return React.useCallback((target, container, arrow) => {
@@ -65,7 +67,7 @@ function usePopperOptions(options, popperOriginalPositionRef) {
 
     const scrollParentElement = getScrollParent(container);
     const hasScrollableElement = scrollParentElement ? scrollParentElement !== ((_a = scrollParentElement.ownerDocument) === null || _a === void 0 ? void 0 : _a.body) : false;
-    const modifiers = [
+    const modifiers = [isIntersectingModifier,
     /**
      * We are setting the position to `fixed` in the first effect to prevent scroll jumps in case of the content
      * with managed focus. Modifier sets the position to `fixed` before all other modifier effects. Another part of
@@ -174,7 +176,7 @@ function usePopperOptions(options, popperOriginalPositionRef) {
           width,
           height
         } = state.rects.popper;
-        const basePlacement = getBasePlacement(state.placement);
+        const basePlacement = parsePopperPlacement(state.placement).basePlacement;
         const widthProp = basePlacement === 'left' ? 'left' : 'right';
         const heightProp = basePlacement === 'top' ? 'top' : 'bottom';
         const applyMaxWidth = autoSize === 'always' || autoSize === 'width-always' || overflow[widthProp] > 0 && (autoSize === true || autoSize === 'width');
@@ -214,7 +216,7 @@ function usePopperOptions(options, popperOriginalPositionRef) {
       fn({
         state
       }) {
-        const basePlacement = getBasePlacement(state.placement);
+        const basePlacement = parsePopperPlacement(state.placement).basePlacement;
 
         switch (basePlacement) {
           case 'bottom':
@@ -247,6 +249,7 @@ function usePopperOptions(options, popperOriginalPositionRef) {
   popperOriginalPositionRef]);
 }
 /**
+ * @internal
  * Exposes Popper positioning API via React hook. Contains few important differences between an official "react-popper"
  * package:
  * - style attributes are applied directly on DOM to avoid re-renders
@@ -256,7 +259,7 @@ function usePopperOptions(options, popperOriginalPositionRef) {
  */
 
 
-export function usePopper(options = {}) {
+export function usePositioning(options = {}) {
   const {
     enabled = true
   } = options;
@@ -323,7 +326,7 @@ export function usePopper(options = {}) {
   const arrowRef = useCallbackRef(null, handlePopperUpdate, true); // Stores external target from options.target or setTarget
 
   const overrideTargetRef = useCallbackRef(null, handlePopperUpdate, true);
-  React.useImperativeHandle(options.popperRef, () => ({
+  React.useImperativeHandle(options.positioningRef, () => ({
     updatePosition: () => {
       var _a;
 
@@ -403,4 +406,4 @@ export function usePopper(options = {}) {
     arrowRef
   };
 }
-//# sourceMappingURL=usePopper.js.map
+//# sourceMappingURL=usePositioning.js.map

package/lib/usePositioning.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["usePositioning.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEventCallback, useIsomorphicLayoutEffect, useFirstMount, canUseDOM } from '@fluentui/react-utilities';\nimport { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';\nimport * as PopperJs from '@popperjs/core';\nimport * as React from 'react';\n\nimport { isIntersectingModifier } from './isIntersectingModifier';\nimport {\n  getScrollParent,\n  applyRtlToOffset,\n  getPlacement,\n  getReactFiberFromNode,\n  getBoundary,\n  useCallbackRef,\n  parsePopperPlacement,\n} from './utils/index';\nimport type { PositioningVirtualElement, PositioningOptions, PositioningProps } from './types';\nimport { getPopperOffset } from './utils/getPopperOffset';\n\ntype PopperInstance = PopperJs.Instance & { isFirstRun?: boolean };\n\ninterface UsePopperOptions extends PositioningProps {\n  /**\n   * If false, delays Popper's creation.\n   * @default true\n   */\n  enabled?: boolean;\n}\n\n//\n// Dev utils to detect if nodes have \"autoFocus\" props.\n//\n\n/**\n * Detects if a passed HTML node has \"autoFocus\" prop on a React's fiber. Is needed as React handles autofocus behavior\n * in React DOM and will not pass \"autoFocus\" to an actual HTML.\n */\nfunction hasAutofocusProp(node: Node): boolean {\n  // https://github.com/facebook/react/blob/848bb2426e44606e0a55dfe44c7b3ece33772485/packages/react-dom/src/client/ReactDOMHostConfig.js#L157-L166\n  const isAutoFocusableElement =\n    node.nodeName === 'BUTTON' ||\n    node.nodeName === 'INPUT' ||\n    node.nodeName === 'SELECT' ||\n    node.nodeName === 'TEXTAREA';\n\n  if (isAutoFocusableElement) {\n    return !!getReactFiberFromNode(node)?.pendingProps.autoFocus;\n  }\n\n  return false;\n}\n\nfunction hasAutofocusFilter(node: Node) {\n  return hasAutofocusProp(node) ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP;\n}\n\n/**\n * Provides a callback to resolve Popper options, it's stable and should be used as a dependency to trigger updates\n * of Popper options.\n *\n * A callback is used there intentionally as some of Popper.js modifiers require DOM nodes (targer, container, arrow)\n * that can't be resolved properly during an initial rendering.\n */\nfunction usePopperOptions(options: PositioningOptions, popperOriginalPositionRef: React.MutableRefObject<string>) {\n  const {\n    align,\n    arrowPadding,\n    autoSize,\n    coverTarget,\n    flipBoundary,\n    offset,\n    overflowBoundary,\n    pinned,\n    position,\n    positionFixed,\n    // eslint-disable-next-line @typescript-eslint/naming-convention\n    unstable_disableTether,\n  } = options;\n\n  const isRtl = useFluent().dir === 'rtl';\n  const placement = getPlacement(align, position, isRtl);\n  const strategy = positionFixed ? 'fixed' : 'absolute';\n\n  const offsetModifier = React.useMemo(\n    () =>\n      offset\n        ? {\n            name: 'offset',\n            options: { offset: isRtl ? applyRtlToOffset(getPopperOffset(offset)) : getPopperOffset(offset) },\n          }\n        : null,\n    [offset, isRtl],\n  );\n\n  return React.useCallback(\n    (\n      target: HTMLElement | PopperJs.VirtualElement | null,\n      container: HTMLElement | null,\n      arrow: HTMLElement | null,\n    ): PopperJs.Options => {\n      const scrollParentElement: HTMLElement = getScrollParent(container);\n      const hasScrollableElement = scrollParentElement\n        ? scrollParentElement !== scrollParentElement.ownerDocument?.body\n        : false;\n\n      const modifiers: PopperJs.Options['modifiers'] = [\n        isIntersectingModifier,\n\n        /**\n         * We are setting the position to `fixed` in the first effect to prevent scroll jumps in case of the content\n         * with managed focus. Modifier sets the position to `fixed` before all other modifier effects. Another part of\n         * a patch modifies \".forceUpdate()\" directly after a Popper will be created.\n         */\n        {\n          name: 'positionStyleFix',\n          enabled: true,\n          phase: 'afterWrite' as PopperJs.ModifierPhases,\n          effect: ({ state, instance }: { state: PopperJs.State; instance: PopperInstance }) => {\n            // \".isFirstRun\" is a part of our patch, on a first evaluation it will \"undefined\"\n            // should be disabled for subsequent runs as it breaks positioning for them\n            if (instance.isFirstRun !== false) {\n              popperOriginalPositionRef.current = state.elements.popper.style.position;\n              state.elements.popper.style.position = 'fixed';\n            }\n\n            return () => undefined;\n          },\n          requires: [],\n        },\n\n        { name: 'flip', options: { flipVariations: true } },\n\n        /**\n         * pinned disables the flip modifier by setting flip.enabled to false; this\n         * disables automatic repositioning of the popper box; it will always be placed according to\n         * the values of `align` and `position` props, regardless of the size of the component, the\n         * reference element or the viewport.\n         */\n        pinned && { name: 'flip', enabled: false },\n\n        /**\n         * When the popper box is placed in the context of a scrollable element, we need to set\n         * preventOverflow.escapeWithReference to true and flip.boundariesElement to 'scrollParent'\n         * (default is 'viewport') so that the popper box will stick with the targetRef when we\n         * scroll targetRef out of the viewport.\n         */\n        hasScrollableElement && { name: 'flip', options: { boundary: 'clippingParents' } },\n        hasScrollableElement && { name: 'preventOverflow', options: { boundary: 'clippingParents' } },\n\n        offsetModifier,\n\n        /**\n         * This modifier is necessary to retain behaviour from popper v1 where untethered poppers are allowed by\n         * default. i.e. popper is still rendered fully in the viewport even if anchor element is no longer in the\n         * viewport.\n         */\n        unstable_disableTether && {\n          name: 'preventOverflow',\n          options: { altAxis: unstable_disableTether === 'all', tether: false },\n        },\n\n        flipBoundary && {\n          name: 'flip',\n          options: {\n            altBoundary: true,\n            boundary: getBoundary(container, flipBoundary),\n          },\n        },\n        overflowBoundary && {\n          name: 'preventOverflow',\n          options: {\n            altBoundary: true,\n            boundary: getBoundary(container, overflowBoundary),\n          },\n        },\n\n        {\n          // Similar code as popper-maxsize-modifier: https://github.com/atomiks/popper.js/blob/master/src/modifiers/maxSize.js\n          // popper-maxsize-modifier only calculates the max sizes.\n          // This modifier can apply max sizes always, or apply the max sizes only when overflow is detected\n          name: 'applyMaxSize',\n          enabled: !!autoSize,\n          phase: 'beforeWrite' as PopperJs.ModifierPhases,\n          requiresIfExists: ['offset', 'preventOverflow', 'flip'],\n          options: {\n            altBoundary: true,\n            boundary: getBoundary(container, overflowBoundary),\n          },\n          fn({ state, options: modifierOptions }: PopperJs.ModifierArguments<{}>) {\n            const overflow = PopperJs.detectOverflow(state, modifierOptions);\n            const { x, y } = state.modifiersData.preventOverflow || { x: 0, y: 0 };\n            const { width, height } = state.rects.popper;\n            const basePlacement = parsePopperPlacement(state.placement).basePlacement;\n\n            const widthProp: keyof PopperJs.SideObject = basePlacement === 'left' ? 'left' : 'right';\n            const heightProp: keyof PopperJs.SideObject = basePlacement === 'top' ? 'top' : 'bottom';\n\n            const applyMaxWidth =\n              autoSize === 'always' ||\n              autoSize === 'width-always' ||\n              (overflow[widthProp] > 0 && (autoSize === true || autoSize === 'width'));\n            const applyMaxHeight =\n              autoSize === 'always' ||\n              autoSize === 'height-always' ||\n              (overflow[heightProp] > 0 && (autoSize === true || autoSize === 'height'));\n\n            if (applyMaxWidth) {\n              state.styles.popper.maxWidth = `${width - overflow[widthProp] - x}px`;\n            }\n            if (applyMaxHeight) {\n              state.styles.popper.maxHeight = `${height - overflow[heightProp] - y}px`;\n            }\n          },\n        },\n\n        /**\n         * This modifier is necessary in order to render the pointer. Refs are resolved in effects, so it can't be\n         * placed under computed modifiers. Deep merge is not required as this modifier has only these properties.\n         */\n        {\n          name: 'arrow',\n          enabled: !!arrow,\n          options: { element: arrow, padding: arrowPadding },\n        },\n\n        /**\n         * Modifies popper offsets to cover the reference rect, but still keep edge alignment\n         */\n        {\n          name: 'coverTarget',\n          enabled: !!coverTarget,\n          phase: 'main',\n          requiresIfExists: ['offset', 'preventOverflow', 'flip'],\n          fn({ state }: PopperJs.ModifierArguments<{}>) {\n            const basePlacement = parsePopperPlacement(state.placement).basePlacement;\n            switch (basePlacement) {\n              case 'bottom':\n                state.modifiersData.popperOffsets!.y -= state.rects.reference.height;\n                break;\n              case 'top':\n                state.modifiersData.popperOffsets!.y += state.rects.reference.height;\n                break;\n              case 'left':\n                state.modifiersData.popperOffsets!.x += state.rects.reference.width;\n                break;\n              case 'right':\n                state.modifiersData.popperOffsets!.x -= state.rects.reference.width;\n                break;\n            }\n          },\n        },\n      ].filter(Boolean) as PopperJs.Options['modifiers']; // filter boolean conditional spreading values\n\n      const popperOptions: PopperJs.Options = {\n        modifiers,\n\n        placement,\n        strategy,\n      };\n\n      return popperOptions;\n    },\n    [\n      arrowPadding,\n      autoSize,\n      coverTarget,\n      flipBoundary,\n      offsetModifier,\n      overflowBoundary,\n      placement,\n      strategy,\n      unstable_disableTether,\n      pinned,\n\n      // These can be skipped from deps as they will not ever change\n      popperOriginalPositionRef,\n    ],\n  );\n}\n\n/**\n * @internal\n * Exposes Popper positioning API via React hook. Contains few important differences between an official \"react-popper\"\n * package:\n * - style attributes are applied directly on DOM to avoid re-renders\n * - refs changes and resolution is handled properly without re-renders\n * - contains a specific to React fix related to initial positioning when containers have components with managed focus\n *   to avoid focus jumps\n */\nexport function usePositioning(\n  options: UsePopperOptions = {},\n): {\n  // React refs are supposed to be contravariant\n  // (allows a more general type to be passed rather than a more specific one)\n  // However, Typescript currently can't infer that fact for refs\n  // See https://github.com/microsoft/TypeScript/issues/30748 for more information\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  targetRef: React.MutableRefObject<any>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  containerRef: React.MutableRefObject<any>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  arrowRef: React.MutableRefObject<any>;\n} {\n  const { enabled = true } = options;\n  const isFirstMount = useFirstMount();\n\n  const popperOriginalPositionRef = React.useRef<string>('absolute');\n  const resolvePopperOptions = usePopperOptions(options, popperOriginalPositionRef);\n\n  const popperInstanceRef = React.useRef<PopperInstance | null>(null);\n\n  const handlePopperUpdate = useEventCallback(() => {\n    popperInstanceRef.current?.destroy();\n    popperInstanceRef.current = null;\n\n    const target = overrideTargetRef.current ?? targetRef.current;\n\n    let popperInstance: PopperInstance | null = null;\n\n    if (canUseDOM() && enabled) {\n      if (target && containerRef.current) {\n        popperInstance = PopperJs.createPopper(\n          target,\n          containerRef.current,\n          resolvePopperOptions(target, containerRef.current, arrowRef.current),\n        );\n      }\n    }\n\n    if (popperInstance) {\n      /**\n       * The patch updates `.forceUpdate()` Popper function which restores the original position before the first\n       * forceUpdate() call. See also \"positionStyleFix\" modifier in usePopperOptions().\n       */\n      const originalForceUpdate = popperInstance.forceUpdate;\n\n      popperInstance.isFirstRun = true;\n      popperInstance.forceUpdate = () => {\n        if (popperInstance?.isFirstRun) {\n          popperInstance.state.elements.popper.style.position = popperOriginalPositionRef.current;\n          popperInstance.isFirstRun = false;\n        }\n\n        originalForceUpdate();\n      };\n    }\n\n    popperInstanceRef.current = popperInstance;\n  });\n\n  // Refs are managed by useCallbackRef() to handle ref updates scenarios.\n  //\n  // The first scenario are updates for a targetRef, we can handle it properly only via callback refs, but it causes\n  // re-renders (we would like to avoid them).\n  //\n  // The second problem is related to refs resolution on React's layer: refs are resolved in the same order as effects\n  // that causes an issue when you have a container inside a target, for example: a menu in ChatMessage.\n  //\n  // function ChatMessage(props) {\n  //   <div className=\"message\" ref={targetRef}> // 3) ref will be resolved only now, but it's too late already\n  //     <Popper target={targetRef}> // 2) create a popper instance\n  //       <div className=\"menu\" /> // 1) capture ref from this element\n  //     </Popper>\n  //   </div>\n  // }\n  //\n  // Check a demo on CodeSandbox: https://codesandbox.io/s/popper-refs-emy60.\n  //\n  // This again can be solved with callback refs. It's not a huge issue as with hooks we are moving popper's creation\n  // to ChatMessage itself, however, without `useCallback()` refs it's still a Pandora box.\n  const targetRef = useCallbackRef<HTMLElement | PopperJs.VirtualElement | null>(null, handlePopperUpdate, true);\n  const containerRef = useCallbackRef<HTMLElement | null>(null, handlePopperUpdate, true);\n  const arrowRef = useCallbackRef<HTMLElement | null>(null, handlePopperUpdate, true);\n\n  // Stores external target from options.target or setTarget\n  const overrideTargetRef = useCallbackRef<HTMLElement | PositioningVirtualElement | null>(\n    null,\n    handlePopperUpdate,\n    true,\n  );\n\n  React.useImperativeHandle(\n    options.positioningRef,\n    () => ({\n      updatePosition: () => {\n        popperInstanceRef.current?.update();\n      },\n      setTarget: (target: HTMLElement | PositioningVirtualElement) => {\n        if (options.target && process.env.NODE_ENV !== 'production') {\n          const err = new Error();\n          // eslint-disable-next-line no-console\n          console.warn('Imperative setTarget should not be used at the same time as target option');\n          // eslint-disable-next-line no-console\n          console.warn(err.stack);\n        }\n\n        overrideTargetRef.current = target;\n      },\n    }),\n    // Missing deps:\n    // options.target - only used for a runtime warning\n    // targetRef - Stable between renders\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [],\n  );\n\n  useIsomorphicLayoutEffect(() => {\n    if (options.target) {\n      overrideTargetRef.current = options.target;\n    }\n  }, [options.target, overrideTargetRef]);\n  useIsomorphicLayoutEffect(() => {\n    handlePopperUpdate();\n\n    return () => {\n      popperInstanceRef.current?.destroy();\n      popperInstanceRef.current = null;\n    };\n  }, [handlePopperUpdate, options.enabled]);\n  useIsomorphicLayoutEffect(\n    () => {\n      if (!isFirstMount) {\n        popperInstanceRef.current?.setOptions(\n          resolvePopperOptions(overrideTargetRef.current ?? targetRef.current, containerRef.current, arrowRef.current),\n        );\n      }\n    },\n    // Missing deps:\n    // isFirstMount - Should never change after mount\n    // arrowRef, containerRef, targetRef - Stable between renders\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [resolvePopperOptions],\n  );\n\n  if (process.env.NODE_ENV !== 'production') {\n    // This checked should run only in development mode\n    // eslint-disable-next-line react-hooks/rules-of-hooks\n    React.useEffect(() => {\n      if (containerRef.current) {\n        const contentNode = containerRef.current;\n        const treeWalker = contentNode.ownerDocument?.createTreeWalker(contentNode, NodeFilter.SHOW_ELEMENT, {\n          acceptNode: hasAutofocusFilter,\n        });\n\n        while (treeWalker?.nextNode()) {\n          const node = treeWalker.currentNode;\n          // eslint-disable-next-line no-console\n          console.warn('<Popper>:', node);\n          // eslint-disable-next-line no-console\n          console.warn(\n            [\n              '<Popper>: ^ this node contains \"autoFocus\" prop on a React element. This can break the initial',\n              'positioning of an element and cause a window jump effect. This issue occurs because React polyfills',\n              '\"autoFocus\" behavior to solve inconsistencies between different browsers:',\n              'https://github.com/facebook/react/issues/11851#issuecomment-351787078',\n              '\\n',\n              'However, \".focus()\" in this case occurs before any other React effects will be executed',\n              '(React.useEffect(), componentDidMount(), etc.) and we can not prevent this behavior. If you really',\n              'want to use \"autoFocus\" please add \"position: fixed\" to styles of the element that is wrapped by',\n              '\"Popper\".',\n              `In general, it's not recommended to use \"autoFocus\" as it may break accessibility aspects:`,\n              'https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/master/docs/rules/no-autofocus.md',\n              '\\n',\n              'We suggest to use the \"trapFocus\" prop on Fluent components or a catch \"ref\" and then use',\n              '\"ref.current.focus\" in React.useEffect():',\n              'https://reactjs.org/docs/refs-and-the-dom.html#adding-a-ref-to-a-dom-element',\n            ].join(' '),\n          );\n        }\n      }\n      // We run this check once, no need to add deps here\n      // TODO: Should be rework to handle options.enabled and contentRef updates\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n  }\n\n  return { targetRef, containerRef, arrowRef };\n}\n"],"sourceRoot":"../src/"}

package/lib/{usePopperMouseTarget.js → usePositioningMouseTarget.js}

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import { createVirtualElementFromClick } from './createVirtualElementFromClick';
 /**
+ * @internal
  * A state hook that manages a popper virtual element from mouseevents.
  * Useful for scenarios where a component needs to be positioned by mouse click (e.g. contextmenu)
  * React synthetic events are not persisted by this hook
@@ -9,7 +10,7 @@ import { createVirtualElementFromClick } from './createVirtualElementFromClick';
  * @returns state and dispatcher for a Popper virtual element that uses native/synthetic mouse events
  */
 
-export const usePopperMouseTarget = initialState => {
+export const usePositioningMouseTarget = initialState => {
   const [virtualElement, setVirtualElement] = React.useState(initialState);
 
   const setVirtualMouseTarget = event => {
@@ -28,7 +29,7 @@ export const usePopperMouseTarget = initialState => {
 
     if (!(mouseevent instanceof MouseEvent) && process.env.NODE_ENV !== 'production') {
       // eslint-disable-next-line no-console
-      console.error('usePopperMouseTarget should only be used with MouseEvent');
+      console.error('usePositioningMouseTarget should only be used with MouseEvent');
     }
 
     const contextTarget = createVirtualElementFromClick(mouseevent);
@@ -37,4 +38,4 @@ export const usePopperMouseTarget = initialState => {
 
   return [virtualElement, setVirtualMouseTarget];
 };
-//# sourceMappingURL=usePopperMouseTarget.js.map
+//# sourceMappingURL=usePositioningMouseTarget.js.map

package/lib/usePositioningMouseTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["usePositioningMouseTarget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,6BAAT,QAA8C,iCAA9C;AAGA;;;;;;;;AAQG;;AACH,OAAO,MAAM,yBAAyB,GACpC,YADuC,IAErC;EACF,MAAM,CAAC,cAAD,EAAiB,iBAAjB,IAAsC,KAAK,CAAC,QAAN,CAAsD,YAAtD,CAA5C;;EAEA,MAAM,qBAAqB,GAAI,KAAD,IAA4D;IACxF,IAAI,KAAK,KAAK,SAAV,IAAuB,KAAK,KAAK,IAArC,EAA2C;MACzC,iBAAiB,CAAC,SAAD,CAAjB;MACA;IACD;;IAED,IAAI,UAAJ;;IACA,IAAI,EAAE,KAAK,YAAY,UAAnB,CAAJ,EAAoC;MAClC,UAAU,GAAG,KAAK,CAAC,WAAnB;IACD,CAFD,MAEO;MACL,UAAU,GAAG,KAAb;IACD;;IAED,IAAI,EAAE,UAAU,YAAY,UAAxB,KAAuC,OAAO,CAAC,GAAR,CAAY,QAAZ,KAAyB,YAApE,EAAkF;MAChF;MACA,OAAO,CAAC,KAAR,CAAc,+DAAd;IACD;;IAED,MAAM,aAAa,GAAG,6BAA6B,CAAC,UAAD,CAAnD;IACA,iBAAiB,CAAC,aAAD,CAAjB;EACD,CApBD;;EAsBA,OAAO,CAAC,cAAD,EAAiB,qBAAjB,CAAP;AACD,CA5BM","sourcesContent":["import * as React from 'react';\nimport { createVirtualElementFromClick } from './createVirtualElementFromClick';\nimport { PositioningVirtualElement } from './types';\n\n/**\n * @internal\n * A state hook that manages a popper virtual element from mouseevents.\n * Useful for scenarios where a component needs to be positioned by mouse click (e.g. contextmenu)\n * React synthetic events are not persisted by this hook\n *\n * @param initialState - initializes a user provided state similare to useState\n * @returns state and dispatcher for a Popper virtual element that uses native/synthetic mouse events\n */\nexport const usePositioningMouseTarget = (\n  initialState?: PositioningVirtualElement | (() => PositioningVirtualElement),\n) => {\n  const [virtualElement, setVirtualElement] = React.useState<PositioningVirtualElement | undefined>(initialState);\n\n  const setVirtualMouseTarget = (event: React.MouseEvent | MouseEvent | undefined | null) => {\n    if (event === undefined || event === null) {\n      setVirtualElement(undefined);\n      return;\n    }\n\n    let mouseevent: MouseEvent;\n    if (!(event instanceof MouseEvent)) {\n      mouseevent = event.nativeEvent;\n    } else {\n      mouseevent = event;\n    }\n\n    if (!(mouseevent instanceof MouseEvent) && process.env.NODE_ENV !== 'production') {\n      // eslint-disable-next-line no-console\n      console.error('usePositioningMouseTarget should only be used with MouseEvent');\n    }\n\n    const contextTarget = createVirtualElementFromClick(mouseevent);\n    setVirtualElement(contextTarget);\n  };\n\n  return [virtualElement, setVirtualMouseTarget] as const;\n};\n"],"sourceRoot":"../src/"}