@iress-oss/ids-components 0.0.1-dev.9 → 5.13.1

package/dist/src/components/Menu/hooks/useMenuComposite.d.ts

@@ -0,0 +1,18 @@
+import { MenuRoles } from '..';
+/**
+ * Helps the consuming component decide whether the Menu needs to use Floating UI Composite components.
+ * Floating UI composite components manage the keyboard navigation of the menu.
+ *
+ * Scenarios
+ * - If the role is menu or listbox and not inside a popover, it will return true
+ * - If it is any other role, or used inside a popover which uses hooks to do keyboard navigation, it will return false
+ *
+ * See: https://floating-ui.com/docs/Composite
+ * Also see: https://floating-ui.com/docs/useListNavigation
+ *
+ * TODO: Change to a helper and pass popover and menu as arguments
+ *
+ * @param {MenuRoles} role The role set by the consumer, this may be overridden depending on popover context.
+ * @returns {boolean}
+ */
+export declare const useMenuComposite: (role?: MenuRoles) => boolean;

package/dist/src/components/Menu/hooks/useMenuRole.d.ts

@@ -0,0 +1,12 @@
+import { MenuRoles } from '../Menu.types';
+/**
+ * Create the role that the menu will be rendered with.
+ * Inside a popover, the menu will adopt the type of the popover when applicable.
+ *
+ * TODO: Change to a helper and pass popover as an argument
+ *
+ * @param {boolean} multiSelect Whether its a multiSelect menu
+ * @param {MenuRoles} roleProp The role set by the consumer, this may be overridden depending on popover context.
+ * @returns {MenuRoles}
+ */
+export declare const useMenuRole: (multiSelect?: boolean, roleProp?: MenuRoles) => MenuRoles;

package/dist/src/components/Menu/hooks/useMenuStyles.d.ts

@@ -0,0 +1,11 @@
+import { MenuStylesHookProps, MenuStylesHookReturn } from '..';
+/**
+ * Create the class names used to style the menu.
+ * Inside a popover the menu will be fluid by default.
+ *
+ * TODO: Change to a helper and pass popover as an argument from the consuming component.
+ *
+ * @param {MenuStylesHookProps} props A subset of `IressMenuProps` that decide the styling of the component.
+ * @returns {MenuStylesHookReturn}
+ */
+export declare const useMenuStyles: ({ className, fluid, layout, role, }: MenuStylesHookProps) => MenuStylesHookReturn;

package/dist/src/components/Menu/index.d.ts

@@ -0,0 +1,13 @@
+export * from './Menu';
+export * from './Menu.types';
+export * from './MenuDivider/MenuDivider';
+export * from './MenuHeading/MenuHeading';
+export * from './MenuText/MenuText';
+export * from './MenuItem/MenuItem';
+export * from './MenuItem/MenuItem.types';
+export * from './MenuItem/hooks/useMenuItemAria';
+export * from './MenuItem/hooks/useMenuItemButtonProps';
+export * from './MenuItem/hooks/useMenuItemComposite';
+export * from './MenuItem/hooks/useMenuItemInteractions';
+export * from './MenuItem/hooks/useMenuItemRole';
+export * from './helpers/mapMenuItems';

package/dist/src/components/Modal/Modal.d.ts

@@ -0,0 +1,2 @@
+import { ModalWithEnums } from './Modal.types';
+export declare const IressModal: ModalWithEnums;

package/dist/src/components/Modal/Modal.types.d.ts

@@ -0,0 +1,101 @@
+import { PropsWithChildren, ReactElement, ReactNode } from 'react';
+import { IressHTMLAttributes, ResponsiveSizing } from '../../interfaces';
+import { ModalSize, PaddingSize } from '../../enums';
+import { FloatingUIContainer, PaddingSizes } from '../../types';
+export interface IressModalProps extends IressHTMLAttributes {
+    /**
+     * Text to be displayed inside the modal.
+     */
+    children?: ReactNode;
+    /**
+     * Screenreader text for close button.
+     * @default Close
+     */
+    closeText?: string;
+    /**
+     * The container element to render the modal into.
+     * By default, the modal will render at the end of the document body.
+     */
+    container?: FloatingUIContainer;
+    /**
+     * When set to `true` the modal will be visible by default. Use for uncontrolled modals.
+     */
+    defaultShow?: boolean;
+    /**
+     * When set to `true`, users cannot exit the modal by clicking the backdrop or using the escape key.
+     */
+    disableBackdropClick?: boolean;
+    /**
+     * When set to `true` the modal's footer will always be visible and fixed to the bottom of the modal.
+     */
+    fixedFooter?: boolean;
+    /**
+     * Panel to place modal controls.
+     */
+    footer?: ReactNode;
+    /**
+     * Sets the heading for the modal.
+     * If passed an element, it will render the element with an id, to ensure its connection to the modal.
+     */
+    heading?: ReactElement | string;
+    /**
+     * Unique ID for the modal. Use if you would like to open this modal from anywhere in your app using the `useModal` hook.
+     */
+    id?: string;
+    /**
+     * When set to `true`, no close button will be rendered. You must add your own closing mechanism to ensure accessibility.
+     */
+    noCloseButton?: boolean;
+    /**
+     * Emitted when the modal has opened or closed internally. Use for controlled modals.
+     */
+    onShowChange?: (show: boolean) => void;
+    /**
+     * Emitted when the modal has opened.
+     */
+    onEntered?: () => void;
+    /**
+     * Emitted when the modal has closed.
+     */
+    onExited?: () => void;
+    /**
+     * Sets the padding of the wrapping panel component
+     * @default md
+     */
+    padding?: PaddingSize | PaddingSizes;
+    /**
+     * When set to `true` the modal will be visible. Use for controlled modals.
+     */
+    show?: boolean;
+    /**
+     * Accepts a `string` or `{ xs: sm }` (for responsive sizing) of `ModalSizes` options.
+     * @default md
+     */
+    size?: ModalSize | ResponsiveSizing<ModalSize | ModalSizes> | ModalSizes;
+    /**
+     * When set to `true`, the modal will act like a static element when open.
+     * This means it will not lock scroll or focus within the modal.
+     * Note: This is used internally to display modals in Styler. It is not recommended to use this prop in your own applications.
+     */
+    static?: boolean;
+}
+export interface IressModalProviderProps extends PropsWithChildren {
+    /**
+     * The container element to render the modal into.
+     * By default, the modal will render at the end of the document body.
+     */
+    container?: FloatingUIContainer;
+}
+export interface IressModalContextValue {
+    opened: string[];
+    container?: FloatingUIContainer;
+    showModal: (id: string, flag?: boolean) => void;
+}
+export declare const MODAL_SIZES: readonly ["sm", "md", "lg", "fullpage"];
+export type ModalSizes = (typeof MODAL_SIZES)[number];
+export interface ModalWithEnums extends React.FC<IressModalProps> {
+    /** @deprecated IressModal.Size enum is now deprecated and will be removed in a future version. Please use the value directly instead. **/
+    Size: typeof ModalSize;
+    /** @deprecated IressModal.Padding enum is now deprecated and will be removed in a future version. Please use the value directly instead. **/
+    Padding: typeof PaddingSize;
+}

package/dist/src/components/Modal/ModalProvider.d.ts

@@ -0,0 +1,3 @@
+import { IressModalContextValue, IressModalProviderProps } from './Modal.types';
+export declare const IressModalContext: import('react').Context<IressModalContextValue | undefined>;
+export declare const IressModalProvider: ({ children, container, }: IressModalProviderProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/Modal/hooks/useIDSProvidedModal.d.ts

@@ -0,0 +1,5 @@
+export declare function useIDSProvidedModal(id?: string): {
+    opened: boolean | "" | undefined;
+    container: import('../../../types').FloatingUIContainer | undefined;
+    show: (open?: boolean) => void | "" | undefined;
+};

package/dist/src/components/Modal/hooks/useModal.d.ts

@@ -0,0 +1,3 @@
+export declare const useModal: () => {
+    showModal: (id: string, flag?: boolean) => void;
+};

package/dist/src/components/Modal/index.d.ts

@@ -0,0 +1,4 @@
+export * from './Modal.types';
+export * from './Modal';
+export * from './ModalProvider';
+export * from './hooks/useModal';

package/dist/src/components/Navbar/Navbar.d.ts

@@ -0,0 +1,2 @@
+import { NavbarWithEnums } from './Navbar.types';
+export declare const IressNavbar: NavbarWithEnums;

package/dist/src/components/Navbar/Navbar.types.d.ts

@@ -0,0 +1,65 @@
+import { ReactNode } from 'react';
+import { IressHTMLAttributes } from '../../interfaces';
+import { Breakpoint } from '../../enums';
+import { Breakpoints } from '../../types';
+export interface IressNavbarProps extends IressHTMLAttributes {
+    /**
+     * Sets the breakpoint at which the main nav content is hidden, and replaced by a hamburger menu. If not set, the navbar won't be responsive.
+     */
+    breakpoint?: Breakpoint | Breakpoints;
+    /**
+     * Content to be rendered inside the navbar (e.g. navigation links).
+     */
+    children?: ReactNode;
+    /**
+     * Fixes the navbar with relation to the viewport if true. If false, the navbar will scroll out of view when the user scrolls.
+     */
+    fixed?: boolean;
+    /**
+     * When navbar is fixed, elements that are obscured by the fixed navbar are scrolled into view when they receive focus.
+     */
+    handledFocus?: boolean;
+    /**
+     * Sets the url of the home link
+     */
+    homeUrl?: string;
+    /**
+     * Sets the alignment of the nav; either start (all left-aligned), between (children slot left-aligned and nav slot right-aligned) or end (all right-aligned)
+     */
+    horizontalAlign?: NavbarHorizontalAlign | NavbarHorizontalAligns;
+    /**
+     * Content for the logo slot.
+     */
+    logo?: ReactNode;
+    /**
+     * Adds alt text to the logo's <img>
+     * @deprecated Use `logo` instead, and `alt` text to your img.
+     */
+    logoAltText?: string;
+    /**
+     * Sets the source url of the logo
+     * @deprecated Use `logo` instead with the proper `src` attribute.
+     */
+    logoSrc?: string;
+    /**
+     * Content for the nav slot.
+     */
+    nav?: ReactNode;
+    /**
+     * The name of the nav element (used by screen reader users). The nav element is wrapped around any content in the Nav slot
+     */
+    navLabel?: string;
+}
+/** @deprecated NavbarHorizontalAlign enum is now deprecated and will be removed in a future version. Please use the NavbarHorizontalAligns type instead. **/
+export declare enum NavbarHorizontalAlign {
+    Between = "between",
+    End = "end",
+    Start = "start"
+}
+export type NavbarHorizontalAligns = 'between' | 'end' | 'start';
+export interface NavbarWithEnums extends React.FC<IressNavbarProps> {
+    /** @deprecated IressNavbar.Layout enum is now deprecated and will be removed in a future version. Please use the value directly instead. **/
+    HorizontalAlign: typeof NavbarHorizontalAlign;
+    /** @deprecated IressNavbar.Breakpoint enum is now deprecated and will be removed in a future version. Please use the value directly. **/
+    Breakpoint: typeof Breakpoint;
+}

package/dist/src/components/Navbar/components/HomeLinkContent.d.ts

@@ -0,0 +1,7 @@
+export declare const HomeLinkContent: ({ logoSrc, logoFound, logoAltText, onError, dataTestid, }: {
+    logoSrc: string;
+    logoFound: boolean;
+    logoAltText: string;
+    onError: () => void;
+    dataTestid?: string;
+}) => import("react/jsx-runtime").JSX.Element | null;

package/dist/src/components/Navbar/components/LogoFromSrc.d.ts

@@ -0,0 +1,6 @@
+export declare const LogoFromSrc: ({ logoSrc, logoAltText, onError, dataTestid, }: {
+    logoSrc: string;
+    logoAltText: string;
+    onError: () => void;
+    dataTestid?: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/Navbar/components/NavbarLogo.d.ts

@@ -0,0 +1,8 @@
+export declare const NavbarLogo: ({ homeUrl, logoSrc, logoFound, logoAltText, onError, dataTestid, }: {
+    homeUrl: string;
+    logoSrc: string;
+    logoFound: boolean;
+    logoAltText: string;
+    onError: () => void;
+    dataTestid?: string;
+}) => import("react/jsx-runtime").JSX.Element | null;

package/dist/src/components/Navbar/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Navbar.types';
+export * from './Navbar';

package/dist/src/components/Panel/Panel.d.ts

@@ -0,0 +1,2 @@
+import { PanelWithEnums } from './Panel.types';
+export declare const IressPanel: PanelWithEnums;

package/dist/src/components/Panel/Panel.types.d.ts

@@ -0,0 +1,59 @@
+import { VariablePaddingSize, ResponsiveSizing } from '../../interfaces';
+import { MixedPaddingSize, PaddingSizes, TextAligns } from '../../types';
+import { PaddingSize, TextAlign } from '../../enums';
+import { ReactNode } from 'react';
+export interface IressPanelProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Panel background - controls the background style (set via the theme).
+     */
+    background?: PanelBackground | PanelBackgrounds;
+    /**
+     * Content to be grouped using a panel.
+     */
+    children?: ReactNode;
+    /**
+     * Setting to true will ignore the border radius set in the theme and set it to zero.
+     */
+    noBorderRadius?: boolean;
+    /**
+     * Removes bottom margin from last child of the panel element if true.
+     */
+    noGutter?: boolean;
+    /**
+     * Padding of the panel.
+     */
+    padding?: PaddingSize | PaddingSizes | VariablePaddingSize | ResponsiveSizing<MixedPaddingSize>;
+    /**
+     * If `true`, the panel background will fill the height of the container.
+     */
+    stretch?: boolean;
+    /**
+     * Text alignment for panel.
+     */
+    textAlign?: TextAlign | TextAligns;
+}
+export interface PanelWithEnums extends React.FC<IressPanelProps> {
+    /** @deprecated IressPanel.Background is now deprecated and will be removed in a future version. Please use the PanelBackgrounds type instead. */
+    Background: typeof PanelBackground;
+    /** @deprecated IressPanel.Padding is now deprecated and will be removed in a future version. Please use the PaddingSizes type instead. */
+    Padding: typeof PaddingSize;
+    /** @deprecated IressPanel.TextAlign is now deprecated and will be removed in a future version. Please use the TextAligns type instead. */
+    TextAlign: typeof TextAlign;
+}
+export declare enum PanelCssClass {
+    Background = "iress--background",
+    Base = "iress-u-panel",
+    NoBorderRadius = "iress--no-border-radius",
+    NoGutter = "iress--no-gutter",
+    Stretch = "iress--stretch"
+}
+/** @deprecated PanelBackground is now deprecated and will be removed in a future version. Please use the PanelBackgrounds type instead. */
+export declare enum PanelBackground {
+    Default = "default",
+    Alt = "alt",
+    Page = "page",
+    Transparent = "transparent"
+}
+export declare const PANEL_BACKGROUNDS: readonly ["default", "alt", "page", "transparent"];
+export type PanelBackgrounds = (typeof PANEL_BACKGROUNDS)[number];
+export type PanelPadding = PaddingSize | VariablePaddingSize | PaddingSize[] | VariablePaddingSize[] | ResponsiveSizing<MixedPaddingSize>;

package/dist/src/components/Panel/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Panel.types';
+export * from './Panel';

package/dist/src/components/Placeholder/Placeholder.d.ts

@@ -0,0 +1,2 @@
+import { IressPlaceholderProps } from './Placeholder.types';
+export declare const IressPlaceholder: ({ children, className, height, stretch, style, transparent, width, ...restProps }: IressPlaceholderProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/Placeholder/Placeholder.types.d.ts

@@ -0,0 +1,24 @@
+import { IressHTMLAttributes } from '../../main';
+import { ReactNode } from 'react';
+export interface IressPlaceholderProps extends IressHTMLAttributes {
+    /**
+     * Description of the placeholder's envisioned contents.
+     */
+    children?: ReactNode;
+    /**
+     * Sets the height of the placeholder.
+     */
+    height?: string | number;
+    /**
+     * Sets the placeholder to be full width if true.
+     */
+    stretch?: boolean;
+    /**
+     * Sets the placeholder to be transparent if true.
+     */
+    transparent?: boolean;
+    /**
+     * Sets the width of the placeholder.
+     */
+    width?: string | number;
+}

package/dist/src/components/Placeholder/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Placeholder.types';
+export * from './Placeholder';

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

@@ -0,0 +1,3 @@
+import { IressInputPopoverProps } from './InputPopover.types';
+import { PopoverRef } from '../Popover.types';
+export declare const IressInputPopover: import('react').ForwardRefExoticComponent<IressInputPopoverProps & import('react').RefAttributes<PopoverRef>>;

package/dist/src/components/Popover/InputPopover/InputPopover.types.d.ts

@@ -0,0 +1,26 @@
+import { IressPopoverProps, PopoverActivatorProps } from '../../../main';
+export interface IressInputPopoverProps extends Omit<IressPopoverProps, 'matchActivatorWidth' | 'virtualFocus'>, Pick<InputPopoverActivatorProps, 'minLength'> {
+    /**
+     * Content for an activator element, usually an `IressInput`.
+     */
+    activator: PopoverActivatorProps['children'];
+    /**
+     * If true, the first supported is automatically highlighted.
+     * @default true
+     */
+    autoHighlight?: boolean;
+    /**
+     * Describes the type of content contained in the popover.
+     * If `listbox`, it will add the combobox role to the popover.
+     * @default listbox
+     */
+    type?: IressPopoverProps['type'];
+}
+export interface InputPopoverActivatorProps extends PopoverActivatorProps {
+    disabledAutoToggle?: boolean;
+    /**
+     * Min length of input activator before popover is shown, if input activator has minLength
+     * prop it will use that as a fallback. Defaults to 1 if not provided and not found in activator.
+     */
+    minLength?: number;
+}

package/dist/src/components/Popover/InputPopover/InputPopoverActivator.d.ts

@@ -0,0 +1,2 @@
+import { InputPopoverActivatorProps } from './InputPopover.types';
+export declare const InputPopoverActivator: ({ children, disabledAutoToggle, minLength, ...restProps }: InputPopoverActivatorProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/Popover/InputPopover/InputPopoverProvider.d.ts

@@ -0,0 +1,2 @@
+import { PopoverProviderProps, PopoverRef } from '../Popover.types';
+export declare const InputPopoverProvider: import('react').ForwardRefExoticComponent<PopoverProviderProps & import('react').RefAttributes<PopoverRef>>;

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

@@ -0,0 +1,2 @@
+import { PopoverWithEnums } from './Popover.types';
+export declare const IressPopover: PopoverWithEnums;

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

@@ -0,0 +1,176 @@
+import { ReactElement, MutableRefObject, PropsWithChildren } from 'react';
+import { DisplayMode, FloatingUIAlign } from '../../enums';
+import { IressHTMLAttributes } from '../../interfaces';
+import { ElementProps, OpenChangeReason, UseFloatingReturn, useInteractions } from '@floating-ui/react';
+import { DisplayModes, FloatingUIAligns, FloatingUIContainer } from '../../types';
+export interface IressPopoverProps extends IressHTMLAttributes {
+    /**
+     * Content for an activator element, usually an `IressButton`.
+     */
+    activator: PopoverActivatorProps['children'];
+    /**
+     * Sets the alignment of the popover relative to the activator element.
+     * @default auto
+     */
+    align?: FloatingUIAlign | FloatingUIAligns;
+    /**
+     * The content to render within the popover.
+     */
+    children?: React.ReactNode;
+    /**
+     * The container element to render the popover into.
+     * By default, the popover will render where its parent is rendered.
+     *
+     * **Note:** If the `container` doesn’t exist when the popover is mounted, ensure you pass an element directly (not a ref) and specify null as the default value before it is set. This lets it wait for the root to be available. For example, if you reference the parent element of a popover.
+     */
+    container?: FloatingUIContainer;
+    /**
+     * Class name of the popover content
+     */
+    contentClassName?: string;
+    /**
+     * When set to `true` the popover will be visible by default. Use for uncontrolled popovers.
+     */
+    defaultShow?: boolean;
+    /**
+     * When set to `true`, popover toggling can only be done through the toggle method on the `ref`.
+     * @deprecated Use a controlled `show` prop instead.
+     */
+    disabledAutoToggle?: boolean;
+    /**
+     * Sets the display mode of popover.
+     * @default overlay
+     */
+    displayMode?: DisplayMode | DisplayModes;
+    /**
+     * Which index to start the focus on when the popover is opened. Only works with `type` listbox and menu.
+     * Note: The index must exist in the list of items, otherwise it will not work.
+     * @default 0
+     */
+    focusStartIndex?: number;
+    /**
+     * Sets the popover to match the width of the activator.
+     * Note: This only works when `displayMode="overlay"`.
+     */
+    matchActivatorWidth?: boolean;
+    /**
+     * Is called when popover is activated.
+     */
+    onActivated?: (e?: Event, reason?: OpenChangeReason, activeIndex?: number | null) => void;
+    /**
+     * Is called when popover is deactivated.
+     */
+    onDeactivated?: (e?: Event, reason?: OpenChangeReason, activeIndex?: number | null) => void;
+    /**
+     * Is called when registered popover items are navigated using arrow keys. Only works with `type` listbox and menu.
+     */
+    onNavigate?: (activeIndex: number | null) => void;
+    /**
+     * When set to `true` the modal will be visible. Use for controlled popovers.
+     */
+    show?: boolean;
+    /**
+     * Describes the type of content contained in the popover.
+     */
+    type?: PopoverType | PopoverTypes;
+    /**
+     * Sets the width of the popover
+     * @deprecated use the `--iress-max-width` design token instead.
+     */
+    width?: string;
+    /**
+     * Whether the focus is virtual (using `aria-activedescendant`).
+     * Use this if you need focus to remain on the reference element (such as an input), but allow arrow keys to navigate items.
+     * Note: This is only applicable when type is set to: `listbox` or `menu`, and only works out of the box with `IressMenu` and its subcomponents.
+     * @default false
+     */
+    virtualFocus?: boolean;
+}
+export interface PopoverActivatorProps extends IressHTMLAttributes {
+    children?: ReactElement;
+}
+export interface PopoverContentProps extends IressHTMLAttributes {
+    container?: FloatingUIContainer;
+    displayMode?: DisplayModes;
+    virtualFocus?: boolean;
+}
+export interface PopoverStateHookProps {
+    defaultShow?: boolean;
+    show?: boolean;
+}
+export interface PopoverStateHookReturn {
+    hasInnerRole: () => boolean;
+    isControlled: boolean;
+    setShow: (flag?: boolean) => void;
+    setHasInnerRole: (flag: boolean) => void;
+    show: boolean;
+}
+export interface PopoverAriaHookReturn {
+    getAriaControls: () => string[];
+    toggleAriaControls: (id: string, addOrRemove?: boolean) => void;
+}
+export interface PopoverItemHookReturn {
+    isActiveInPopover?: boolean;
+    id: string;
+    ref?: (node: HTMLElement | null) => void;
+    tabIndex?: number;
+}
+export interface PopoverNavigationHookReturn {
+    activeIndex: number | null;
+    list: React.MutableRefObject<(HTMLElement | null)[]>;
+    listNav: ElementProps;
+    setActiveIndex: (value: number | null) => void;
+}
+export interface PopoverProviderProps extends PropsWithChildren, PopoverStateHookProps {
+    align: FloatingUIAligns;
+    autoHighlight?: boolean;
+    disabledAutoToggle?: boolean;
+    focusStartIndex?: number;
+    matchActivatorWidth?: boolean;
+    onActivated?: (e?: Event, reason?: OpenChangeReason, activeIndex?: number | null) => void;
+    onDeactivated?: (e?: Event, reason?: OpenChangeReason, activeIndex?: number | null) => void;
+    onNavigate?: (activeIndex: number | null) => void;
+    type?: PopoverTypes;
+    virtualFocus?: boolean;
+}
+export interface PopoverContextValue extends PopoverStateHookReturn, PopoverAriaHookReturn {
+    activeIndex: number | null;
+    api: UseFloatingReturn;
+    disabledAutoToggle?: boolean;
+    getVirtualFocus?: () => PopoverVirtualNode | null;
+    getFocusableActivator: () => HTMLElement | undefined;
+    interactions: ReturnType<typeof useInteractions>;
+    list: MutableRefObject<(HTMLElement | null)[]>;
+    type?: PopoverTypes;
+    setShowWithReason: (flag: boolean, e?: Event, reason?: OpenChangeReason) => void;
+    setVirtualFocus?: (node: PopoverVirtualNode | null) => void;
+}
+export interface PopoverRef extends Pick<PopoverContextValue, 'setShow' | 'show'>, Pick<PopoverAriaHookReturn, 'toggleAriaControls'> {
+    getActivator: () => HTMLElement | null;
+    getFocusableActivator?: () => HTMLElement | undefined;
+    getContent: () => HTMLElement | null;
+}
+export interface PopoverVirtualNode {
+    onBlur?: React.KeyboardEventHandler<HTMLElement>;
+    onKeyDown?: React.KeyboardEventHandler<HTMLElement>;
+}
+/** @deprecated PopoverType enum is now deprecated and will be removed in a future version. Please use the PopoverTypes type instead. **/
+export declare enum PopoverType {
+    Menu = "menu",
+    Listbox = "listbox",
+    Tree = "tree",
+    Grid = "grid",
+    Dialog = "dialog"
+}
+export declare const POPOVER_TYPES: readonly ["menu", "listbox", "tree", "grid", "dialog"];
+export type PopoverTypes = (typeof POPOVER_TYPES)[number];
+export declare const POPOVER_USE_MAX_HEIGHT = 200;
+export declare enum PopoverCssClass {
+    Active = "iress--popover-active"
+}
+export interface PopoverWithEnums extends React.ForwardRefExoticComponent<IressPopoverProps & React.RefAttributes<PopoverRef>> {
+    /** @deprecated IressPopover.Align is now deprecated and will be removed in a future version. Please use the value directly instead. **/
+    Align: typeof FloatingUIAlign;
+    /** @deprecated IressPopover.Type is now deprecated and will be removed in a future version. Please use the value directly instead. **/
+    Type: typeof PopoverType;
+}

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

@@ -0,0 +1,3 @@
+import { PopoverContextValue, PopoverProviderProps, PopoverRef } from './Popover.types';
+export declare const PopoverContext: import('react').Context<PopoverContextValue | undefined>;
+export declare const PopoverProvider: import('react').ForwardRefExoticComponent<PopoverProviderProps & import('react').RefAttributes<PopoverRef>>;

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

@@ -0,0 +1,2 @@
+import { PopoverActivatorProps } from '../Popover.types';
+export declare const PopoverActivator: ({ children, ...restProps }: PopoverActivatorProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+import { PopoverContentProps } from '../Popover.types';
+export declare const PopoverContent: (props: PopoverContentProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/Popover/helpers/composeFloatingProps.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+import { PopoverContextValue } from '../Popover.types';
+import { DisplayModes, IressHTMLAttributes } from '../../../main';
+/**
+ * This adds additional props to the Floating UI floatingProps to better suit the requirements of IressPopover.
+ * Some are slight tweaks to the UX to ensure it behaves according to IDS standards, as well as fix some issues found when using Floating UI.
+ *
+ * See: https://floating-ui.com/docs/useFloating#floatingstyles
+ *
+ * @param {PopoverContextValue} popover the popover context
+ * @param {DisplayModes} displayMode how the content is to be displayed, whether inline (static, underneath activator) or overlay (floating, anchored to the activator)
+ * @param {React.CSSProperties} style any custom styles for the popover, it will be appended to the Floating UI styles
+ * @returns {IressHTMLAttributes} the props to be passed to the floating content
+ */
+export declare const composePopoverFloatingProps: (popover: PopoverContextValue, displayMode?: DisplayModes, style?: React.CSSProperties) => IressHTMLAttributes;

package/dist/src/components/Popover/helpers/composePopoverWidth.d.ts

@@ -0,0 +1,2 @@
+import { CSSProperties } from 'react';
+export declare const composePopoverWidth: (width?: string, matchActivatorWidth?: boolean) => CSSProperties;