@bifrostui/react 1.5.3 → 2.0.0-alpha.1

package/es/src/IconButton/IconButton.types.d.ts

@@ -0,0 +1,76 @@
+import { OverrideProps, ThemeColor, ButtonOpenType } from '@bifrostui/types';
+import React from 'react';
+export type IconButtonProps<D extends React.ElementType = 'button', P = {}> = OverrideProps<{
+    props: P & {
+        /**
+         * - small: 小按钮
+         * - medium: 中号按钮，默认按钮
+         * - large: 大按钮
+         * @default 'medium'
+         */
+        size?: 'small' | 'medium' | 'large';
+        /** 按钮颜色
+         */
+        color?: ThemeColor;
+        /**
+         * - default: 图标按钮
+         * - contained: 实心填充按钮
+         * - outlined: 描边按钮
+         * - subtle: 柔和按钮
+         * @default 'default'
+         */
+        variant?: 'default' | 'contained' | 'outlined' | 'subtle';
+        /**
+         * - circular: 圆形
+         * - square: 正方形
+         * - rounded: 圆角
+         * @default 'circular'
+         */
+        shape?: 'circular' | 'square' | 'rounded';
+        /**
+         * 是否禁用
+         * @default false
+         */
+        disabled?: boolean;
+        /**
+         * 仅微信小程序支持的button开放能力
+         */
+        openType?: ButtonOpenType;
+        /**
+         * 提供可访问的名称
+         * 图标按钮必须设置此属性，因为没有可见文本
+         * @example "搜索", "关闭", "菜单", "收藏"
+         */
+        'aria-label'?: string;
+        /**
+         * 禁用状态
+         * @example true - 禁用, false - 开启
+         */
+        'aria-disabled'?: boolean;
+        /**
+         * 切换按钮的按下状态
+         * 用于切换类型的按钮（如收藏、点赞、静音等）
+         * @example true - 已激活, false - 未激活
+         */
+        'aria-pressed'?: boolean;
+        /**
+         * 展开/折叠状态
+         * 用于控制下拉菜单、面板等可展开内容的按钮
+         * @example true - 已展开, false - 已折叠
+         */
+        'aria-expanded'?: boolean;
+        /**
+         * 弹出内容类型
+         * 指示点击按钮后会弹出什么类型的内容
+         * @example "menu" - 弹出菜单, "dialog" - 弹出对话框
+         */
+        'aria-haspopup'?: boolean | 'menu' | 'dialog' | 'listbox';
+        /**
+         * 关联描述该按钮的元素ID
+         * 用于提供额外的说明信息
+         * @example aria-describedby="help-text"
+         */
+        'aria-describedby'?: string;
+    };
+    defaultComponent: D;
+}, D>;

package/es/src/Image/__tests__/fixtures/A11yDemos.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+/**
+ * 自定义 Image 组件 Demo 集合
+ * 这个文件包含多个测试 demo，展示如何使用 getCustomDemoCodesFromFile 进行无障碍测试
+ * 文件名必须是 A11yDemos.tsx（固定约定）
+ */
+export declare const basicImageDemo: () => React.JSX.Element;
+export declare const ClickableImageDemo: () => React.JSX.Element;
+export declare const placeholderImageDemo: () => React.JSX.Element;
+export declare const errorImageDemo: () => React.JSX.Element;
+export declare const lazyImageDemo: () => React.JSX.Element;
+export declare const noAltImageDemo: () => React.JSX.Element;
+declare const _default: {
+    basicImageDemo: () => React.JSX.Element;
+    ClickableImageDemo: () => React.JSX.Element;
+    placeholderImageDemo: () => React.JSX.Element;
+    errorImageDemo: () => React.JSX.Element;
+    lazyImageDemo: () => React.JSX.Element;
+    noAltImageDemo: () => React.JSX.Element;
+};
+export default _default;

package/es/src/Input/Input.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { InputProps } from './index';
+import './index.less';
+declare const Input: React.ForwardRefExoticComponent<Omit<InputProps<"div", {}>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export default Input;

package/es/src/Input/__tests__/fixtures/A11yDemos.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+/**
+ * 自定义 Input 组件 Demo 集合
+ * 这个文件包含多个测试 demo，展示如何使用 getCustomDemoCodesFromFile 进行无障碍测试
+ * 文件名必须是 customDemoComponent.tsx（固定约定）
+ */
+export declare const basicInputDemo: () => React.JSX.Element;
+export declare const disabledInputDemo: () => React.JSX.Element;
+export declare const requiredInputDemo: () => React.JSX.Element;
+export declare const readOnlyInputDemo: () => React.JSX.Element;
+export declare const placeholderInputDemo: () => React.JSX.Element;
+export declare const ariaLabelInputDemo: () => React.JSX.Element;
+declare const _default: {
+    basicInputDemo: () => React.JSX.Element;
+    disabledInputDemo: () => React.JSX.Element;
+    requiredInputDemo: () => React.JSX.Element;
+    readOnlyInputDemo: () => React.JSX.Element;
+    placeholderInputDemo: () => React.JSX.Element;
+    ariaLabelInputDemo: () => React.JSX.Element;
+};
+export default _default;

package/es/src/ItemSelector/ItemSelector.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { ItemSelectorProps } from './ItemSelector.types';
+declare const ItemSelector: React.ForwardRefExoticComponent<Omit<ItemSelectorProps<"div", {}>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export default ItemSelector;

package/es/src/ItemSelector/ItemSelector.miniapp.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { ItemSelectorProps } from './ItemSelector.types';
+declare const ItemSelector: React.ForwardRefExoticComponent<Omit<ItemSelectorProps<"div", {}>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export default ItemSelector;

package/es/src/ItemSelector/ItemSelector.types.d.ts

@@ -0,0 +1,39 @@
+import { OverrideProps } from '@bifrostui/types';
+export type itemType = {
+    /** Item名 */
+    name: string;
+};
+export type ItemGroup = {
+    /** Item列表 */
+    items: itemType[];
+    /** 组名 */
+    groupName?: string;
+    /** 索引字母 */
+    indexName?: string;
+    /** 索引Code */
+    indexCode?: string;
+    /** 是否平铺 */
+    isFlat?: boolean;
+};
+export type ItemSelectorProps<D extends React.ElementType = 'div', P = {}> = OverrideProps<{
+    props: P & {
+        /** Item列表 */
+        items: ItemGroup[];
+        /** 禁用展示索引 默认false 即展示索引 */
+        disableIndex?: boolean;
+        /** 头部标题 */
+        title?: string;
+        /** 选择Item回调 */
+        onSelect: (e: React.SyntheticEvent, data: {
+            item: itemType;
+            group: ItemGroup;
+        }) => void;
+        /** 和title配合使用，头部右侧的关闭回调 */
+        onClose?: (e: React.SyntheticEvent) => void;
+    };
+    defaultComponent: D;
+}, D>;
+export type ItemSelectorCoreProps = ItemSelectorProps & {
+    touchHandler: any;
+    height?: string;
+};

package/es/src/ItemSelector/ItemSelectorCore.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { ItemSelectorCoreProps } from './ItemSelector.types';
+import './index.less';
+declare const ItemSelector: React.ForwardRefExoticComponent<Omit<ItemSelectorCoreProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export default ItemSelector;

package/es/src/Loading/Loading.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { LoadingProps } from './Loading.types';
+import './index.less';
+declare const Loading: React.ForwardRefExoticComponent<Omit<LoadingProps<"div", {}>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export default Loading;

package/es/src/Modal/Modal.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { ModalProps } from './Modal.types';
+import './index.less';
+declare const Modal: React.ForwardRefExoticComponent<Omit<ModalProps<"div", {}>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export default Modal;

package/es/src/Modal/Modal.miniapp.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { ViewProps } from '@tarojs/components';
+import './index.less';
+declare const Modal: React.ForwardRefExoticComponent<Omit<ViewProps & {
+    open?: boolean;
+    container?: Element | (() => Element);
+    hideBackdrop?: boolean;
+    BackdropProps?: Partial<import("../Backdrop").BackdropProps<"div", {}>>;
+    onClose?: (e: React.SyntheticEvent<Element, Event>, detail?: import("./Modal.types").ModalCloseDetail) => void;
+    disableScrollLock?: boolean;
+    disablePortal?: boolean;
+    keepMounted?: boolean;
+} & import("@bifrostui/types").ICommonProps & Omit<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: React.Ref<HTMLDivElement>;
+}, keyof import("@bifrostui/types").ICommonProps | "container" | "open" | "onClose" | "disablePortal" | "BackdropProps" | "keepMounted" | "hideBackdrop" | "disableScrollLock">, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export default Modal;

package/es/src/Modal/Modal.types.d.ts

@@ -0,0 +1,44 @@
+import { OverrideProps } from '@bifrostui/types';
+import React, { SyntheticEvent } from 'react';
+import { BackdropProps } from '../Backdrop/Backdrop.types';
+import { PortalProps } from '../Portal/Portal.types';
+export type ModalCloseDetail = {
+    from?: string;
+};
+export type ModalProps<D extends React.ElementType = 'div', P = {}> = OverrideProps<{
+    props: P & {
+        /**
+         * 是否打开Modal
+         */
+        open?: boolean;
+        /**
+         * Portal容器
+         */
+        container?: PortalProps['container'];
+        /**
+         * 是否隐藏背景遮罩
+         */
+        hideBackdrop?: boolean;
+        /**
+         * 背景遮罩属性
+         */
+        BackdropProps?: Partial<BackdropProps>;
+        /**
+         * 关闭回调
+         */
+        onClose?: (e: SyntheticEvent, detail?: ModalCloseDetail) => void;
+        /**
+         * 是否禁用滚动锁定
+         */
+        disableScrollLock?: boolean;
+        /**
+         * 是否禁用Portal
+         */
+        disablePortal?: PortalProps['disablePortal'];
+        /**
+         * 是否保持挂载状态
+         */
+        keepMounted?: boolean;
+    };
+    defaultComponent: D;
+}, D>;

package/es/src/Modal/ModalManager.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Modal管理器，用于管理多个弹窗的状态
+ * 参考MUI的ModalManager实现
+ */
+interface ManagedModal {
+    modalRef: HTMLElement;
+    mount: HTMLElement;
+}
+export declare function ariaHidden(element: Element, show: boolean): void;
+export declare class ModalManager {
+    private modals;
+    private containers;
+    add(modal: ManagedModal, container: Element): number;
+    mount(modal: ManagedModal, props: {
+        disableScrollLock?: boolean;
+    }): void;
+    remove(modal: ManagedModal, ariaHiddenState?: boolean): number;
+    isTopModal(modal: ManagedModal): boolean;
+}
+export declare const modalManager: ModalManager;
+export {};

package/es/src/Modal/__tests__/fixtures/A11yDemos.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+/**
+ * 自定义 Modal 组件 Demo 集合
+ * 这个文件包含多个测试 demo，展示如何使用 getCustomDemoCodesFromFile 进行无障碍测试
+ * 文件名必须是 customDemoComponent.tsx（固定约定）
+ */
+export declare const basicModalDemo: () => React.JSX.Element;
+export declare const keepMountedDemo: () => React.JSX.Element;

package/es/src/Modal/index.d.ts

@@ -0,0 +1,6 @@
+export { default } from './Modal';
+export { default as Modal } from './Modal';
+export * from './Modal.types';
+export { ModalManager, modalManager } from './ModalManager';
+export { useModal } from './useModal';
+export type { UseModalParameters, UseModalReturnValue } from './useModal';

package/es/src/Modal/useModal.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+export interface UseModalParameters {
+    container?: Element | (() => Element | null) | null;
+    disableScrollLock?: boolean;
+    onClose?: (event: React.SyntheticEvent<Element, Event>, detail?: {
+        from: 'backdropClick' | 'escapeKeyDown';
+    }) => void;
+    open: boolean;
+    rootRef?: React.Ref<Element>;
+    [key: string]: any;
+}
+export interface UseModalReturnValue {
+    getRootProps: (otherHandlers?: Record<string, any>) => Record<string, unknown>;
+    getBackdropProps: (otherHandlers?: Record<string, any>) => Record<string, unknown>;
+    getTransitionProps: () => {
+        onEnter: () => void;
+        onExited: () => void;
+    };
+    rootRef: React.RefCallback<Element>;
+    portalRef: React.RefCallback<HTMLElement>;
+    exited: boolean;
+    hasTransition: boolean;
+}
+export declare function useModal(parameters: UseModalParameters): UseModalReturnValue;

package/es/src/NavBar/NavBar.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { NavBarProps } from './NavBar.types';
+import './index.less';
+declare const NavBar: React.ForwardRefExoticComponent<Omit<NavBarProps<"div", {}>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export default NavBar;

package/es/src/Picker/Picker.types.d.ts

@@ -0,0 +1,121 @@
+import React from 'react';
+import { OverrideProps } from '@bifrostui/types';
+import { DrawerProps } from '../Drawer/Drawer.types';
+export interface IPickerOptionItem {
+    /**
+     * 选项的文字内容
+     */
+    label?: string | number;
+    /**
+     * 选项对应唯一的值
+     */
+    value: string | number;
+    /**
+     * 是否禁用
+     */
+    disabled?: boolean;
+}
+export type ICascadePickerChildOptionItem = IPickerOptionItem & {
+    /**
+     * 用于级联选项，子节点可能没有children属性
+     */
+    children?: ICascadePickerChildOptionItem[];
+};
+export type ICascadePickerOptionItem = IPickerOptionItem & {
+    /**
+     * 用于级联选项，根节点必须含有children属性
+     */
+    children: ICascadePickerChildOptionItem[];
+};
+export type PickerProps<D extends React.ElementType = 'div', P = DrawerProps> = OverrideProps<{
+    props: P & {
+        /**
+         * 是否展示选择器
+         * @default false
+         */
+        open?: boolean;
+        /**
+         * 标题
+         */
+        title?: string;
+        /**
+         * 确认文本内容
+         */
+        confirmText?: string;
+        /**
+         * 取消文本内容
+         */
+        cancelText?: string;
+        /**
+         * 列表数据
+         * @default []
+         */
+        options?: IPickerOptionItem[][] | ICascadePickerOptionItem[];
+        /**
+         * 选中的值
+         */
+        value?: (string | number)[];
+        /**
+         * 内部内容DOM节点上的Props
+         */
+        contentProps?: React.HTMLAttributes<HTMLDivElement>;
+        /**
+         * 点击确认按钮时候回调
+         */
+        onConfirm?: (e: React.MouseEvent<HTMLDivElement>, data: {
+            value: (string | number)[];
+            options: ICascadePickerChildOptionItem[][];
+        }) => void;
+        /**
+         * 选项值变更时的回调
+         */
+        onOptionChange?: (e: React.TransitionEvent<HTMLDivElement>, data: {
+            value: (string | number)[];
+            options: ICascadePickerChildOptionItem[][];
+            currentOption: ICascadePickerChildOptionItem;
+            columnIndex: number;
+        }) => void;
+        /**
+         * 点击取消按钮时候回调
+         */
+        onCancel?: (e: React.MouseEvent<HTMLDivElement>) => void;
+        /**
+         * 关闭选择器时执行
+         */
+        onClose?: (e: React.MouseEvent<HTMLDivElement>, data: {
+            from: string;
+            value: (string | number)[];
+            options: ICascadePickerChildOptionItem[][];
+        }) => void;
+    };
+    defaultComponent: D;
+}, D>;
+export type PickerPanelProps<D extends React.ElementType = 'div', P = {}> = OverrideProps<{
+    props: P & {
+        /**
+         * 单列面板的列表数据
+         * @default []
+         */
+        options?: ICascadePickerChildOptionItem[];
+        /**
+         * 选中值
+         */
+        value?: string | number;
+        /**
+         * 列索引
+         */
+        columnIndex?: number;
+        /**
+         * 是否展示选择器
+         */
+        open?: boolean;
+        /**
+         * 选择选项时的回调
+         */
+        onSelect?: (e: React.TransitionEvent<HTMLDivElement>, data: {
+            columnOption: ICascadePickerChildOptionItem;
+            columnIndex: number;
+        }) => void;
+    };
+    defaultComponent: D;
+}, D>;

package/es/src/Picker/__tests__/fixtures/A11yDemos.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const CalendarDemo: () => React.JSX.Element;

package/es/src/Picker/utils.d.ts

@@ -0,0 +1,32 @@
+import { IPickerOptionItem, ICascadePickerOptionItem, ICascadePickerChildOptionItem } from './Picker.types';
+/**
+ * 根据第一列数据判断选择器类型
+ */
+export declare const pickerPanelType: (options?: (IPickerOptionItem[] | ICascadePickerOptionItem)[]) => "multiple" | "single" | "cascade";
+/**
+ * 格式化级联模式数据
+ */
+export declare const formatCascade: (columns: ICascadePickerOptionItem[], values?: (number | string)[]) => ICascadePickerChildOptionItem[][];
+/**
+ * 统一options数据格式
+ */
+export declare const formatOptions: (internalValue: (number | string)[], options?: any[]) => any[];
+/**
+ * 在格式化后的数据源中是否存在等长子项的value
+ */
+export declare const existSameLengthValue: (value: unknown[], formatted: {
+    [index: string]: unknown;
+    value: string | number;
+}[][]) => boolean;
+/**
+ * 关闭选择器时，纠正value和格式化数据
+ * 取决于formatted后的options有几列，若value为格式化后数据源（formatted）的等长子集，则取value，否则执行纠正逻辑
+ */
+export declare const safeData: ({ value, formatted, options }: {
+    value: any;
+    formatted: any;
+    options: any;
+}) => {
+    safeValue: any[];
+    safeFormattedValue: any[];
+};

package/es/src/Popover/Popover.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { PopoverProps } from './Popover.types';
+import './index.less';
+declare const Popover: React.ForwardRefExoticComponent<Omit<PopoverProps<"div", {}>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export default Popover;

package/es/src/Popover/Popover.types.d.ts

@@ -0,0 +1,94 @@
+import React from 'react';
+import { OverrideProps } from '@bifrostui/types';
+type triggerType = 'click' | 'hover' | 'none';
+export interface AnchorOrigin {
+    /**
+     * 垂直方向位置
+     * @default 'top'
+     */
+    vertical: 'top' | 'center' | 'bottom';
+    /**
+     * 水平方向位置
+     * @default 'center'
+     */
+    horizontal: 'left' | 'center' | 'right';
+}
+export type PopoverProps<D extends React.ElementType = 'div', P = {}> = OverrideProps<{
+    props: P & {
+        /**
+         * 默认是否显隐
+         * @default false
+         */
+        defaultOpen?: boolean;
+        /**
+         * 用于手动控制浮层显隐
+         */
+        open?: boolean;
+        /**
+         * 浮层的标题
+         */
+        title?: React.ReactNode;
+        /**
+         * 浮层的内容
+         */
+        content?: React.ReactNode;
+        /**
+         * 是否展示箭头
+         * @default false
+         */
+        hideArrow?: boolean;
+        /**
+         * 用于控制浮层和目标元素偏移量
+         */
+        offsetSpacing?: number;
+        /**
+         * 气泡框相对于锚点的位置
+         * @default { vertical: 'top', horizontal: 'center' }
+         */
+        anchorOrigin?: AnchorOrigin;
+        /**
+         * 触发行为
+         * - click: 点击触发
+         * - hover: hover触发
+         * - none: 不自动触发，完全通过 open 属性控制
+         * - 或者是 click 和 hover 的数组组合
+         * @default 'click'
+         */
+        trigger?: triggerType | Exclude<triggerType, 'none'>[];
+        /**
+         * 点击事件回调方法
+         * - event 触发事件
+         * - data.open 浮层显隐状态
+         * @returns
+         */
+        onOpenChange?: (event: React.SyntheticEvent | Event, data: {
+            open: boolean;
+        }) => void;
+        /**
+         * 无障碍功能：Popover的角色
+         * @default 'tooltip'
+         */
+        role?: 'tooltip' | 'dialog' | 'menu' | 'listbox';
+        /**
+         * 无障碍功能：为Popover提供可访问的标签
+         */
+        'aria-label'?: string;
+        /**
+         * 无障碍功能：引用描述此Popover的元素ID
+         */
+        'aria-labelledby'?: string;
+        /**
+         * 无障碍功能：是否自动管理焦点
+         * 当为true时，Popover打开时会自动获取焦点，关闭时焦点返回到触发元素
+         * @default false
+         */
+        autoFocus?: boolean;
+        /**
+         * 无障碍功能：是否支持Escape键关闭
+         * @default false
+         */
+        closeOnEscape?: boolean;
+    };
+    defaultComponent: D;
+}, D>;
+export {};

package/es/src/Popover/__tests__/fixtures/A11yDemos.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+/**
+ * 自定义 Popover 组件 Demo 集合
+ * 这个文件包含多个测试 demo，展示如何使用 getCustomDemoCodesFromFile 进行无障碍测试
+ * 文件名必须是 A11yDemos.tsx（固定约定）
+ */
+export declare const basicPopoverDemo: () => React.JSX.Element;
+export declare const placementPopoverDemo: () => React.JSX.Element;
+export declare const triggerPopoverDemo: () => React.JSX.Element;
+export declare const accessibilityPopoverDemo: () => React.JSX.Element;
+export declare const complexInteractionPopoverDemo: () => React.JSX.Element;
+export declare const complexContentPopoverDemo: () => React.JSX.Element;
+export declare const offsetPopoverDemo: () => React.JSX.Element;
+export declare const edgeCasePopoverDemo: () => React.JSX.Element;
+declare const _default: {
+    basicPopoverDemo: () => React.JSX.Element;
+    placementPopoverDemo: () => React.JSX.Element;
+    triggerPopoverDemo: () => React.JSX.Element;
+    accessibilityPopoverDemo: () => React.JSX.Element;
+    complexInteractionPopoverDemo: () => React.JSX.Element;
+    complexContentPopoverDemo: () => React.JSX.Element;
+    offsetPopoverDemo: () => React.JSX.Element;
+    edgeCasePopoverDemo: () => React.JSX.Element;
+};
+export default _default;

package/es/src/Popover/hooks/index.d.ts

@@ -0,0 +1,8 @@
+export { usePopoverState } from './usePopoverState';
+export { usePopoverPosition } from './usePopoverPosition';
+export { usePopoverA11y } from './usePopoverA11y';
+export { usePopoverEvents } from './usePopoverEvents';
+export type { UsePopoverStateProps, UsePopoverStateReturn, } from './usePopoverState';
+export type { UsePopoverPositionProps, UsePopoverPositionReturn, } from './usePopoverPosition';
+export type { UsePopoverA11yProps, UsePopoverA11yReturn, } from './usePopoverA11y';
+export type { UsePopoverEventsProps, UsePopoverEventsReturn, } from './usePopoverEvents';

package/es/src/Popover/hooks/usePopoverA11y.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+export interface UsePopoverA11yProps {
+    isOpen: boolean;
+    autoFocus: boolean;
+    closeOnEscape: boolean;
+    onClose: (event: React.SyntheticEvent | Event) => void;
+    tipRef: React.RefObject<HTMLDivElement>;
+    childrenRef: React.RefObject<Element>;
+}
+export interface UsePopoverA11yReturn {
+    popoverId: string;
+    handleKeyDown: (event: KeyboardEvent) => void;
+}
+export declare const usePopoverA11y: ({ isOpen, autoFocus, closeOnEscape, onClose, tipRef, childrenRef, }: UsePopoverA11yProps) => UsePopoverA11yReturn;

package/es/src/Popover/hooks/usePopoverEvents.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import { PopoverProps } from '../Popover.types';
+type TriggerType = PopoverProps['trigger'];
+export interface UsePopoverEventsProps {
+    isOpen: boolean;
+    controlByUser: boolean;
+    trigger: TriggerType;
+    onShow: (event: React.SyntheticEvent | Event) => void;
+    onHide: (event: React.SyntheticEvent | Event) => void;
+    onTriggerClick: (event: React.SyntheticEvent | Event) => void;
+    onMounted: () => void;
+    handleKeyDown: (event: KeyboardEvent) => void;
+    tipRef: React.RefObject<HTMLDivElement>;
+    childrenRef: React.RefObject<Element>;
+}
+export interface UsePopoverEventsReturn {
+    triggerEventOption?: Record<string, unknown>;
+    backdropProps?: Record<string, unknown>;
+}
+export declare const usePopoverEvents: ({ isOpen, controlByUser, trigger, onShow, onHide, onTriggerClick, onMounted, handleKeyDown, tipRef, childrenRef, }: UsePopoverEventsProps) => UsePopoverEventsReturn;
+export {};