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

package/Spec.md

@@ -238,6 +238,11 @@ export type PopoverProps = {
    */
   onOpenChange?: (e: OpenPopoverEvents, data: OpenEventData) => void;
 
+  /**
+   * Flag to open the Popover by hovering the trigger
+   */
+  openOnHover?: boolean;
+
   /**
    * Anchor the popover to an element other than the trigger
    */
@@ -284,6 +289,16 @@ export type PopoverProps = {
    * Do not render an arrow pointing to the target element. This is the `PopoverTrigger` unless `target` prop is used
    */
   noArrow?: boolean;
+
+  /**
+   * Sets the delay for closing popover on mouse leave
+   */
+  mouseLeaveDelay?: number;
+
+  /**
+   * Close when scrolling outside of it
+   */
+  closeOnScroll?: boolean;
 };
 ```
 
@@ -329,7 +344,7 @@ Default popover
 
 // Expected Markup
 <div id="container">
-  <button aria-haspopup="dialog">Trigger</button>
+  <button aria-expanded="false">Trigger</button>
 </div>
 
 // on document.body
@@ -355,7 +370,7 @@ Popover that traps focus
 
 // Expected Markup
 <div id="container">
-  <button aria-haspopup="dialog">Trigger</button>
+  <button aria-expanded="false">Trigger</button>
 </div>
 
 // on document.body
@@ -381,7 +396,7 @@ Inline popover
 
 // Expected Markup
 <div id="container">
-  <button aria-haspopup="dialog">Trigger</button>
+  <button aria-expanded="false">Trigger</button>
   <div>
     {/** content */}
   </div>
@@ -445,6 +460,11 @@ The popover closes with the escape key when the trigger or popover content has f
 
 The popover closes when a click happens outside the popover trigger or content.
 
+#### Scroll outside
+
+The context menu popover closes when scroll happens outside the popover trigger or content.
+When popover is configured with `closeOnScroll`, popover closes when scroll happens outside the popover trigger or content.
+
 ### Focus trap
 
 When the popover is configured to be a focus trap, focus the first focusable element inside the popover on open.
@@ -478,7 +498,7 @@ Accessible markup is divided into two scenarios:
 
 ```tsx
 // Popover that does not trap focus
-<button aria-haspopup="dialog">Trigger</button>
+<button aria-expanded="false">Trigger</button>
 <div role="complementary">
   No focus trap
 </div>
@@ -487,7 +507,7 @@ Accessible markup is divided into two scenarios:
 <div aria-hidden="true" /> // other content
 <div aria-hidden="true" /> // other content
 <div aria-hidden="true" className='fui-provider'>
-  <button aria-haspopup="dialog">Trigger</button>
+  <button aria-expanded="false">Trigger</button>
 </div>
 
 <div role="dialog" aria-modal="true">

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

@@ -1,17 +1,21 @@
 import type { ComponentProps } from '@fluentui/react-utilities';
 import type { ComponentState } from '@fluentui/react-utilities';
-import type { Context } from '@fluentui/react-context-selector';
 import type { ContextSelector } from '@fluentui/react-context-selector';
+import { FC } from 'react';
 import type { FluentTriggerComponent } from '@fluentui/react-utilities';
 import type { ForwardRefComponent } from '@fluentui/react-utilities';
 import { JSXElementConstructor } from 'react';
-import type { PopperVirtualElement } from '@fluentui/react-positioning';
 import type { PortalProps } from '@fluentui/react-portal';
 import type { PositioningShorthand } from '@fluentui/react-positioning';
+import type { PositioningVirtualElement } from '@fluentui/react-positioning';
+import { Provider } from 'react';
+import { ProviderProps } from 'react';
 import * as React_2 from 'react';
 import { ReactElement } from 'react';
 import type { Slot } from '@fluentui/react-utilities';
-import type { usePopperMouseTarget } from '@fluentui/react-positioning';
+import type { SlotClassNames } from '@fluentui/react-utilities';
+import type { UseModalAttributesOptions } from '@fluentui/react-tabster';
+import type { usePositioningMouseTarget } from '@fluentui/react-positioning';
 
 export declare const arrowHeights: Record<PopoverSize, number>;
 
@@ -25,76 +29,112 @@ export declare type OnOpenChangeData = {
 /**
  * The supported events that will trigger open/close of the menu
  */
-export declare type OpenPopoverEvents = MouseEvent | TouchEvent | React_2.MouseEvent<HTMLElement> | React_2.KeyboardEvent<HTMLElement> | React_2.FocusEvent<HTMLElement>;
+export declare type OpenPopoverEvents = MouseEvent | TouchEvent | React_2.FocusEvent<HTMLElement> | React_2.KeyboardEvent<HTMLElement> | React_2.MouseEvent<HTMLElement>;
 
 /**
  * Wrapper component that manages state for a PopoverTrigger and a PopoverSurface components.
  */
 export declare const Popover: React_2.FC<PopoverProps>;
 
-declare type PopoverCommons = Pick<PortalProps, 'mountNode'> & {
+/**
+ * Context shared between Popover and its children components
+ */
+export declare type PopoverContextValue = Pick<PopoverState, 'open' | 'toggleOpen' | 'setOpen' | 'triggerRef' | 'contentRef' | 'openOnHover' | 'openOnContext' | 'mountNode' | 'withArrow' | 'arrowRef' | 'size' | 'appearance' | 'trapFocus' | 'legacyTrapFocus' | 'inline'>;
+
+/**
+ * Popover Props
+ */
+export declare type PopoverProps = Pick<PortalProps, 'mountNode'> & {
     /**
-     * Controls the opening of the Popover
+     * A popover can appear styled with brand or inverted.
+     * When not specified, the default style is used.
      */
-    open: boolean;
+    appearance?: 'brand' | 'inverted';
+    /**
+     * Can contain two children including {@link PopoverTrigger} and {@link PopoverSurface}.
+     * Alternatively can only contain {@link PopoverSurface} if using a custom `target`.
+     */
+    children: [JSX.Element, JSX.Element] | JSX.Element;
+    /**
+     * Close when scroll outside of it
+     *
+     * @default false
+     */
+    closeOnScroll?: boolean;
     /**
      * Used to set the initial open state of the Popover in uncontrolled mode
+     *
+     * @default false
      */
     defaultOpen?: boolean;
+    /**
+     * Popovers are rendered out of DOM order on `document.body` by default, use this to render the popover in DOM order
+     *
+     * @default false
+     */
+    inline?: boolean;
+    /**
+     * Sets the delay for closing popover on mouse leave
+     */
+    mouseLeaveDelay?: number;
+    /**
+     * Display an arrow pointing to the target.
+     *
+     * @default false
+     */
+    withArrow?: boolean;
     /**
      * Call back when the component requests to change value
      * The `open` value is used as a hint when directly controlling the component
      */
     onOpenChange?: (e: OpenPopoverEvents, data: OnOpenChangeData) => void;
     /**
-     * Flag to open the Popover by hovering the trigger
+     * Controls the opening of the Popover
+     *
+     * @default false
      */
-    openOnHover?: boolean;
+    open?: boolean;
     /**
      * Flag to open the Popover as a context menu. Disables all other interactions
+     *
+     * @default false
      */
     openOnContext?: boolean;
     /**
-     * Do not display the arrow
+     * Flag to open the Popover by hovering the trigger
+     *
+     * @default false
      */
-    noArrow?: boolean;
+    openOnHover?: boolean;
+    /**
+     * Configures the position of the Popover
+     */
+    positioning?: PositioningShorthand;
     /**
      * Determines popover padding and arrow size
+     *
      * @default medium
      */
     size?: PopoverSize;
-    /**
-     * A popover can appear styled with brand or inverted.
-     * When not specified, the default style is used.
-     */
-    appearance?: 'brand' | 'inverted';
     /**
      * Should trap focus
+     *
+     * @default false
      */
-    trapFocus?: boolean;
+    trapFocus?: UseModalAttributesOptions['trapFocus'];
     /**
-     * Configures the position of the Popover
+     * Must be used with the `trapFocus` prop
+     * Enables older Fluent UI focus trap behavior where the user
+     * cannot tab into the window outside of the document. This is now
+     * non-standard behavior according to the [HTML dialog spec](https://developer.mozilla.org/en-US/docs/Web/API/HTMLDialogElement/showModal)
+     * where the focus trap involves setting outside elements inert.
+     *
+     * @default false
      */
-    positioning?: PositioningShorthand;
+    legacyTrapFocus?: UseModalAttributesOptions['legacyTrapFocus'];
 };
 
-export declare const PopoverContext: Context<PopoverContextValue>;
-
-/**
- * Context shared between Popover and its children components
- */
-export declare type PopoverContextValue = Pick<PopoverState, 'open' | 'setOpen' | 'triggerRef' | 'contentRef' | 'openOnHover' | 'openOnContext' | 'mountNode' | 'noArrow' | 'arrowRef' | 'size' | 'appearance' | 'trapFocus'>;
-
-/**
- * Popover Props
- */
-export declare type PopoverProps = Partial<PopoverCommons> & {
-    /**
-     * Can contain two children including {@link PopoverTrigger} and {@link PopoverSurface}.
-     * Alternatively can only contain {@link PopoverSurface} if using a custom `target`.
-     */
-    children: [JSX.Element, JSX.Element] | JSX.Element;
-};
+export declare const PopoverProvider: Provider<PopoverContextValue> & FC<ProviderProps<PopoverContextValue>>;
 
 /**
  * Determines popover padding and arrow size
@@ -104,32 +144,38 @@ export declare type PopoverSize = 'small' | 'medium' | 'large';
 /**
  * Popover State
  */
-export declare type PopoverState = PopoverCommons & Pick<PopoverProps, 'children'> & {
-    /**
-     * Callback to open/close the Popover
-     */
-    setOpen: (e: OpenPopoverEvents, open: boolean) => void;
+export declare type PopoverState = Pick<PopoverProps, 'appearance' | 'mountNode' | 'onOpenChange' | 'openOnContext' | 'openOnHover' | 'trapFocus' | 'withArrow' | 'legacyTrapFocus'> & Required<Pick<PopoverProps, 'inline' | 'open'>> & Pick<PopoverProps, 'children'> & {
     /**
-     * Ref of the PopoverTrigger
+     * Ref of the pointing arrow
      */
-    triggerRef: React_2.MutableRefObject<HTMLElement | null>;
+    arrowRef: React_2.MutableRefObject<HTMLDivElement | null>;
     /**
      * Ref of the PopoverSurface
      */
     contentRef: React_2.MutableRefObject<HTMLElement | null>;
-    /**
-     * Ref of the pointing arrow
-     */
-    arrowRef: React_2.MutableRefObject<HTMLDivElement | null>;
     /**
      * Anchors the popper to the mouse click for context events
      */
-    contextTarget: PopperVirtualElement | undefined;
+    contextTarget: PositioningVirtualElement | undefined;
+    popoverSurface: React_2.ReactElement | undefined;
+    popoverTrigger: React_2.ReactElement | undefined;
     /**
      * A callback to set the target of the popper to the mouse click for context events
      */
-    setContextTarget: ReturnType<typeof usePopperMouseTarget>[1];
+    setContextTarget: ReturnType<typeof usePositioningMouseTarget>[1];
+    /**
+     * Callback to open/close the Popover
+     */
+    setOpen: (e: OpenPopoverEvents, open: boolean) => void;
     size: NonNullable<PopoverProps['size']>;
+    /**
+     * Callback to toggle the open state of the Popover
+     */
+    toggleOpen: (e: OpenPopoverEvents) => void;
+    /**
+     * Ref of the PopoverTrigger
+     */
+    triggerRef: React_2.MutableRefObject<HTMLElement | null>;
 };
 
 /**
@@ -137,7 +183,7 @@ export declare type PopoverState = PopoverCommons & Pick<PopoverProps, 'children
  */
 export declare const PopoverSurface: ForwardRefComponent<PopoverSurfaceProps>;
 
-export declare const popoverSurfaceClassName = "fui-PopoverSurface";
+export declare const popoverSurfaceClassNames: SlotClassNames<PopoverSurfaceSlots>;
 
 /**
  * PopoverSurface Props
@@ -154,7 +200,7 @@ export declare type PopoverSurfaceSlots = {
 /**
  * PopoverSurface State
  */
-export declare type PopoverSurfaceState = ComponentState<PopoverSurfaceSlots> & Pick<PopoverContextValue, 'open' | 'mountNode' | 'noArrow' | 'size' | 'appearance' | 'arrowRef'> & {
+export declare type PopoverSurfaceState = ComponentState<PopoverSurfaceSlots> & Pick<PopoverContextValue, 'appearance' | 'arrowRef' | 'inline' | 'mountNode' | 'size' | 'withArrow'> & {
     /**
      * CSS class for the arrow element
      */
@@ -168,7 +214,7 @@ export declare const PopoverTrigger: React_2.FC<PopoverTriggerProps> & FluentTri
 
 export declare type PopoverTriggerChildProps = {
     ref?: React_2.Ref<never>;
-} & Pick<React_2.HTMLAttributes<HTMLElement>, 'aria-haspopup' | 'onClick' | 'onMouseEnter' | 'onKeyDown' | 'onMouseLeave' | 'onContextMenu'>;
+} & Pick<React_2.HTMLAttributes<HTMLElement>, 'aria-expanded' | 'onClick' | 'onContextMenu' | 'onKeyDown' | 'onMouseEnter' | 'onMouseLeave'>;
 
 /**
  * PopoverTrigger Props
@@ -194,7 +240,7 @@ export declare const renderPopover_unstable: (state: PopoverState) => JSX.Elemen
 /**
  * Render the final JSX of PopoverSurface
  */
-export declare const renderPopoverSurface_unstable: (state: PopoverSurfaceState) => JSX.Element | null;
+export declare const renderPopoverSurface_unstable: (state: PopoverSurfaceState) => JSX.Element;
 
 /**
  * Render the final JSX of PopoverTrigger

package/lib/components/Popover/Popover.js.map

@@ -1 +1 @@
-{"version":3,"sources":["components/Popover/Popover.tsx"],"names":[],"mappings":"AACA,SAAS,mBAAT,QAAoC,cAApC;AACA,SAAS,sBAAT,QAAuC,iBAAvC;AAGA;;AAEG;;AACH,OAAO,MAAM,OAAO,GAA2B,KAAK,IAAG;AACrD,QAAM,KAAK,GAAG,mBAAmB,CAAC,KAAD,CAAjC;AAEA,SAAO,sBAAsB,CAAC,KAAD,CAA7B;AACD,CAJM;AAMP,OAAO,CAAC,WAAR,GAAsB,SAAtB","sourcesContent":["import * as React from 'react';\nimport { usePopover_unstable } from './usePopover';\nimport { renderPopover_unstable } from './renderPopover';\nimport type { PopoverProps } from './Popover.types';\n\n/**\n * Wrapper component that manages state for a PopoverTrigger and a PopoverSurface components.\n */\nexport const Popover: React.FC<PopoverProps> = props => {\n  const state = usePopover_unstable(props);\n\n  return renderPopover_unstable(state);\n};\n\nPopover.displayName = 'Popover';\n"],"sourceRoot":"../src/"}
+{"version":3,"sources":["components/Popover/Popover.tsx"],"names":[],"mappings":"AACA,SAAS,mBAAT,QAAoC,cAApC;AACA,SAAS,sBAAT,QAAuC,iBAAvC;AAGA;;AAEG;;AACH,OAAO,MAAM,OAAO,GAA2B,KAAK,IAAG;EACrD,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAD,CAAjC;EAEA,OAAO,sBAAsB,CAAC,KAAD,CAA7B;AACD,CAJM;AAMP,OAAO,CAAC,WAAR,GAAsB,SAAtB","sourcesContent":["import * as React from 'react';\nimport { usePopover_unstable } from './usePopover';\nimport { renderPopover_unstable } from './renderPopover';\nimport type { PopoverProps } from './Popover.types';\n\n/**\n * Wrapper component that manages state for a PopoverTrigger and a PopoverSurface components.\n */\nexport const Popover: React.FC<PopoverProps> = props => {\n  const state = usePopover_unstable(props);\n\n  return renderPopover_unstable(state);\n};\n\nPopover.displayName = 'Popover';\n"],"sourceRoot":"../src/"}

package/lib/components/Popover/Popover.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"Popover.types.js","sourceRoot":"../src/","sources":["components/Popover/Popover.types.ts"],"names":[],"mappings":"","sourcesContent":["import * as React from 'react';\nimport type { PopperVirtualElement, PositioningShorthand, usePopperMouseTarget } from '@fluentui/react-positioning';\nimport type { PortalProps } from '@fluentui/react-portal';\n\n/**\n * Determines popover padding and arrow size\n */\nexport type PopoverSize = 'small' | 'medium' | 'large';\n\ntype PopoverCommons = Pick<PortalProps, 'mountNode'> & {\n  /**\n   * Controls the opening of the Popover\n   */\n  open: boolean;\n  /**\n   * Used to set the initial open state of the Popover in uncontrolled mode\n   */\n  defaultOpen?: boolean;\n  /**\n   * Call back when the component requests to change value\n   * The `open` value is used as a hint when directly controlling the component\n   */\n  onOpenChange?: (e: OpenPopoverEvents, data: OnOpenChangeData) => void;\n  /**\n   * Flag to open the Popover by hovering the trigger\n   */\n  openOnHover?: boolean;\n  /**\n   * Flag to open the Popover as a context menu. Disables all other interactions\n   */\n  openOnContext?: boolean;\n  /**\n   * Do not display the arrow\n   */\n  noArrow?: boolean;\n  /**\n   * Determines popover padding and arrow size\n   * @default medium\n   */\n  size?: PopoverSize;\n\n  /**\n   * A popover can appear styled with brand or inverted.\n   * When not specified, the default style is used.\n   */\n  appearance?: 'brand' | 'inverted';\n\n  /**\n   * Should trap focus\n   */\n  trapFocus?: boolean;\n\n  /**\n   * Configures the position of the Popover\n   */\n  positioning?: PositioningShorthand;\n};\n\n/**\n * Popover Props\n */\nexport type PopoverProps = Partial<PopoverCommons> & {\n  /**\n   * Can contain two children including {@link PopoverTrigger} and {@link PopoverSurface}.\n   * Alternatively can only contain {@link PopoverSurface} if using a custom `target`.\n   */\n  children: [JSX.Element, JSX.Element] | JSX.Element;\n};\n\n/**\n * Popover State\n */\nexport type PopoverState = PopoverCommons &\n  Pick<PopoverProps, 'children'> & {\n    /**\n     * Callback to open/close the Popover\n     */\n    setOpen: (e: OpenPopoverEvents, open: boolean) => void;\n    /**\n     * Ref of the PopoverTrigger\n     */\n    triggerRef: React.MutableRefObject<HTMLElement | null>;\n    /**\n     * Ref of the PopoverSurface\n     */\n    contentRef: React.MutableRefObject<HTMLElement | null>;\n    /**\n     * Ref of the pointing arrow\n     */\n    arrowRef: React.MutableRefObject<HTMLDivElement | null>;\n    /**\n     * Anchors the popper to the mouse click for context events\n     */\n    contextTarget: PopperVirtualElement | undefined;\n    /**\n     * A callback to set the target of the popper to the mouse click for context events\n     */\n    setContextTarget: ReturnType<typeof usePopperMouseTarget>[1];\n\n    size: NonNullable<PopoverProps['size']>;\n  };\n\n/**\n * Data attached to open/close events\n */\nexport type OnOpenChangeData = { open: boolean };\n\n/**\n * The supported events that will trigger open/close of the menu\n */\nexport type OpenPopoverEvents =\n  | MouseEvent\n  | TouchEvent\n  | React.MouseEvent<HTMLElement>\n  | React.KeyboardEvent<HTMLElement>\n  | React.FocusEvent<HTMLElement>;\n"]}
+{"version":3,"file":"Popover.types.js","sourceRoot":"../src/","sources":["components/Popover/Popover.types.ts"],"names":[],"mappings":"","sourcesContent":["import * as React from 'react';\nimport type {\n  PositioningVirtualElement,\n  PositioningShorthand,\n  usePositioningMouseTarget,\n} from '@fluentui/react-positioning';\nimport type { PortalProps } from '@fluentui/react-portal';\nimport type { UseModalAttributesOptions } from '@fluentui/react-tabster';\n\n/**\n * Determines popover padding and arrow size\n */\nexport type PopoverSize = 'small' | 'medium' | 'large';\n\n/**\n * Popover Props\n */\nexport type PopoverProps = Pick<PortalProps, 'mountNode'> & {\n  /**\n   * A popover can appear styled with brand or inverted.\n   * When not specified, the default style is used.\n   */\n  appearance?: 'brand' | 'inverted';\n\n  /**\n   * Can contain two children including {@link PopoverTrigger} and {@link PopoverSurface}.\n   * Alternatively can only contain {@link PopoverSurface} if using a custom `target`.\n   */\n  children: [JSX.Element, JSX.Element] | JSX.Element;\n\n  /**\n   * Close when scroll outside of it\n   *\n   * @default false\n   */\n  closeOnScroll?: boolean;\n\n  /**\n   * Used to set the initial open state of the Popover in uncontrolled mode\n   *\n   * @default false\n   */\n  defaultOpen?: boolean;\n\n  /**\n   * Popovers are rendered out of DOM order on `document.body` by default, use this to render the popover in DOM order\n   *\n   * @default false\n   */\n  inline?: boolean;\n\n  /**\n   * Sets the delay for closing popover on mouse leave\n   */\n  mouseLeaveDelay?: number;\n\n  /**\n   * Display an arrow pointing to the target.\n   *\n   * @default false\n   */\n  withArrow?: boolean;\n\n  /**\n   * Call back when the component requests to change value\n   * The `open` value is used as a hint when directly controlling the component\n   */\n  onOpenChange?: (e: OpenPopoverEvents, data: OnOpenChangeData) => void;\n\n  /**\n   * Controls the opening of the Popover\n   *\n   * @default false\n   */\n  open?: boolean;\n\n  /**\n   * Flag to open the Popover as a context menu. Disables all other interactions\n   *\n   * @default false\n   */\n  openOnContext?: boolean;\n\n  /**\n   * Flag to open the Popover by hovering the trigger\n   *\n   * @default false\n   */\n  openOnHover?: boolean;\n\n  /**\n   * Configures the position of the Popover\n   */\n  positioning?: PositioningShorthand;\n\n  /**\n   * Determines popover padding and arrow size\n   *\n   * @default medium\n   */\n  size?: PopoverSize;\n\n  /**\n   * Should trap focus\n   *\n   * @default false\n   */\n  trapFocus?: UseModalAttributesOptions['trapFocus'];\n\n  /**\n   * Must be used with the `trapFocus` prop\n   * Enables older Fluent UI focus trap behavior where the user\n   * cannot tab into the window outside of the document. This is now\n   * non-standard behavior according to the [HTML dialog spec](https://developer.mozilla.org/en-US/docs/Web/API/HTMLDialogElement/showModal)\n   * where the focus trap involves setting outside elements inert.\n   *\n   * @default false\n   */\n  legacyTrapFocus?: UseModalAttributesOptions['legacyTrapFocus'];\n};\n\n/**\n * Popover State\n */\nexport type PopoverState = Pick<\n  PopoverProps,\n  | 'appearance'\n  | 'mountNode'\n  | 'onOpenChange'\n  | 'openOnContext'\n  | 'openOnHover'\n  | 'trapFocus'\n  | 'withArrow'\n  | 'legacyTrapFocus'\n> &\n  Required<Pick<PopoverProps, 'inline' | 'open'>> &\n  Pick<PopoverProps, 'children'> & {\n    /**\n     * Ref of the pointing arrow\n     */\n    arrowRef: React.MutableRefObject<HTMLDivElement | null>;\n\n    /**\n     * Ref of the PopoverSurface\n     */\n    contentRef: React.MutableRefObject<HTMLElement | null>;\n\n    /**\n     * Anchors the popper to the mouse click for context events\n     */\n    contextTarget: PositioningVirtualElement | undefined;\n\n    popoverSurface: React.ReactElement | undefined;\n\n    popoverTrigger: React.ReactElement | undefined;\n\n    /**\n     * A callback to set the target of the popper to the mouse click for context events\n     */\n    setContextTarget: ReturnType<typeof usePositioningMouseTarget>[1];\n\n    /**\n     * Callback to open/close the Popover\n     */\n    setOpen: (e: OpenPopoverEvents, open: boolean) => void;\n\n    size: NonNullable<PopoverProps['size']>;\n\n    /**\n     * Callback to toggle the open state of the Popover\n     */\n    toggleOpen: (e: OpenPopoverEvents) => void;\n\n    /**\n     * Ref of the PopoverTrigger\n     */\n    triggerRef: React.MutableRefObject<HTMLElement | null>;\n  };\n\n/**\n * Data attached to open/close events\n */\nexport type OnOpenChangeData = { open: boolean };\n\n/**\n * The supported events that will trigger open/close of the menu\n */\nexport type OpenPopoverEvents =\n  | MouseEvent\n  | TouchEvent\n  | React.FocusEvent<HTMLElement>\n  | React.KeyboardEvent<HTMLElement>\n  | React.MouseEvent<HTMLElement>;\n"]}

package/lib/components/Popover/constants.js

@@ -0,0 +1,10 @@
+/**
+ * @internal
+ * The default value of the tooltip's border radius (borderRadiusMedium).
+ *
+ * Unfortunately, Popper requires it to be specified as a variable instead of using CSS.
+ * While we could use getComputedStyle, that adds a performance penalty for something that
+ * will likely never change.
+ */
+export const popoverSurfaceBorderRadius = 4;
+//# sourceMappingURL=constants.js.map

package/lib/components/Popover/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"../src/","sources":["components/Popover/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC","sourcesContent":["/**\n * @internal\n * The default value of the tooltip's border radius (borderRadiusMedium).\n *\n * Unfortunately, Popper requires it to be specified as a variable instead of using CSS.\n * While we could use getComputedStyle, that adds a performance penalty for something that\n * will likely never change.\n */\nexport const popoverSurfaceBorderRadius = 4;\n"]}

package/lib/components/Popover/renderPopover.js

@@ -6,34 +6,40 @@ import { PopoverContext } from '../../popoverContext';
 
 export const renderPopover_unstable = state => {
   const {
-    open,
-    setOpen,
-    triggerRef,
+    appearance,
+    arrowRef,
     contentRef,
+    inline,
+    mountNode,
+    open,
     openOnContext,
     openOnHover,
-    mountNode,
-    arrowRef,
+    setOpen,
     size,
-    noArrow,
-    appearance,
-    trapFocus
+    toggleOpen,
+    trapFocus,
+    triggerRef,
+    withArrow,
+    legacyTrapFocus
   } = state;
   return /*#__PURE__*/React.createElement(PopoverContext.Provider, {
     value: {
+      appearance,
+      arrowRef,
+      contentRef,
+      inline,
+      mountNode,
       open,
+      openOnContext,
+      openOnHover,
       setOpen,
+      toggleOpen,
       triggerRef,
-      contentRef,
-      openOnHover,
-      openOnContext,
-      mountNode,
-      arrowRef,
       size,
-      noArrow,
-      appearance,
-      trapFocus
+      trapFocus,
+      legacyTrapFocus,
+      withArrow
     }
-  }, state.children);
+  }, state.popoverTrigger, state.open && state.popoverSurface);
 };
 //# sourceMappingURL=renderPopover.js.map

package/lib/components/Popover/renderPopover.js.map

@@ -1 +1 @@
-{"version":3,"sources":["components/Popover/renderPopover.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,cAAT,QAA+B,sBAA/B;AAGA;;AAEG;;AACH,OAAO,MAAM,sBAAsB,GAAI,KAAD,IAAwB;AAC5D,QAAM;AACJ,IAAA,IADI;AAEJ,IAAA,OAFI;AAGJ,IAAA,UAHI;AAIJ,IAAA,UAJI;AAKJ,IAAA,aALI;AAMJ,IAAA,WANI;AAOJ,IAAA,SAPI;AAQJ,IAAA,QARI;AASJ,IAAA,IATI;AAUJ,IAAA,OAVI;AAWJ,IAAA,UAXI;AAYJ,IAAA;AAZI,MAaF,KAbJ;AAeA,sBACE,KAAA,CAAA,aAAA,CAAC,cAAc,CAAC,QAAhB,EAAwB;AACtB,IAAA,KAAK,EAAE;AACL,MAAA,IADK;AAEL,MAAA,OAFK;AAGL,MAAA,UAHK;AAIL,MAAA,UAJK;AAKL,MAAA,WALK;AAML,MAAA,aANK;AAOL,MAAA,SAPK;AAQL,MAAA,QARK;AASL,MAAA,IATK;AAUL,MAAA,OAVK;AAWL,MAAA,UAXK;AAYL,MAAA;AAZK;AADe,GAAxB,EAgBG,KAAK,CAAC,QAhBT,CADF;AAoBD,CApCM","sourcesContent":["import * as React from 'react';\nimport { PopoverContext } from '../../popoverContext';\nimport type { PopoverState } from './Popover.types';\n\n/**\n * Render the final JSX of Popover\n */\nexport const renderPopover_unstable = (state: PopoverState) => {\n  const {\n    open,\n    setOpen,\n    triggerRef,\n    contentRef,\n    openOnContext,\n    openOnHover,\n    mountNode,\n    arrowRef,\n    size,\n    noArrow,\n    appearance,\n    trapFocus,\n  } = state;\n\n  return (\n    <PopoverContext.Provider\n      value={{\n        open,\n        setOpen,\n        triggerRef,\n        contentRef,\n        openOnHover,\n        openOnContext,\n        mountNode,\n        arrowRef,\n        size,\n        noArrow,\n        appearance,\n        trapFocus,\n      }}\n    >\n      {state.children}\n    </PopoverContext.Provider>\n  );\n};\n"],"sourceRoot":"../src/"}
+{"version":3,"sources":["components/Popover/renderPopover.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,cAAT,QAA+B,sBAA/B;AAGA;;AAEG;;AACH,OAAO,MAAM,sBAAsB,GAAI,KAAD,IAAwB;EAC5D,MAAM;IACJ,UADI;IAEJ,QAFI;IAGJ,UAHI;IAIJ,MAJI;IAKJ,SALI;IAMJ,IANI;IAOJ,aAPI;IAQJ,WARI;IASJ,OATI;IAUJ,IAVI;IAWJ,UAXI;IAYJ,SAZI;IAaJ,UAbI;IAcJ,SAdI;IAeJ;EAfI,IAgBF,KAhBJ;EAkBA,oBACE,KAAA,CAAA,aAAA,CAAC,cAAc,CAAC,QAAhB,EAAwB;IACtB,KAAK,EAAE;MACL,UADK;MAEL,QAFK;MAGL,UAHK;MAIL,MAJK;MAKL,SALK;MAML,IANK;MAOL,aAPK;MAQL,WARK;MASL,OATK;MAUL,UAVK;MAWL,UAXK;MAYL,IAZK;MAaL,SAbK;MAcL,eAdK;MAeL;IAfK;EADe,CAAxB,EAmBG,KAAK,CAAC,cAnBT,EAoBG,KAAK,CAAC,IAAN,IAAc,KAAK,CAAC,cApBvB,CADF;AAwBD,CA3CM","sourcesContent":["import * as React from 'react';\nimport { PopoverContext } from '../../popoverContext';\nimport type { PopoverState } from './Popover.types';\n\n/**\n * Render the final JSX of Popover\n */\nexport const renderPopover_unstable = (state: PopoverState) => {\n  const {\n    appearance,\n    arrowRef,\n    contentRef,\n    inline,\n    mountNode,\n    open,\n    openOnContext,\n    openOnHover,\n    setOpen,\n    size,\n    toggleOpen,\n    trapFocus,\n    triggerRef,\n    withArrow,\n    legacyTrapFocus,\n  } = state;\n\n  return (\n    <PopoverContext.Provider\n      value={{\n        appearance,\n        arrowRef,\n        contentRef,\n        inline,\n        mountNode,\n        open,\n        openOnContext,\n        openOnHover,\n        setOpen,\n        toggleOpen,\n        triggerRef,\n        size,\n        trapFocus,\n        legacyTrapFocus,\n        withArrow,\n      }}\n    >\n      {state.popoverTrigger}\n      {state.open && state.popoverSurface}\n    </PopoverContext.Provider>\n  );\n};\n"],"sourceRoot":"../src/"}

package/lib/components/Popover/usePopover.js

@@ -1,9 +1,11 @@
 import * as React from 'react';
 import { useControllableState, useEventCallback, useOnClickOutside, useOnScrollOutside } from '@fluentui/react-utilities';
-import { useFluent } from '@fluentui/react-shared-contexts';
-import { usePopper, resolvePositioningShorthand, mergeArrowOffset, usePopperMouseTarget } from '@fluentui/react-positioning';
+import { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';
+import { usePositioning, resolvePositioningShorthand, mergeArrowOffset, usePositioningMouseTarget } from '@fluentui/react-positioning';
 import { elementContains } from '@fluentui/react-portal';
+import { useFocusFinders } from '@fluentui/react-tabster';
 import { arrowHeights } from '../PopoverSurface/index';
+import { popoverSurfaceBorderRadius } from './constants';
 /**
  * Create the state required to render Popover.
  *
@@ -14,15 +16,73 @@ import { arrowHeights } from '../PopoverSurface/index';
  */
 
 export const usePopover_unstable = props => {
-  const [contextTarget, setContextTarget] = usePopperMouseTarget();
+  var _a;
+
+  const [contextTarget, setContextTarget] = usePositioningMouseTarget();
   const initialState = {
     size: 'medium',
     contextTarget,
     setContextTarget,
     ...props
   };
-  const [open, setOpen] = useOpenState(initialState);
-  const popperRefs = usePopoverRefs(initialState);
+  const children = React.Children.toArray(props.children);
+
+  if (process.env.NODE_ENV !== 'production') {
+    if (children.length === 0) {
+      // eslint-disable-next-line no-console
+      console.warn('Popover must contain at least one child');
+    }
+
+    if (children.length > 2) {
+      // eslint-disable-next-line no-console
+      console.warn('Popover must contain at most two children');
+    }
+  }
+
+  let popoverTrigger = undefined;
+  let popoverSurface = undefined;
+
+  if (children.length === 2) {
+    popoverTrigger = children[0];
+    popoverSurface = children[1];
+  } else if (children.length === 1) {
+    popoverSurface = children[0];
+  }
+
+  const [open, setOpenState] = useOpenState(initialState);
+  const setOpenTimeoutRef = React.useRef(0);
+  const setOpen = useEventCallback((e, shouldOpen) => {
+    var _a;
+
+    clearTimeout(setOpenTimeoutRef.current);
+
+    if (!(e instanceof Event) && e.persist) {
+      // < React 17 still uses pooled synthetic events
+      e.persist();
+    }
+
+    if (e.type === 'mouseleave') {
+      // FIXME leaking Node timeout type
+      // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+      // @ts-ignore
+      setOpenTimeoutRef.current = setTimeout(() => {
+        setOpenState(e, shouldOpen);
+      }, (_a = props.mouseLeaveDelay) !== null && _a !== void 0 ? _a : 500);
+    } else {
+      setOpenState(e, shouldOpen);
+    }
+  }); // Clear timeout on unmount
+  // Setting state after a component unmounts can cause memory leaks
+
+  React.useEffect(() => {
+    return () => {
+      clearTimeout(setOpenTimeoutRef.current);
+    };
+  }, []);
+  const toggleOpen = React.useCallback(e => {
+    setOpen(e, !open);
+  }, [setOpen, open]);
+  const positioningRefs = usePopoverRefs(initialState);
   const {
     targetDocument
   } = useFluent();
@@ -30,23 +90,37 @@ export const usePopover_unstable = props => {
     contains: elementContains,
     element: targetDocument,
     callback: ev => setOpen(ev, false),
-    refs: [popperRefs.triggerRef, popperRefs.contentRef],
+    refs: [positioningRefs.triggerRef, positioningRefs.contentRef],
     disabled: !open
-  });
+  }); // only close on scroll for context, or when closeOnScroll is specified
+
+  const closeOnScroll = initialState.openOnContext || initialState.closeOnScroll;
   useOnScrollOutside({
     contains: elementContains,
     element: targetDocument,
     callback: ev => setOpen(ev, false),
-    refs: [popperRefs.triggerRef, popperRefs.contentRef],
-    disabled: !open || !initialState.openOnContext // only close on scroll for context
-
+    refs: [positioningRefs.triggerRef, positioningRefs.contentRef],
+    disabled: !open || !closeOnScroll
   });
+  const {
+    findFirstFocusable
+  } = useFocusFinders();
+  React.useEffect(() => {
+    if (open && positioningRefs.contentRef.current) {
+      const firstFocusable = findFirstFocusable(positioningRefs.contentRef.current);
+      firstFocusable === null || firstFocusable === void 0 ? void 0 : firstFocusable.focus();
+    }
+  }, [findFirstFocusable, open, positioningRefs.contentRef]);
   return { ...initialState,
-    ...popperRefs,
+    ...positioningRefs,
+    popoverTrigger,
+    popoverSurface,
     open,
     setOpen,
+    toggleOpen,
     setContextTarget,
-    contextTarget
+    contextTarget,
+    inline: (_a = props.inline) !== null && _a !== void 0 ? _a : false
   };
 };
 /**
@@ -95,26 +169,27 @@ function useOpenState(state) {
 
 
 function usePopoverRefs(state) {
-  const popperOptions = {
+  const positioningOptions = {
     position: 'above',
     align: 'center',
+    arrowPadding: 2 * popoverSurfaceBorderRadius,
     target: state.openOnContext ? state.contextTarget : undefined,
     ...resolvePositioningShorthand(state.positioning)
   }; // no reason to render arrow when covering the target
 
-  if (popperOptions.coverTarget) {
-    state.noArrow = true;
+  if (positioningOptions.coverTarget) {
+    state.withArrow = false;
   }
 
-  if (!state.noArrow) {
-    popperOptions.offset = mergeArrowOffset(popperOptions.offset, arrowHeights[state.size]);
+  if (state.withArrow) {
+    positioningOptions.offset = mergeArrowOffset(positioningOptions.offset, arrowHeights[state.size]);
   }
 
   const {
     targetRef: triggerRef,
     containerRef: contentRef,
     arrowRef
-  } = usePopper(popperOptions);
+  } = usePositioning(positioningOptions);
   return {
     triggerRef,
     contentRef,