@muraldevkit/ui-toolkit 4.36.2-dev-4Aa1.1 → 4.37.0

package/dist/components/popover/MrlPopover/MrlPopover.d.ts

@@ -1,6 +1,9 @@
 import * as React from 'react';
 import { PortalProps } from '../../';
 import { MenuPosition, MenuAlignment, ActionState, CustomMenuPosition } from '../../menu/constants';
+type RenderPropFn = ({ closeMenu }: {
+    closeMenu: () => void;
+}) => JSX.Element;
 export interface MrlPopoverProps {
     /**
      * Set initial state of menu
@@ -13,7 +16,7 @@ export interface MrlPopoverProps {
     /** ID of element to associate a label */
     ariaLabelledBy?: string;
     /** Children to be rendered within the menu component*/
-    children: React.ReactNode;
+    children: React.ReactNode | RenderPropFn;
     /** Custom class names for the popover */
     className?: string;
     /** Custom position for the menu */
@@ -126,3 +129,4 @@ export declare function MrlPopover({ alignment, ariaLabel, ariaLabelledBy, child
 export declare namespace MrlPopover {
     var componentType: string;
 }
+export {};

package/dist/components/popover/MrlPopover/context/MrlPopoverContext.d.ts

@@ -0,0 +1,20 @@
+import * as React from 'react';
+type MrlPopoverContext = {
+    /**
+     * Close menu is shared in context to allow for closing the popover from a child component
+     *
+     * @returns {void}
+     */
+    closeMenu: () => void;
+};
+/**
+ * Adds context for the MrlPopover component
+ */
+export declare const MrlPopoverContext: React.Context<MrlPopoverContext | undefined>;
+/**
+ * Returns the MrlPopoverContext state.
+ *
+ * @returns The MrlPopoverContext state.
+ */
+export declare const useMrlPopoverContext: () => MrlPopoverContext;
+export {};

package/dist/components/popover/MrlPopover/hooks/use-mrl-popover-event-handlers.d.ts

@@ -0,0 +1,32 @@
+import * as React from 'react';
+import { ActionState } from '../../../menu';
+import { MrlPopoverProps } from '../MrlPopover';
+type UseMrlPopoverEventHandlersOptions = {
+    closeMenu: () => void;
+    isSubMenu: MrlPopoverProps['isSubMenu'];
+    disableFocusTrap: MrlPopoverProps['disableFocusTrap'];
+    disableClickToOpen: MrlPopoverProps['disableClickToOpen'];
+    hasCloseButton: MrlPopoverProps['hasCloseButton'];
+    interactiveElements: HTMLElement[];
+    menuRef: React.RefObject<HTMLDivElement>;
+    state: ActionState;
+    setState: React.Dispatch<React.SetStateAction<ActionState>>;
+    triggerRef: MrlPopoverProps['triggerRef'];
+};
+type UseMrlPopoverEventHandlersReturn = {
+    handleClose: (e: React.KeyboardEvent<HTMLButtonElement>) => void;
+    handleMenuKey: (e: React.KeyboardEvent) => void;
+    handleTriggerSiblingKey: (e: KeyboardEvent) => void;
+    hideMenuHover: (e: Event) => void;
+    showMenuHover: () => void;
+    toggleMenuKey: (e: KeyboardEvent) => void;
+    toggleMenuMouse: () => void;
+};
+/**
+ * Creates all of the required event handlers for the MrlPopover component
+ *
+ * @param options configuration options
+ * @returns all of the required event handlers
+ */
+export declare const useMrlPopoverEventHandlers: ({ closeMenu, isSubMenu, disableFocusTrap, disableClickToOpen, hasCloseButton, interactiveElements, menuRef, state, setState, triggerRef }: UseMrlPopoverEventHandlersOptions) => UseMrlPopoverEventHandlersReturn;
+export {};

package/dist/components/popover/MrlPopover/index.d.ts

@@ -1 +1,2 @@
 export * from './MrlPopover';
+export * from './utilities';

package/dist/components/popover/MrlPopover/utilities/get-data-point.d.ts

@@ -0,0 +1,9 @@
+import { MenuAlignment } from '../../../menu';
+/**
+ * Returns the data-point attribute for the popover pointer
+ *
+ * @param position - position of the menu
+ * @param alignment - alignment of the menu
+ * @returns - data-point attribute value
+ */
+export declare const getDataPoint: (position: string, alignment: MenuAlignment) => string;

package/dist/components/popover/MrlPopover/utilities/get-offset.d.ts

@@ -0,0 +1,9 @@
+import { MenuPosition } from '../../../menu';
+/**
+ * Returns a value in PX for the offset of the popover from the menu at different positions
+ *
+ * @param position - position of the menu
+ * @param point - if the menu has a pointer
+ * @returns - offset in PX
+ */
+export declare const getOffset: (position: MenuPosition, point: boolean) => number;

package/dist/components/popover/MrlPopover/utilities/index.d.ts

@@ -0,0 +1,2 @@
+export * from './get-data-point';
+export * from './get-offset';