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

package/lib/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.18.1"
+    }
+  ]
+}

package/lib-commonjs/Popover.d.ts

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

package/lib-commonjs/Popover.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+const tslib_1 = /*#__PURE__*/require("tslib");
+
+tslib_1.__exportStar(require("./components/Popover/index"), exports);
+//# sourceMappingURL=Popover.js.map

package/lib-commonjs/Popover.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["Popover.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,4BAAA,CAAA,EAAA,OAAA","sourcesContent":["export * from './components/Popover/index';\n"],"sourceRoot":"../src/"}

package/lib-commonjs/PopoverSurface.d.ts

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

package/lib-commonjs/PopoverSurface.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+const tslib_1 = /*#__PURE__*/require("tslib");
+
+tslib_1.__exportStar(require("./components/PopoverSurface/index"), exports);
+//# sourceMappingURL=PopoverSurface.js.map

package/lib-commonjs/PopoverSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["PopoverSurface.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,mCAAA,CAAA,EAAA,OAAA","sourcesContent":["export * from './components/PopoverSurface/index';\n"],"sourceRoot":"../src/"}

package/lib-commonjs/PopoverTrigger.d.ts

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

package/lib-commonjs/PopoverTrigger.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+const tslib_1 = /*#__PURE__*/require("tslib");
+
+tslib_1.__exportStar(require("./components/PopoverTrigger/index"), exports);
+//# sourceMappingURL=PopoverTrigger.js.map

package/lib-commonjs/PopoverTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["PopoverTrigger.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,mCAAA,CAAA,EAAA,OAAA","sourcesContent":["export * from './components/PopoverTrigger/index';\n"],"sourceRoot":"../src/"}

package/lib-commonjs/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-commonjs/components/Popover/Popover.js

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Popover = void 0;
+
+const usePopover_1 = /*#__PURE__*/require("./usePopover");
+
+const renderPopover_1 = /*#__PURE__*/require("./renderPopover");
+/**
+ * Wrapper component that manages state for a PopoverTrigger and a PopoverSurface components.
+ */
+
+
+const Popover = props => {
+  const state = usePopover_1.usePopover_unstable(props);
+  return renderPopover_1.renderPopover_unstable(state);
+};
+
+exports.Popover = Popover;
+exports.Popover.displayName = 'Popover';
+//# sourceMappingURL=Popover.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["components/Popover/Popover.tsx"],"names":[],"mappings":";;;;;;;AACA,MAAA,YAAA,gBAAA,OAAA,CAAA,cAAA,CAAA;;AACA,MAAA,eAAA,gBAAA,OAAA,CAAA,iBAAA,CAAA;AAGA;;AAEG;;;AACI,MAAM,OAAO,GAA2B,KAAK,IAAG;AACrD,QAAM,KAAK,GAAG,YAAA,CAAA,mBAAA,CAAoB,KAApB,CAAd;AAEA,SAAO,eAAA,CAAA,sBAAA,CAAuB,KAAvB,CAAP;AACD,CAJM;;AAAM,OAAA,CAAA,OAAA,GAAO,OAAP;AAMb,OAAA,CAAA,OAAA,CAAQ,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-commonjs/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-commonjs/components/Popover/Popover.types.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=Popover.types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","sourceRoot":"../src/"}

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

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

package/lib-commonjs/components/Popover/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+const tslib_1 = /*#__PURE__*/require("tslib");
+
+tslib_1.__exportStar(require("./Popover"), exports);
+
+tslib_1.__exportStar(require("./Popover.types"), exports);
+
+tslib_1.__exportStar(require("./renderPopover"), exports);
+
+tslib_1.__exportStar(require("./usePopover"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["components/Popover/index.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,WAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,iBAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,iBAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,cAAA,CAAA,EAAA,OAAA","sourcesContent":["export * from './Popover';\nexport * from './Popover.types';\nexport * from './renderPopover';\nexport * from './usePopover';\n"],"sourceRoot":"../src/"}

package/lib-commonjs/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-commonjs/components/Popover/renderPopover.js

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.renderPopover_unstable = void 0;
+
+const React = /*#__PURE__*/require("react");
+
+const popoverContext_1 = /*#__PURE__*/require("../../popoverContext");
+/**
+ * Render the final JSX of Popover
+ */
+
+
+const renderPopover_unstable = state => {
+  const {
+    open,
+    setOpen,
+    triggerRef,
+    contentRef,
+    openOnContext,
+    openOnHover,
+    mountNode,
+    arrowRef,
+    size,
+    noArrow,
+    appearance,
+    trapFocus
+  } = state;
+  return React.createElement(popoverContext_1.PopoverContext.Provider, {
+    value: {
+      open,
+      setOpen,
+      triggerRef,
+      contentRef,
+      openOnHover,
+      openOnContext,
+      mountNode,
+      arrowRef,
+      size,
+      noArrow,
+      appearance,
+      trapFocus
+    }
+  }, state.children);
+};
+
+exports.renderPopover_unstable = renderPopover_unstable;
+//# sourceMappingURL=renderPopover.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["components/Popover/renderPopover.tsx"],"names":[],"mappings":";;;;;;;AAAA,MAAA,KAAA,gBAAA,OAAA,CAAA,OAAA,CAAA;;AACA,MAAA,gBAAA,gBAAA,OAAA,CAAA,sBAAA,CAAA;AAGA;;AAEG;;;AACI,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,SACE,KAAA,CAAA,aAAA,CAAC,gBAAA,CAAA,cAAA,CAAe,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;;AAAM,OAAA,CAAA,sBAAA,GAAsB,sBAAtB","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-commonjs/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-commonjs/components/Popover/usePopover.js

@@ -0,0 +1,139 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.usePopover_unstable = void 0;
+
+const React = /*#__PURE__*/require("react");
+
+const react_utilities_1 = /*#__PURE__*/require("@fluentui/react-utilities");
+
+const react_shared_contexts_1 = /*#__PURE__*/require("@fluentui/react-shared-contexts");
+
+const react_positioning_1 = /*#__PURE__*/require("@fluentui/react-positioning");
+
+const react_portal_1 = /*#__PURE__*/require("@fluentui/react-portal");
+
+const index_1 = /*#__PURE__*/require("../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
+ */
+
+
+const usePopover_unstable = props => {
+  const [contextTarget, setContextTarget] = react_positioning_1.usePopperMouseTarget();
+  const initialState = {
+    size: 'medium',
+    contextTarget,
+    setContextTarget,
+    ...props
+  };
+  const [open, setOpen] = useOpenState(initialState);
+  const popperRefs = usePopoverRefs(initialState);
+  const {
+    targetDocument
+  } = react_shared_contexts_1.useFluent();
+  react_utilities_1.useOnClickOutside({
+    contains: react_portal_1.elementContains,
+    element: targetDocument,
+    callback: ev => setOpen(ev, false),
+    refs: [popperRefs.triggerRef, popperRefs.contentRef],
+    disabled: !open
+  });
+  react_utilities_1.useOnScrollOutside({
+    contains: react_portal_1.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
+  };
+};
+
+exports.usePopover_unstable = usePopover_unstable;
+/**
+ * Creates and manages the Popover open state
+ */
+
+function useOpenState(state) {
+  const onOpenChange = react_utilities_1.useEventCallback((e, data) => {
+    var _a;
+
+    return (_a = state.onOpenChange) === null || _a === void 0 ? void 0 : _a.call(state, e, data);
+  });
+  const [open, setOpenState] = react_utilities_1.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,
+    ...react_positioning_1.resolvePositioningShorthand(state.positioning)
+  }; // no reason to render arrow when covering the target
+
+  if (popperOptions.coverTarget) {
+    state.noArrow = true;
+  }
+
+  if (!state.noArrow) {
+    popperOptions.offset = react_positioning_1.mergeArrowOffset(popperOptions.offset, index_1.arrowHeights[state.size]);
+  }
+
+  const {
+    targetRef: triggerRef,
+    containerRef: contentRef,
+    arrowRef
+  } = react_positioning_1.usePopper(popperOptions);
+  return {
+    triggerRef,
+    contentRef,
+    arrowRef
+  };
+}
+//# sourceMappingURL=usePopover.js.map

package/lib-commonjs/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-commonjs/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-commonjs/components/PopoverSurface/PopoverSurface.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PopoverSurface = void 0;
+
+const React = /*#__PURE__*/require("react");
+
+const usePopoverSurface_1 = /*#__PURE__*/require("./usePopoverSurface");
+
+const renderPopoverSurface_1 = /*#__PURE__*/require("./renderPopoverSurface");
+
+const usePopoverSurfaceStyles_1 = /*#__PURE__*/require("./usePopoverSurfaceStyles");
+/**
+ * PopoverSurface component renders react children in a positioned box
+ */
+
+
+exports.PopoverSurface = /*#__PURE__*/React.forwardRef((props, ref) => {
+  const state = usePopoverSurface_1.usePopoverSurface_unstable(props, ref);
+  usePopoverSurfaceStyles_1.usePopoverSurfaceStyles_unstable(state);
+  return renderPopoverSurface_1.renderPopoverSurface_unstable(state);
+});
+exports.PopoverSurface.displayName = 'PopoverSurface';
+//# sourceMappingURL=PopoverSurface.js.map

package/lib-commonjs/components/PopoverSurface/PopoverSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["components/PopoverSurface/PopoverSurface.tsx"],"names":[],"mappings":";;;;;;;AAAA,MAAA,KAAA,gBAAA,OAAA,CAAA,OAAA,CAAA;;AACA,MAAA,mBAAA,gBAAA,OAAA,CAAA,qBAAA,CAAA;;AACA,MAAA,sBAAA,gBAAA,OAAA,CAAA,wBAAA,CAAA;;AACA,MAAA,yBAAA,gBAAA,OAAA,CAAA,2BAAA,CAAA;AAIA;;AAEG;;;AACU,OAAA,CAAA,cAAA,gBAA2D,KAAK,CAAC,UAAN,CAAiB,CAAC,KAAD,EAAQ,GAAR,KAAe;AACtG,QAAM,KAAK,GAAG,mBAAA,CAAA,0BAAA,CAA2B,KAA3B,EAAkC,GAAlC,CAAd;AAEA,EAAA,yBAAA,CAAA,gCAAA,CAAiC,KAAjC;AACA,SAAO,sBAAA,CAAA,6BAAA,CAA8B,KAA9B,CAAP;AACD,CALuE,CAA3D;AAOb,OAAA,CAAA,cAAA,CAAe,WAAf,GAA6B,gBAA7B","sourcesContent":["import * as React from 'react';\nimport { usePopoverSurface_unstable } from './usePopoverSurface';\nimport { renderPopoverSurface_unstable } from './renderPopoverSurface';\nimport { usePopoverSurfaceStyles_unstable } from './usePopoverSurfaceStyles';\nimport type { PopoverSurfaceProps } from './PopoverSurface.types';\nimport type { ForwardRefComponent } from '@fluentui/react-utilities';\n\n/**\n * PopoverSurface component renders react children in a positioned box\n */\nexport const PopoverSurface: ForwardRefComponent<PopoverSurfaceProps> = React.forwardRef((props, ref) => {\n  const state = usePopoverSurface_unstable(props, ref);\n\n  usePopoverSurfaceStyles_unstable(state);\n  return renderPopoverSurface_unstable(state);\n});\n\nPopoverSurface.displayName = 'PopoverSurface';\n"],"sourceRoot":"../src/"}

package/lib-commonjs/components/PopoverSurface/PopoverSurface.types.d.ts

@@ -0,0 +1,21 @@
+import type { ComponentProps, ComponentState, Slot } from '@fluentui/react-utilities';
+import type { PopoverContextValue } from '../../popoverContext';
+/**
+ * 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;
+};

package/lib-commonjs/components/PopoverSurface/PopoverSurface.types.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=PopoverSurface.types.js.map

package/lib-commonjs/components/PopoverSurface/PopoverSurface.types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","sourceRoot":"../src/"}

package/lib-commonjs/components/PopoverSurface/index.d.ts

@@ -0,0 +1,5 @@
+export * from './PopoverSurface';
+export * from './PopoverSurface.types';
+export * from './renderPopoverSurface';
+export * from './usePopoverSurface';
+export * from './usePopoverSurfaceStyles';

package/lib-commonjs/components/PopoverSurface/index.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+const tslib_1 = /*#__PURE__*/require("tslib");
+
+tslib_1.__exportStar(require("./PopoverSurface"), exports);
+
+tslib_1.__exportStar(require("./PopoverSurface.types"), exports);
+
+tslib_1.__exportStar(require("./renderPopoverSurface"), exports);
+
+tslib_1.__exportStar(require("./usePopoverSurface"), exports);
+
+tslib_1.__exportStar(require("./usePopoverSurfaceStyles"), exports);
+//# sourceMappingURL=index.js.map

package/lib-commonjs/components/PopoverSurface/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["components/PopoverSurface/index.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,kBAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,wBAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,wBAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,qBAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,2BAAA,CAAA,EAAA,OAAA","sourcesContent":["export * from './PopoverSurface';\nexport * from './PopoverSurface.types';\nexport * from './renderPopoverSurface';\nexport * from './usePopoverSurface';\nexport * from './usePopoverSurfaceStyles';\n"],"sourceRoot":"../src/"}

package/lib-commonjs/components/PopoverSurface/renderPopoverSurface.d.ts

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

package/lib-commonjs/components/PopoverSurface/renderPopoverSurface.js

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.renderPopoverSurface_unstable = void 0;
+
+const React = /*#__PURE__*/require("react");
+
+const react_portal_1 = /*#__PURE__*/require("@fluentui/react-portal");
+
+const react_utilities_1 = /*#__PURE__*/require("@fluentui/react-utilities");
+/**
+ * Render the final JSX of PopoverSurface
+ */
+
+
+const renderPopoverSurface_unstable = state => {
+  const {
+    slots,
+    slotProps
+  } = react_utilities_1.getSlots(state); // TODO should hidden Popovers be supported ?
+
+  if (!state.open) {
+    return null;
+  }
+
+  return React.createElement(react_portal_1.Portal, {
+    mountNode: state.mountNode
+  }, React.createElement(slots.root, { ...slotProps.root
+  }, !state.noArrow && React.createElement("div", {
+    ref: state.arrowRef,
+    className: state.arrowClassName
+  }), slotProps.root.children));
+};
+
+exports.renderPopoverSurface_unstable = renderPopoverSurface_unstable;
+//# sourceMappingURL=renderPopoverSurface.js.map

package/lib-commonjs/components/PopoverSurface/renderPopoverSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["components/PopoverSurface/renderPopoverSurface.tsx"],"names":[],"mappings":";;;;;;;AAAA,MAAA,KAAA,gBAAA,OAAA,CAAA,OAAA,CAAA;;AACA,MAAA,cAAA,gBAAA,OAAA,CAAA,wBAAA,CAAA;;AACA,MAAA,iBAAA,gBAAA,OAAA,CAAA,2BAAA,CAAA;AAGA;;AAEG;;;AACI,MAAM,6BAA6B,GAAI,KAAD,IAA+B;AAC1E,QAAM;AAAE,IAAA,KAAF;AAAS,IAAA;AAAT,MAAuB,iBAAA,CAAA,QAAA,CAA8B,KAA9B,CAA7B,CAD0E,CAG1E;;AACA,MAAI,CAAC,KAAK,CAAC,IAAX,EAAiB;AACf,WAAO,IAAP;AACD;;AAED,SACE,KAAA,CAAA,aAAA,CAAC,cAAA,CAAA,MAAD,EAAO;AAAC,IAAA,SAAS,EAAE,KAAK,CAAC;AAAlB,GAAP,EACE,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,IAAP,EAAW,EAAA,GAAK,SAAS,CAAC;AAAf,GAAX,EACG,CAAC,KAAK,CAAC,OAAP,IAAkB,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA;AAAK,IAAA,GAAG,EAAE,KAAK,CAAC,QAAhB;AAA0B,IAAA,SAAS,EAAE,KAAK,CAAC;AAA3C,GAAA,CADrB,EAEG,SAAS,CAAC,IAAV,CAAe,QAFlB,CADF,CADF;AAQD,CAhBM;;AAAM,OAAA,CAAA,6BAAA,GAA6B,6BAA7B","sourcesContent":["import * as React from 'react';\nimport { Portal } from '@fluentui/react-portal';\nimport { getSlots } from '@fluentui/react-utilities';\nimport type { PopoverSurfaceSlots, PopoverSurfaceState } from './PopoverSurface.types';\n\n/**\n * Render the final JSX of PopoverSurface\n */\nexport const renderPopoverSurface_unstable = (state: PopoverSurfaceState) => {\n  const { slots, slotProps } = getSlots<PopoverSurfaceSlots>(state);\n\n  // TODO should hidden Popovers be supported ?\n  if (!state.open) {\n    return null;\n  }\n\n  return (\n    <Portal mountNode={state.mountNode}>\n      <slots.root {...slotProps.root}>\n        {!state.noArrow && <div ref={state.arrowRef} className={state.arrowClassName} />}\n        {slotProps.root.children}\n      </slots.root>\n    </Portal>\n  );\n};\n"],"sourceRoot":"../src/"}

package/lib-commonjs/components/PopoverSurface/usePopoverSurface.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+import type { PopoverSurfaceProps, PopoverSurfaceState } from './PopoverSurface.types';
+/**
+ * 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.Ref<HTMLDivElement>) => PopoverSurfaceState;