devextreme-react 23.2.6 → 24.1.2-beta

package/cjs/popover.d.ts

@@ -1,7 +1,7 @@
 /*!
  * devextreme-react
- * Version: 23.2.6
- * Build date: Wed May 01 2024
+ * Version: 24.1.2-beta
+ * Build date: Mon May 13 2024
  *
  * Copyright (c) 2012 - 2024 Developer Express Inc. ALL RIGHTS RESERVED
  *
@@ -11,19 +11,19 @@
  * https://github.com/DevExpress/devextreme-react
  */
 
-/// <reference types="react" />
+import * as React from "react";
+import { Ref, ReactElement } from "react";
 import dxPopover, { Properties } from "devextreme/ui/popover";
-import { Component as BaseComponent, IHtmlOptions } from "./core/component";
-import NestedOption from "./core/nested-option";
+import { IHtmlOptions, IElementDescriptor } from "./core/component";
 import type { PositionConfig } from "devextreme/animation/position";
 import type { ContentReadyEvent, DisposingEvent, HiddenEvent, HidingEvent, InitializedEvent, ShowingEvent, ShownEvent, TitleRenderedEvent } from "devextreme/ui/popover";
 import type { AnimationConfig, AnimationState } from "devextreme/animation/fx";
 import type { template } from "devextreme/core/templates/template";
 import type { CollectionWidgetItem } from "devextreme/ui/collection/ui.collection_widget.base";
-declare type ReplaceFieldTypes<TSource, TReplacement> = {
+type ReplaceFieldTypes<TSource, TReplacement> = {
     [P in keyof TSource]: P extends keyof TReplacement ? TReplacement[P] : TSource[P];
 };
-declare type IPopoverOptionsNarrowedEvents = {
+type IPopoverOptionsNarrowedEvents = {
     onContentReady?: ((e: ContentReadyEvent) => void);
     onDisposing?: ((e: DisposingEvent) => void);
     onHidden?: ((e: HiddenEvent) => void);
@@ -33,13 +33,11 @@ declare type IPopoverOptionsNarrowedEvents = {
     onShown?: ((e: ShownEvent) => void);
     onTitleRendered?: ((e: TitleRenderedEvent) => void);
 };
-declare type IPopoverOptions = React.PropsWithChildren<ReplaceFieldTypes<Properties, IPopoverOptionsNarrowedEvents> & IHtmlOptions & {
+type IPopoverOptions = React.PropsWithChildren<ReplaceFieldTypes<Properties, IPopoverOptionsNarrowedEvents> & IHtmlOptions & {
     contentRender?: (...params: any) => React.ReactNode;
     contentComponent?: React.ComponentType<any>;
-    contentKeyFn?: (data: any) => string;
     titleRender?: (...params: any) => React.ReactNode;
     titleComponent?: React.ComponentType<any>;
-    titleKeyFn?: (data: any) => string;
     defaultHeight?: (() => number | string) | number | string;
     defaultPosition?: PositionConfig | "bottom" | "left" | "right" | "top";
     defaultVisible?: boolean;
@@ -49,102 +47,46 @@ declare type IPopoverOptions = React.PropsWithChildren<ReplaceFieldTypes<Propert
     onVisibleChange?: (value: boolean) => void;
     onWidthChange?: (value: (() => number | string) | number | string) => void;
 }>;
-declare class Popover extends BaseComponent<React.PropsWithChildren<IPopoverOptions>> {
-    get instance(): dxPopover;
-    protected _WidgetClass: typeof dxPopover;
-    protected isPortalComponent: boolean;
-    protected subscribableOptions: string[];
-    protected independentEvents: string[];
-    protected _defaults: {
-        defaultHeight: string;
-        defaultPosition: string;
-        defaultVisible: string;
-        defaultWidth: string;
-    };
-    protected _expectedChildren: {
-        animation: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-        hideEvent: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-        position: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-        showEvent: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-        toolbarItem: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-    };
-    protected _templateProps: {
-        tmplOption: string;
-        render: string;
-        component: string;
-        keyFn: string;
-    }[];
+interface PopoverRef {
+    instance: () => dxPopover;
 }
-declare type IAnimationProps = React.PropsWithChildren<{
+declare const Popover: (props: React.PropsWithChildren<IPopoverOptions> & {
+    ref?: Ref<PopoverRef>;
+}) => ReactElement | null;
+type IAnimationProps = React.PropsWithChildren<{
     hide?: AnimationConfig;
     show?: AnimationConfig;
 }>;
-declare class Animation extends NestedOption<IAnimationProps> {
-    static OptionName: string;
-    static ExpectedChildren: {
-        hide: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-        show: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-    };
-}
-declare type IAtProps = React.PropsWithChildren<{
+declare const _componentAnimation: React.MemoExoticComponent<(props: IAnimationProps) => React.FunctionComponentElement<IAnimationProps>>;
+declare const Animation: typeof _componentAnimation & IElementDescriptor;
+type IAtProps = React.PropsWithChildren<{
     x?: "center" | "left" | "right";
     y?: "bottom" | "center" | "top";
 }>;
-declare class At extends NestedOption<IAtProps> {
-    static OptionName: string;
-}
-declare type IBoundaryOffsetProps = React.PropsWithChildren<{
+declare const _componentAt: React.MemoExoticComponent<(props: IAtProps) => React.FunctionComponentElement<IAtProps>>;
+declare const At: typeof _componentAt & IElementDescriptor;
+type IBoundaryOffsetProps = React.PropsWithChildren<{
     x?: number;
     y?: number;
 }>;
-declare class BoundaryOffset extends NestedOption<IBoundaryOffsetProps> {
-    static OptionName: string;
-}
-declare type ICollisionProps = React.PropsWithChildren<{
+declare const _componentBoundaryOffset: React.MemoExoticComponent<(props: IBoundaryOffsetProps) => React.FunctionComponentElement<IBoundaryOffsetProps>>;
+declare const BoundaryOffset: typeof _componentBoundaryOffset & IElementDescriptor;
+type ICollisionProps = React.PropsWithChildren<{
     x?: "fit" | "flip" | "flipfit" | "none";
     y?: "fit" | "flip" | "flipfit" | "none";
 }>;
-declare class Collision extends NestedOption<ICollisionProps> {
-    static OptionName: string;
-}
-declare type IFromProps = React.PropsWithChildren<{
+declare const _componentCollision: React.MemoExoticComponent<(props: ICollisionProps) => React.FunctionComponentElement<ICollisionProps>>;
+declare const Collision: typeof _componentCollision & IElementDescriptor;
+type IFromProps = React.PropsWithChildren<{
     left?: number;
     opacity?: number;
     position?: PositionConfig;
     scale?: number;
     top?: number;
 }>;
-declare class From extends NestedOption<IFromProps> {
-    static OptionName: string;
-    static ExpectedChildren: {
-        position: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-    };
-}
-declare type IHideProps = React.PropsWithChildren<{
+declare const _componentFrom: React.MemoExoticComponent<(props: IFromProps) => React.FunctionComponentElement<IFromProps>>;
+declare const From: typeof _componentFrom & IElementDescriptor;
+type IHideProps = React.PropsWithChildren<{
     complete?: (($element: any, config: AnimationConfig) => void);
     delay?: number;
     direction?: "bottom" | "left" | "right" | "top";
@@ -156,41 +98,27 @@ declare type IHideProps = React.PropsWithChildren<{
     to?: AnimationState;
     type?: "css" | "fade" | "fadeIn" | "fadeOut" | "pop" | "slide" | "slideIn" | "slideOut";
 }>;
-declare class Hide extends NestedOption<IHideProps> {
-    static OptionName: string;
-    static ExpectedChildren: {
-        from: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-        to: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-    };
-}
-declare type IHideEventProps = React.PropsWithChildren<{
+declare const _componentHide: React.MemoExoticComponent<(props: IHideProps) => React.FunctionComponentElement<IHideProps>>;
+declare const Hide: typeof _componentHide & IElementDescriptor;
+type IHideEventProps = React.PropsWithChildren<{
     delay?: number;
     name?: string;
 }>;
-declare class HideEvent extends NestedOption<IHideEventProps> {
-    static OptionName: string;
-}
-declare type IMyProps = React.PropsWithChildren<{
+declare const _componentHideEvent: React.MemoExoticComponent<(props: IHideEventProps) => React.FunctionComponentElement<IHideEventProps>>;
+declare const HideEvent: typeof _componentHideEvent & IElementDescriptor;
+type IMyProps = React.PropsWithChildren<{
     x?: "center" | "left" | "right";
     y?: "bottom" | "center" | "top";
 }>;
-declare class My extends NestedOption<IMyProps> {
-    static OptionName: string;
-}
-declare type IOffsetProps = React.PropsWithChildren<{
+declare const _componentMy: React.MemoExoticComponent<(props: IMyProps) => React.FunctionComponentElement<IMyProps>>;
+declare const My: typeof _componentMy & IElementDescriptor;
+type IOffsetProps = React.PropsWithChildren<{
     x?: number;
     y?: number;
 }>;
-declare class Offset extends NestedOption<IOffsetProps> {
-    static OptionName: string;
-}
-declare type IPositionProps = React.PropsWithChildren<{
+declare const _componentOffset: React.MemoExoticComponent<(props: IOffsetProps) => React.FunctionComponentElement<IOffsetProps>>;
+declare const Offset: typeof _componentOffset & IElementDescriptor;
+type IPositionProps = React.PropsWithChildren<{
     at?: Record<string, any> | "bottom" | "center" | "left" | "left bottom" | "left top" | "right" | "right bottom" | "right top" | "top" | {
         x?: "center" | "left" | "right";
         y?: "bottom" | "center" | "top";
@@ -214,10 +142,9 @@ declare type IPositionProps = React.PropsWithChildren<{
         y?: number;
     };
 }>;
-declare class Position extends NestedOption<IPositionProps> {
-    static OptionName: string;
-}
-declare type IShowProps = React.PropsWithChildren<{
+declare const _componentPosition: React.MemoExoticComponent<(props: IPositionProps) => React.FunctionComponentElement<IPositionProps>>;
+declare const Position: typeof _componentPosition & IElementDescriptor;
+type IShowProps = React.PropsWithChildren<{
     complete?: (($element: any, config: AnimationConfig) => void);
     delay?: number;
     direction?: "bottom" | "left" | "right" | "top";
@@ -229,27 +156,24 @@ declare type IShowProps = React.PropsWithChildren<{
     to?: AnimationState;
     type?: "css" | "fade" | "fadeIn" | "fadeOut" | "pop" | "slide" | "slideIn" | "slideOut";
 }>;
-declare class Show extends NestedOption<IShowProps> {
-    static OptionName: string;
-}
-declare type IShowEventProps = React.PropsWithChildren<{
+declare const _componentShow: React.MemoExoticComponent<(props: IShowProps) => React.FunctionComponentElement<IShowProps>>;
+declare const Show: typeof _componentShow & IElementDescriptor;
+type IShowEventProps = React.PropsWithChildren<{
     delay?: number;
     name?: string;
 }>;
-declare class ShowEvent extends NestedOption<IShowEventProps> {
-    static OptionName: string;
-}
-declare type IToProps = React.PropsWithChildren<{
+declare const _componentShowEvent: React.MemoExoticComponent<(props: IShowEventProps) => React.FunctionComponentElement<IShowEventProps>>;
+declare const ShowEvent: typeof _componentShowEvent & IElementDescriptor;
+type IToProps = React.PropsWithChildren<{
     left?: number;
     opacity?: number;
     position?: PositionConfig;
     scale?: number;
     top?: number;
 }>;
-declare class To extends NestedOption<IToProps> {
-    static OptionName: string;
-}
-declare type IToolbarItemProps = React.PropsWithChildren<{
+declare const _componentTo: React.MemoExoticComponent<(props: IToProps) => React.FunctionComponentElement<IToProps>>;
+declare const To: typeof _componentTo & IElementDescriptor;
+type IToolbarItemProps = React.PropsWithChildren<{
     cssClass?: string;
     disabled?: boolean;
     html?: string;
@@ -265,22 +189,12 @@ declare type IToolbarItemProps = React.PropsWithChildren<{
     widget?: "dxAutocomplete" | "dxButton" | "dxButtonGroup" | "dxCheckBox" | "dxDateBox" | "dxDropDownButton" | "dxMenu" | "dxSelectBox" | "dxSwitch" | "dxTabs" | "dxTextBox";
     menuItemRender?: (...params: any) => React.ReactNode;
     menuItemComponent?: React.ComponentType<any>;
-    menuItemKeyFn?: (data: any) => string;
     render?: (...params: any) => React.ReactNode;
     component?: React.ComponentType<any>;
-    keyFn?: (data: any) => string;
 }>;
-declare class ToolbarItem extends NestedOption<IToolbarItemProps> {
-    static OptionName: string;
-    static IsCollectionItem: boolean;
-    static TemplateProps: {
-        tmplOption: string;
-        render: string;
-        component: string;
-        keyFn: string;
-    }[];
-}
+declare const _componentToolbarItem: React.MemoExoticComponent<(props: IToolbarItemProps) => React.FunctionComponentElement<IToolbarItemProps>>;
+declare const ToolbarItem: typeof _componentToolbarItem & IElementDescriptor;
 export default Popover;
-export { Popover, IPopoverOptions, Animation, IAnimationProps, At, IAtProps, BoundaryOffset, IBoundaryOffsetProps, Collision, ICollisionProps, From, IFromProps, Hide, IHideProps, HideEvent, IHideEventProps, My, IMyProps, Offset, IOffsetProps, Position, IPositionProps, Show, IShowProps, ShowEvent, IShowEventProps, To, IToProps, ToolbarItem, IToolbarItemProps };
+export { Popover, IPopoverOptions, PopoverRef, Animation, IAnimationProps, At, IAtProps, BoundaryOffset, IBoundaryOffsetProps, Collision, ICollisionProps, From, IFromProps, Hide, IHideProps, HideEvent, IHideEventProps, My, IMyProps, Offset, IOffsetProps, Position, IPositionProps, Show, IShowProps, ShowEvent, IShowEventProps, To, IToProps, ToolbarItem, IToolbarItemProps };
 import type * as PopoverTypes from 'devextreme/ui/popover_types';
 export { PopoverTypes };