react-magma-dom 4.9.0-next.5 → 4.9.0-next.6

package/dist/components/Popover/Popover.d.ts

@@ -0,0 +1,102 @@
+import React from 'react';
+import { ReferenceType } from '@floating-ui/react-dom';
+export declare enum PopoverPosition {
+    bottom = "bottom",
+    top = "top"
+}
+export interface PopoverApi {
+    closePopoverManually(event: any): void;
+}
+export interface PopoverProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Function called when closing the popover menu
+     */
+    onClose?: (event: React.SyntheticEvent) => void;
+    /**
+     * Function called when opening the popover menu
+     */
+    onOpen?: () => void;
+    /**
+     * @internal
+     */
+    testId?: string;
+    /**
+     * Determines the position of the popover relative to its trigger.
+     * @default PopoverPosition.bottom
+     */
+    position?: PopoverPosition;
+    /**
+     * Sets the maximum height of the popover content.
+     * @default 100%
+     */
+    maxHeight?: string | number;
+    /**
+     * Sets the width of the popover.
+     * @default Width of longest menu item
+     */
+    width?: string | number;
+    /**
+     * If true, the popover will remain open when hovered over.
+     * @default false
+     */
+    hoverable?: boolean;
+    /**
+     * If true, the component will have inverse styling to better appear on a dark background
+     * @default false
+     */
+    isInverse?: boolean;
+    /**
+     * If true, the popover will be disabled and cannot be opened.
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * If true, a pointer (arrow) is displayed pointing towards the trigger element.
+     * @default true
+     */
+    hasPointer?: boolean;
+    /**
+     * If true, the popover is open by default when the component is first rendered.
+     * @default false
+     */
+    openByDefault?: boolean;
+    /**
+     * The ref object that allows Popover manipulation.
+     * Actions available:
+     * closePopoverManually(event): void - Closes the popover manually.
+     */
+    apiRef?: React.MutableRefObject<PopoverApi | undefined>;
+    /**
+     * If true, the focus will be trapped within the popover, preventing focus from moving outside.
+     * This is recommended when using interactive elements inside the popover to improve accessibility.
+     * @default false
+     */
+    focusTrap?: boolean;
+}
+export interface PopoverContextInterface {
+    floatingStyles?: React.CSSProperties;
+    position?: PopoverPosition;
+    closePopover?: (event: React.SyntheticEvent | React.KeyboardEvent) => void;
+    popoverTriggerId?: React.MutableRefObject<string>;
+    popoverContentId?: React.MutableRefObject<string>;
+    openPopover?: () => void;
+    isInverse?: boolean;
+    isOpen: boolean;
+    maxHeight?: string;
+    width?: string;
+    contentRef?: any;
+    setIsOpen: React.Dispatch<React.SetStateAction<boolean>>;
+    setFloating?: (node: ReferenceType) => void;
+    setReference?: (node: ReferenceType) => void;
+    arrowRef?: React.MutableRefObject<any>;
+    arrowContext?: any;
+    toggleRef?: any;
+    isDisabled?: boolean;
+    hoverable?: boolean;
+    hasPointer?: boolean;
+    focusTrap?: boolean;
+    hasActiveElements?: boolean;
+}
+export declare const PopoverContext: React.Context<PopoverContextInterface>;
+export declare function hasActiveElementsChecker(ref: any): boolean;
+export declare const Popover: React.ForwardRefExoticComponent<PopoverProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/Popover/PopoverContent.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+export interface PopoverContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * @internal
+     */
+    testId?: string;
+    /**
+     * @children required
+     */
+    children: React.ReactChild | React.ReactChild[];
+}
+export declare const PopoverContent: React.ForwardRefExoticComponent<PopoverContentProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/Popover/PopoverSection.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+export interface PopoverSectionProps {
+    /**
+     * @children required
+     */
+    children: React.ReactChild | React.ReactChild[];
+    /**
+     * @internal
+     */
+    style?: React.CSSProperties;
+}
+export declare const PopoverHeader: ({ children, style, ...other }: PopoverSectionProps) => JSX.Element;
+export declare const PopoverFooter: ({ children, style, ...other }: PopoverSectionProps) => JSX.Element;

package/dist/components/Popover/PopoverTrigger.d.ts

@@ -0,0 +1,37 @@
+import * as React from 'react';
+import { IconProps } from 'react-magma-icons';
+import { Omit, XOR } from '../../utils';
+import { ButtonProps } from '../Button';
+interface IconOnlyPopoverTriggerProps extends Omit<ButtonProps, 'children'> {
+    /**
+     * Icon to display within the component
+     */
+    icon?: React.ReactElement<IconProps>;
+    /**
+     * The text the screen reader will announce. Required for icon-only buttons
+     */
+    'aria-label': string;
+    /**
+     * The tab order of the component when navigating with a keyboard
+     */
+    tabIndex?: number;
+}
+interface IconTextPopoverTriggerProps extends ButtonProps {
+    /**
+     * Icon to display within the component
+     */
+    icon?: React.ReactElement<IconProps>;
+    /**
+     * The content of the component
+     */
+    children: React.ReactChild | React.ReactChild[] | string;
+    /**
+     * The tab order of the component when navigating with a keyboard
+     */
+    tabIndex?: number;
+}
+export declare type PopoverTriggerProps = XOR<IconOnlyPopoverTriggerProps, IconTextPopoverTriggerProps>;
+export declare const PopoverTrigger: React.ForwardRefExoticComponent<({} & IconTextPopoverTriggerProps & React.RefAttributes<HTMLButtonElement>) | ({
+    children?: never;
+} & IconOnlyPopoverTriggerProps & React.RefAttributes<HTMLButtonElement>)>;
+export {};

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

@@ -0,0 +1,4 @@
+export * from './Popover';
+export * from './PopoverTrigger';
+export * from './PopoverContent';
+export * from './PopoverSection';