@fluentui/react-popover 0.0.0-nightly-20220302-0405.1

package/dist/react-popover.d.ts

@@ -0,0 +1,242 @@
+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 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 * as React_2 from 'react';
+import { ReactElement } from 'react';
+import type { Slot } from '@fluentui/react-utilities';
+import type { usePopperMouseTarget } from '@fluentui/react-positioning';
+
+export declare const arrowHeights: Record<PopoverSize, number>;
+
+/**
+ * Data attached to open/close events
+ */
+export declare type OnOpenChangeData = {
+    open: boolean;
+};
+
+/**
+ * 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>;
+
+/**
+ * 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'> & {
+    /**
+     * Controls the opening of the Popover
+     */
+    open: boolean;
+    /**
+     * Used to set the initial open state of the Popover in uncontrolled mode
+     */
+    defaultOpen?: 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
+     */
+    openOnHover?: boolean;
+    /**
+     * Flag to open the Popover as a context menu. Disables all other interactions
+     */
+    openOnContext?: boolean;
+    /**
+     * Do not display the arrow
+     */
+    noArrow?: boolean;
+    /**
+     * 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
+     */
+    trapFocus?: boolean;
+    /**
+     * Configures the position of the Popover
+     */
+    positioning?: PositioningShorthand;
+};
+
+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;
+};
+
+/**
+ * Determines popover padding and arrow size
+ */
+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;
+    /**
+     * Ref of the PopoverTrigger
+     */
+    triggerRef: React_2.MutableRefObject<HTMLElement | 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;
+    /**
+     * A callback to set the target of the popper to the mouse click for context events
+     */
+    setContextTarget: ReturnType<typeof usePopperMouseTarget>[1];
+    size: NonNullable<PopoverProps['size']>;
+};
+
+/**
+ * PopoverSurface component renders react children in a positioned box
+ */
+export declare const PopoverSurface: ForwardRefComponent<PopoverSurfaceProps>;
+
+export declare const popoverSurfaceClassName = "fui-PopoverSurface";
+
+/**
+ * PopoverSurface Props
+ */
+export declare type PopoverSurfaceProps = ComponentProps<PopoverSurfaceSlots>;
+
+/**
+ * Names of the slots in PopoverSurfaceProps
+ */
+export declare type PopoverSurfaceSlots = {
+    root: Slot<'div'>;
+};
+
+/**
+ * PopoverSurface State
+ */
+export declare type PopoverSurfaceState = ComponentState<PopoverSurfaceSlots> & Pick<PopoverContextValue, 'open' | 'mountNode' | 'noArrow' | 'size' | 'appearance' | 'arrowRef'> & {
+    /**
+     * CSS class for the arrow element
+     */
+    arrowClassName?: string;
+};
+
+/**
+ * Wraps a trigger element as an only child and adds the necessary event handling to open a popover.
+ */
+export declare const PopoverTrigger: React_2.FC<PopoverTriggerProps> & FluentTriggerComponent;
+
+export declare type PopoverTriggerChildProps = {
+    ref?: React_2.Ref<never>;
+} & Pick<React_2.HTMLAttributes<HTMLElement>, 'aria-haspopup' | 'onClick' | 'onMouseEnter' | 'onKeyDown' | 'onMouseLeave' | 'onContextMenu'>;
+
+/**
+ * PopoverTrigger Props
+ */
+export declare type PopoverTriggerProps = {
+    children: (React_2.ReactElement & {
+        ref?: React_2.Ref<unknown>;
+    }) | ((props: PopoverTriggerChildProps) => React_2.ReactElement | null);
+};
+
+/**
+ * PopoverTrigger State
+ */
+export declare type PopoverTriggerState = {
+    children: React_2.ReactElement | null;
+};
+
+/**
+ * Render the final JSX of Popover
+ */
+export declare const renderPopover_unstable: (state: PopoverState) => JSX.Element;
+
+/**
+ * Render the final JSX of PopoverSurface
+ */
+export declare const renderPopoverSurface_unstable: (state: PopoverSurfaceState) => JSX.Element | null;
+
+/**
+ * Render the final JSX of PopoverTrigger
+ */
+export declare const renderPopoverTrigger_unstable: (state: PopoverTriggerState) => ReactElement<any, string | JSXElementConstructor<any>> | null;
+
+/**
+ * Create the state required to render Popover.
+ *
+ * The returned state can be modified with hooks such as usePopoverStyles,
+ * before being passed to renderPopover_unstable.
+ *
+ * @param props - props from this instance of Popover
+ */
+export declare const usePopover_unstable: (props: PopoverProps) => PopoverState;
+
+export declare const usePopoverContext_unstable: <T>(selector: ContextSelector<PopoverContextValue, T>) => T;
+
+/**
+ * Create the state required to render PopoverSurface.
+ *
+ * The returned state can be modified with hooks such as usePopoverSurfaceStyles_unstable,
+ * before being passed to renderPopoverSurface_unstable.
+ *
+ * @param props - props from this instance of PopoverSurface
+ * @param ref - reference to root HTMLDivElement of PopoverSurface
+ */
+export declare const usePopoverSurface_unstable: (props: PopoverSurfaceProps, ref: React_2.Ref<HTMLDivElement>) => PopoverSurfaceState;
+
+/**
+ * Apply styling to the PopoverSurface slots based on the state
+ */
+export declare const usePopoverSurfaceStyles_unstable: (state: PopoverSurfaceState) => PopoverSurfaceState;
+
+/**
+ * Create the state required to render PopoverTrigger.
+ *
+ * The returned state can be modified with hooks such as usePopoverTriggerStyles,
+ * before being passed to renderPopoverTrigger_unstable.
+ *
+ * @param props - props from this instance of PopoverTrigger
+ */
+export declare const usePopoverTrigger_unstable: (props: PopoverTriggerProps) => PopoverTriggerState;
+
+export { }

package/lib/Popover.d.ts

@@ -0,0 +1 @@
+export * from './components/Popover/index';

package/lib/Popover.js

@@ -0,0 +1,2 @@
+export * from './components/Popover/index';
+//# sourceMappingURL=Popover.js.map

package/lib/Popover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.js","sourceRoot":"../src/","sources":["Popover.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC","sourcesContent":["export * from './components/Popover/index';\n"]}

package/lib/PopoverSurface.d.ts

@@ -0,0 +1 @@
+export * from './components/PopoverSurface/index';

package/lib/PopoverSurface.js

@@ -0,0 +1,2 @@
+export * from './components/PopoverSurface/index';
+//# sourceMappingURL=PopoverSurface.js.map

package/lib/PopoverSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PopoverSurface.js","sourceRoot":"../src/","sources":["PopoverSurface.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC","sourcesContent":["export * from './components/PopoverSurface/index';\n"]}

package/lib/PopoverTrigger.d.ts

@@ -0,0 +1 @@
+export * from './components/PopoverTrigger/index';

package/lib/PopoverTrigger.js

@@ -0,0 +1,2 @@
+export * from './components/PopoverTrigger/index';
+//# sourceMappingURL=PopoverTrigger.js.map

package/lib/PopoverTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PopoverTrigger.js","sourceRoot":"../src/","sources":["PopoverTrigger.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC","sourcesContent":["export * from './components/PopoverTrigger/index';\n"]}

package/lib/components/Popover/Popover.d.ts

@@ -0,0 +1,6 @@
+import * as React from 'react';
+import type { PopoverProps } from './Popover.types';
+/**
+ * Wrapper component that manages state for a PopoverTrigger and a PopoverSurface components.
+ */
+export declare const Popover: React.FC<PopoverProps>;

package/lib/components/Popover/Popover.js

@@ -0,0 +1,12 @@
+import { usePopover_unstable } from './usePopover';
+import { renderPopover_unstable } from './renderPopover';
+/**
+ * Wrapper component that manages state for a PopoverTrigger and a PopoverSurface components.
+ */
+
+export const Popover = props => {
+  const state = usePopover_unstable(props);
+  return renderPopover_unstable(state);
+};
+Popover.displayName = 'Popover';
+//# sourceMappingURL=Popover.js.map

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

@@ -0,0 +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/"}

package/lib/components/Popover/Popover.types.d.ts

@@ -0,0 +1,103 @@
+import * as React from 'react';
+import type { PopperVirtualElement, PositioningShorthand, usePopperMouseTarget } from '@fluentui/react-positioning';
+import type { PortalProps } from '@fluentui/react-portal';
+/**
+ * Determines popover padding and arrow size
+ */
+export declare type PopoverSize = 'small' | 'medium' | 'large';
+declare type PopoverCommons = Pick<PortalProps, 'mountNode'> & {
+    /**
+     * Controls the opening of the Popover
+     */
+    open: boolean;
+    /**
+     * Used to set the initial open state of the Popover in uncontrolled mode
+     */
+    defaultOpen?: 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
+     */
+    openOnHover?: boolean;
+    /**
+     * Flag to open the Popover as a context menu. Disables all other interactions
+     */
+    openOnContext?: boolean;
+    /**
+     * Do not display the arrow
+     */
+    noArrow?: boolean;
+    /**
+     * 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
+     */
+    trapFocus?: boolean;
+    /**
+     * Configures the position of the Popover
+     */
+    positioning?: PositioningShorthand;
+};
+/**
+ * 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;
+};
+/**
+ * Popover State
+ */
+export declare type PopoverState = PopoverCommons & Pick<PopoverProps, 'children'> & {
+    /**
+     * Callback to open/close the Popover
+     */
+    setOpen: (e: OpenPopoverEvents, open: boolean) => void;
+    /**
+     * Ref of the PopoverTrigger
+     */
+    triggerRef: React.MutableRefObject<HTMLElement | null>;
+    /**
+     * Ref of the PopoverSurface
+     */
+    contentRef: React.MutableRefObject<HTMLElement | null>;
+    /**
+     * Ref of the pointing arrow
+     */
+    arrowRef: React.MutableRefObject<HTMLDivElement | null>;
+    /**
+     * Anchors the popper to the mouse click for context events
+     */
+    contextTarget: PopperVirtualElement | undefined;
+    /**
+     * A callback to set the target of the popper to the mouse click for context events
+     */
+    setContextTarget: ReturnType<typeof usePopperMouseTarget>[1];
+    size: NonNullable<PopoverProps['size']>;
+};
+/**
+ * Data attached to open/close events
+ */
+export declare type OnOpenChangeData = {
+    open: boolean;
+};
+/**
+ * The supported events that will trigger open/close of the menu
+ */
+export declare type OpenPopoverEvents = MouseEvent | TouchEvent | React.MouseEvent<HTMLElement> | React.KeyboardEvent<HTMLElement> | React.FocusEvent<HTMLElement>;
+export {};

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Popover.types.js.map

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

@@ -0,0 +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"]}

package/lib/components/Popover/index.d.ts

@@ -0,0 +1,4 @@
+export * from './Popover';
+export * from './Popover.types';
+export * from './renderPopover';
+export * from './usePopover';

package/lib/components/Popover/index.js

@@ -0,0 +1,5 @@
+export * from './Popover';
+export * from './Popover.types';
+export * from './renderPopover';
+export * from './usePopover';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"../src/","sources":["components/Popover/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC","sourcesContent":["export * from './Popover';\nexport * from './Popover.types';\nexport * from './renderPopover';\nexport * from './usePopover';\n"]}

package/lib/components/Popover/renderPopover.d.ts

@@ -0,0 +1,5 @@
+import type { PopoverState } from './Popover.types';
+/**
+ * Render the final JSX of Popover
+ */
+export declare const renderPopover_unstable: (state: PopoverState) => JSX.Element;

package/lib/components/Popover/renderPopover.js

@@ -0,0 +1,39 @@
+import * as React from 'react';
+import { PopoverContext } from '../../popoverContext';
+/**
+ * Render the final JSX of Popover
+ */
+
+export const renderPopover_unstable = state => {
+  const {
+    open,
+    setOpen,
+    triggerRef,
+    contentRef,
+    openOnContext,
+    openOnHover,
+    mountNode,
+    arrowRef,
+    size,
+    noArrow,
+    appearance,
+    trapFocus
+  } = state;
+  return /*#__PURE__*/React.createElement(PopoverContext.Provider, {
+    value: {
+      open,
+      setOpen,
+      triggerRef,
+      contentRef,
+      openOnHover,
+      openOnContext,
+      mountNode,
+      arrowRef,
+      size,
+      noArrow,
+      appearance,
+      trapFocus
+    }
+  }, state.children);
+};
+//# sourceMappingURL=renderPopover.js.map

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

@@ -0,0 +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/"}

package/lib/components/Popover/usePopover.d.ts

@@ -0,0 +1,10 @@
+import type { PopoverProps, PopoverState } from './Popover.types';
+/**
+ * Create the state required to render Popover.
+ *
+ * The returned state can be modified with hooks such as usePopoverStyles,
+ * before being passed to renderPopover_unstable.
+ *
+ * @param props - props from this instance of Popover
+ */
+export declare const usePopover_unstable: (props: PopoverProps) => PopoverState;

package/lib/components/Popover/usePopover.js

@@ -0,0 +1,124 @@
+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 { elementContains } from '@fluentui/react-portal';
+import { arrowHeights } from '../PopoverSurface/index';
+/**
+ * Create the state required to render Popover.
+ *
+ * The returned state can be modified with hooks such as usePopoverStyles,
+ * before being passed to renderPopover_unstable.
+ *
+ * @param props - props from this instance of Popover
+ */
+
+export const usePopover_unstable = props => {
+  const [contextTarget, setContextTarget] = usePopperMouseTarget();
+  const initialState = {
+    size: 'medium',
+    contextTarget,
+    setContextTarget,
+    ...props
+  };
+  const [open, setOpen] = useOpenState(initialState);
+  const popperRefs = usePopoverRefs(initialState);
+  const {
+    targetDocument
+  } = useFluent();
+  useOnClickOutside({
+    contains: elementContains,
+    element: targetDocument,
+    callback: ev => setOpen(ev, false),
+    refs: [popperRefs.triggerRef, popperRefs.contentRef],
+    disabled: !open
+  });
+  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
+
+  });
+  return { ...initialState,
+    ...popperRefs,
+    open,
+    setOpen,
+    setContextTarget,
+    contextTarget
+  };
+};
+/**
+ * Creates and manages the Popover open state
+ */
+
+function useOpenState(state) {
+  const onOpenChange = useEventCallback((e, data) => {
+    var _a;
+
+    return (_a = state.onOpenChange) === null || _a === void 0 ? void 0 : _a.call(state, e, data);
+  });
+  const [open, setOpenState] = useControllableState({
+    state: state.open,
+    defaultState: state.defaultOpen,
+    initialState: false
+  });
+  state.open = open !== undefined ? open : state.open;
+  const setContextTarget = state.setContextTarget;
+  const setOpen = React.useCallback((e, shouldOpen) => {
+    if (shouldOpen && e.type === 'contextmenu') {
+      setContextTarget(e);
+    }
+
+    if (!shouldOpen) {
+      setContextTarget(undefined);
+    }
+
+    setOpenState(prevOpen => {
+      // More than one event (mouse, focus, keyboard) can request the Popover to close
+      // We assume the first event is the correct one
+      if (prevOpen !== shouldOpen) {
+        onOpenChange === null || onOpenChange === void 0 ? void 0 : onOpenChange(e, {
+          open: shouldOpen
+        });
+      }
+
+      return shouldOpen;
+    });
+  }, [setOpenState, onOpenChange, setContextTarget]);
+  return [open, setOpen];
+}
+/**
+ * Creates and sets the necessary trigger, target and content refs used by Popover
+ */
+
+
+function usePopoverRefs(state) {
+  const popperOptions = {
+    position: 'above',
+    align: 'center',
+    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 (!state.noArrow) {
+    popperOptions.offset = mergeArrowOffset(popperOptions.offset, arrowHeights[state.size]);
+  }
+
+  const {
+    targetRef: triggerRef,
+    containerRef: contentRef,
+    arrowRef
+  } = usePopper(popperOptions);
+  return {
+    triggerRef,
+    contentRef,
+    arrowRef
+  };
+}
+//# sourceMappingURL=usePopover.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["components/Popover/usePopover.ts"],"names":[],"mappings":"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","sourcesContent":["import * as React from 'react';\nimport {\n  useControllableState,\n  useEventCallback,\n  useOnClickOutside,\n  useOnScrollOutside,\n} from '@fluentui/react-utilities';\nimport { useFluent } from '@fluentui/react-shared-contexts';\nimport {\n  usePopper,\n  resolvePositioningShorthand,\n  mergeArrowOffset,\n  usePopperMouseTarget,\n} from '@fluentui/react-positioning';\nimport { elementContains } from '@fluentui/react-portal';\nimport { arrowHeights } from '../PopoverSurface/index';\nimport type { OpenPopoverEvents, PopoverProps, PopoverState } from './Popover.types';\n\n/**\n * Create the state required to render Popover.\n *\n * The returned state can be modified with hooks such as usePopoverStyles,\n * before being passed to renderPopover_unstable.\n *\n * @param props - props from this instance of Popover\n */\nexport const usePopover_unstable = (props: PopoverProps): PopoverState => {\n  const [contextTarget, setContextTarget] = usePopperMouseTarget();\n  const initialState = {\n    size: 'medium',\n    contextTarget,\n    setContextTarget,\n    ...props,\n  } as const;\n\n  const [open, setOpen] = useOpenState(initialState);\n  const popperRefs = usePopoverRefs(initialState);\n\n  const { targetDocument } = useFluent();\n  useOnClickOutside({\n    contains: elementContains,\n    element: targetDocument,\n    callback: ev => setOpen(ev, false),\n    refs: [popperRefs.triggerRef, popperRefs.contentRef],\n    disabled: !open,\n  });\n  useOnScrollOutside({\n    contains: elementContains,\n    element: targetDocument,\n    callback: ev => setOpen(ev, false),\n    refs: [popperRefs.triggerRef, popperRefs.contentRef],\n    disabled: !open || !initialState.openOnContext, // only close on scroll for context\n  });\n\n  return {\n    ...initialState,\n    ...popperRefs,\n    open,\n    setOpen,\n    setContextTarget,\n    contextTarget,\n  };\n};\n\n/**\n * Creates and manages the Popover open state\n */\nfunction useOpenState(\n  state: Pick<PopoverState, 'setContextTarget' | 'onOpenChange'> & Pick<PopoverProps, 'open' | 'defaultOpen'>,\n) {\n  const onOpenChange: PopoverState['onOpenChange'] = useEventCallback((e, data) => state.onOpenChange?.(e, data));\n\n  const [open, setOpenState] = useControllableState({\n    state: state.open,\n    defaultState: state.defaultOpen,\n    initialState: false,\n  });\n  state.open = open !== undefined ? open : state.open;\n  const setContextTarget = state.setContextTarget;\n\n  const setOpen = React.useCallback(\n    (e: OpenPopoverEvents, shouldOpen: boolean) => {\n      if (shouldOpen && e.type === 'contextmenu') {\n        setContextTarget(e as React.MouseEvent);\n      }\n\n      if (!shouldOpen) {\n        setContextTarget(undefined);\n      }\n\n      setOpenState(prevOpen => {\n        // More than one event (mouse, focus, keyboard) can request the Popover to close\n        // We assume the first event is the correct one\n        if (prevOpen !== shouldOpen) {\n          onOpenChange?.(e, { open: shouldOpen });\n        }\n\n        return shouldOpen;\n      });\n    },\n    [setOpenState, onOpenChange, setContextTarget],\n  );\n\n  return [open, setOpen] as const;\n}\n\n/**\n * Creates and sets the necessary trigger, target and content refs used by Popover\n */\nfunction usePopoverRefs(\n  state: Pick<PopoverState, 'size' | 'contextTarget'> & Pick<PopoverProps, 'positioning' | 'openOnContext' | 'noArrow'>,\n) {\n  const popperOptions = {\n    position: 'above' as const,\n    align: 'center' as const,\n    target: state.openOnContext ? state.contextTarget : undefined,\n    ...resolvePositioningShorthand(state.positioning),\n  };\n\n  // no reason to render arrow when covering the target\n  if (popperOptions.coverTarget) {\n    state.noArrow = true;\n  }\n\n  if (!state.noArrow) {\n    popperOptions.offset = mergeArrowOffset(popperOptions.offset, arrowHeights[state.size]);\n  }\n\n  const { targetRef: triggerRef, containerRef: contentRef, arrowRef } = usePopper(popperOptions);\n\n  return {\n    triggerRef,\n    contentRef,\n    arrowRef,\n  } as const;\n}\n"],"sourceRoot":"../src/"}

package/lib/components/PopoverSurface/PopoverSurface.d.ts

@@ -0,0 +1,6 @@
+import type { PopoverSurfaceProps } from './PopoverSurface.types';
+import type { ForwardRefComponent } from '@fluentui/react-utilities';
+/**
+ * PopoverSurface component renders react children in a positioned box
+ */
+export declare const PopoverSurface: ForwardRefComponent<PopoverSurfaceProps>;

package/lib/components/PopoverSurface/PopoverSurface.js

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import { usePopoverSurface_unstable } from './usePopoverSurface';
+import { renderPopoverSurface_unstable } from './renderPopoverSurface';
+import { usePopoverSurfaceStyles_unstable } from './usePopoverSurfaceStyles';
+/**
+ * PopoverSurface component renders react children in a positioned box
+ */
+
+export const PopoverSurface = /*#__PURE__*/React.forwardRef((props, ref) => {
+  const state = usePopoverSurface_unstable(props, ref);
+  usePopoverSurfaceStyles_unstable(state);
+  return renderPopoverSurface_unstable(state);
+});
+PopoverSurface.displayName = 'PopoverSurface';
+//# sourceMappingURL=PopoverSurface.js.map