devextreme-react 23.2.6 → 24.1.2-beta

package/cjs/drop-down-button.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,10 +11,10 @@
  * https://github.com/DevExpress/devextreme-react
  */
 
-/// <reference types="react" />
+import * as React from "react";
+import { Ref, ReactElement } from "react";
 import dxDropDownButton, { Properties } from "devextreme/ui/drop_down_button";
-import { Component as BaseComponent, IHtmlOptions } from "./core/component";
-import NestedOption from "./core/nested-option";
+import { IHtmlOptions, IElementDescriptor } from "./core/component";
 import type { ButtonClickEvent, ContentReadyEvent, DisposingEvent, InitializedEvent, ItemClickEvent } from "devextreme/ui/drop_down_button";
 import type { AnimationConfig, AnimationState } from "devextreme/animation/fx";
 import type { event, EventInfo } from "devextreme/events/index";
@@ -26,84 +26,55 @@ import type { CollectionWidgetItem } from "devextreme/ui/collection/ui.collectio
 import type dxOverlay from "devextreme/ui/overlay";
 import type DOMComponent from "devextreme/core/dom_component";
 import type dxPopup from "devextreme/ui/popup";
-declare type ReplaceFieldTypes<TSource, TReplacement> = {
+type ReplaceFieldTypes<TSource, TReplacement> = {
     [P in keyof TSource]: P extends keyof TReplacement ? TReplacement[P] : TSource[P];
 };
-declare type IDropDownButtonOptionsNarrowedEvents = {
+type IDropDownButtonOptionsNarrowedEvents = {
     onButtonClick?: ((e: ButtonClickEvent) => void);
     onContentReady?: ((e: ContentReadyEvent) => void);
     onDisposing?: ((e: DisposingEvent) => void);
     onInitialized?: ((e: InitializedEvent) => void);
     onItemClick?: ((e: ItemClickEvent) => void);
 };
-declare type IDropDownButtonOptions = React.PropsWithChildren<ReplaceFieldTypes<Properties, IDropDownButtonOptionsNarrowedEvents> & IHtmlOptions & {
+type IDropDownButtonOptions = React.PropsWithChildren<ReplaceFieldTypes<Properties, IDropDownButtonOptionsNarrowedEvents> & IHtmlOptions & {
     dropDownContentRender?: (...params: any) => React.ReactNode;
     dropDownContentComponent?: React.ComponentType<any>;
-    dropDownContentKeyFn?: (data: any) => string;
     itemRender?: (...params: any) => React.ReactNode;
     itemComponent?: React.ComponentType<any>;
-    itemKeyFn?: (data: any) => string;
+    render?: (...params: any) => React.ReactNode;
+    component?: React.ComponentType<any>;
 }>;
-declare class DropDownButton extends BaseComponent<React.PropsWithChildren<IDropDownButtonOptions>> {
-    get instance(): dxDropDownButton;
-    protected _WidgetClass: typeof dxDropDownButton;
-    protected independentEvents: string[];
-    protected _expectedChildren: {
-        dropDownOptions: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-        item: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-    };
-    protected _templateProps: {
-        tmplOption: string;
-        render: string;
-        component: string;
-        keyFn: string;
-    }[];
+interface DropDownButtonRef {
+    instance: () => dxDropDownButton;
 }
-declare type IAnimationProps = React.PropsWithChildren<{
+declare const DropDownButton: (props: React.PropsWithChildren<IDropDownButtonOptions> & {
+    ref?: Ref<DropDownButtonRef>;
+}) => 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 IDropDownOptionsProps = React.PropsWithChildren<{
+declare const _componentCollision: React.MemoExoticComponent<(props: ICollisionProps) => React.FunctionComponentElement<ICollisionProps>>;
+declare const Collision: typeof _componentCollision & IElementDescriptor;
+type IDropDownOptionsProps = React.PropsWithChildren<{
     accessKey?: string;
     animation?: Record<string, any> | {
         hide?: AnimationConfig;
@@ -113,13 +84,11 @@ declare type IDropDownOptionsProps = React.PropsWithChildren<{
     closeOnOutsideClick?: boolean | ((event: event) => boolean);
     container?: any | string;
     contentTemplate?: ((contentElement: any) => string | any) | template;
-    copyRootClassesToWrapper?: boolean;
     deferRendering?: boolean;
     disabled?: boolean;
     dragAndResizeArea?: any | string;
     dragEnabled?: boolean;
     dragOutsideBoundary?: boolean;
-    elementAttr?: any;
     enableBodyScroll?: boolean;
     focusStateEnabled?: boolean;
     fullScreen?: boolean;
@@ -216,57 +185,21 @@ declare type IDropDownOptionsProps = React.PropsWithChildren<{
     onWidthChange?: (value: (() => number | string) | number | string) => void;
     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;
 }>;
-declare class DropDownOptions extends NestedOption<IDropDownOptionsProps> {
-    static OptionName: string;
-    static DefaultsProps: {
-        defaultHeight: string;
-        defaultPosition: string;
-        defaultVisible: string;
-        defaultWidth: string;
-    };
-    static ExpectedChildren: {
-        animation: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-        position: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-        toolbarItem: {
-            optionName: string;
-            isCollectionItem: boolean;
-        };
-    };
-    static TemplateProps: {
-        tmplOption: string;
-        render: string;
-        component: string;
-        keyFn: string;
-    }[];
-}
-declare type IFromProps = React.PropsWithChildren<{
+declare const _componentDropDownOptions: React.MemoExoticComponent<(props: IDropDownOptionsProps) => React.FunctionComponentElement<IDropDownOptionsProps>>;
+declare const DropDownOptions: typeof _componentDropDownOptions & 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";
@@ -278,20 +211,9 @@ 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 IItemProps = React.PropsWithChildren<{
+declare const _componentHide: React.MemoExoticComponent<(props: IHideProps) => React.FunctionComponentElement<IHideProps>>;
+declare const Hide: typeof _componentHide & IElementDescriptor;
+type IItemProps = React.PropsWithChildren<{
     badge?: string;
     disabled?: boolean;
     html?: string;
@@ -302,33 +224,22 @@ declare type IItemProps = React.PropsWithChildren<{
     visible?: boolean;
     render?: (...params: any) => React.ReactNode;
     component?: React.ComponentType<any>;
-    keyFn?: (data: any) => string;
 }>;
-declare class Item extends NestedOption<IItemProps> {
-    static OptionName: string;
-    static IsCollectionItem: boolean;
-    static TemplateProps: {
-        tmplOption: string;
-        render: string;
-        component: string;
-        keyFn: string;
-    }[];
-}
-declare type IMyProps = React.PropsWithChildren<{
+declare const _componentItem: React.MemoExoticComponent<(props: IItemProps) => React.FunctionComponentElement<IItemProps>>;
+declare const Item: typeof _componentItem & 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";
@@ -352,10 +263,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";
@@ -367,20 +277,18 @@ 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 IToProps = React.PropsWithChildren<{
+declare const _componentShow: React.MemoExoticComponent<(props: IShowProps) => React.FunctionComponentElement<IShowProps>>;
+declare const Show: typeof _componentShow & 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;
@@ -396,22 +304,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 DropDownButton;
-export { DropDownButton, IDropDownButtonOptions, Animation, IAnimationProps, At, IAtProps, BoundaryOffset, IBoundaryOffsetProps, Collision, ICollisionProps, DropDownOptions, IDropDownOptionsProps, From, IFromProps, Hide, IHideProps, Item, IItemProps, My, IMyProps, Offset, IOffsetProps, Position, IPositionProps, Show, IShowProps, To, IToProps, ToolbarItem, IToolbarItemProps };
+export { DropDownButton, IDropDownButtonOptions, DropDownButtonRef, Animation, IAnimationProps, At, IAtProps, BoundaryOffset, IBoundaryOffsetProps, Collision, ICollisionProps, DropDownOptions, IDropDownOptionsProps, From, IFromProps, Hide, IHideProps, Item, IItemProps, My, IMyProps, Offset, IOffsetProps, Position, IPositionProps, Show, IShowProps, To, IToProps, ToolbarItem, IToolbarItemProps };
 import type * as DropDownButtonTypes from 'devextreme/ui/drop_down_button_types';
 export { DropDownButtonTypes };