devextreme-react 25.1.1-alpha → 25.1.2-beta

package/esm/card-view.js

@@ -0,0 +1,798 @@
+/*!
+ * devextreme-react
+ * Version: 25.1.2-beta
+ * Build date: Wed May 14 2025
+ *
+ * Copyright (c) 2012 - 2025 Developer Express Inc. ALL RIGHTS RESERVED
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file in the root of the project for details.
+ *
+ * https://github.com/DevExpress/devextreme-react
+ */
+
+"use client";
+import * as React from "react";
+import { memo, forwardRef, useImperativeHandle, useRef, useMemo } from "react";
+import dxCardView from "devextreme/ui/card_view";
+import { Component as BaseComponent } from "./core/component";
+import NestedOption from "./core/nested-option";
+const CardView = memo(forwardRef((props, ref) => {
+    const baseRef = useRef(null);
+    useImperativeHandle(ref, () => ({
+        instance() {
+            return baseRef.current?.getInstance();
+        }
+    }), [baseRef.current]);
+    const subscribableOptions = useMemo(() => (["filterValue", "selectedCardKeys"]), []);
+    const independentEvents = useMemo(() => (["onCardClick", "onCardDblClick", "onCardInserted", "onCardInserting", "onCardPrepared", "onCardRemoved", "onCardRemoving", "onCardSaved", "onCardSaving", "onCardUpdated", "onCardUpdating", "onContentReady", "onContextMenuPreparing", "onDataErrorOccurred", "onDisposing", "onEditCanceled", "onEditCanceling", "onEditingStart", "onFieldCaptionClick", "onFieldCaptionDblClick", "onFieldCaptionPrepared", "onFieldValueClick", "onFieldValueDblClick", "onFieldValuePrepared", "onInitialized", "onInitNewCard", "onSelectionChanging"]), []);
+    const defaults = useMemo(() => ({
+        defaultFilterValue: "filterValue",
+        defaultSelectedCardKeys: "selectedCardKeys",
+    }), []);
+    const expectedChildren = useMemo(() => ({
+        cardCover: { optionName: "cardCover", isCollectionItem: false },
+        cardHeader: { optionName: "cardHeader", isCollectionItem: false },
+        column: { optionName: "columns", isCollectionItem: true },
+        editing: { optionName: "editing", isCollectionItem: false },
+        filterBuilder: { optionName: "filterBuilder", isCollectionItem: false },
+        headerPanel: { optionName: "headerPanel", isCollectionItem: false },
+        loadPanel: { optionName: "loadPanel", isCollectionItem: false },
+        pager: { optionName: "pager", isCollectionItem: false },
+        paging: { optionName: "paging", isCollectionItem: false },
+        remoteOperations: { optionName: "remoteOperations", isCollectionItem: false },
+        selection: { optionName: "selection", isCollectionItem: false },
+        toolbar: { optionName: "toolbar", isCollectionItem: false }
+    }), []);
+    const templateProps = useMemo(() => ([
+        {
+            tmplOption: "cardContentTemplate",
+            render: "cardContentRender",
+            component: "cardContentComponent"
+        },
+        {
+            tmplOption: "cardFooterTemplate",
+            render: "cardFooterRender",
+            component: "cardFooterComponent"
+        },
+        {
+            tmplOption: "cardTemplate",
+            render: "cardRender",
+            component: "cardComponent"
+        },
+        {
+            tmplOption: "noDataTemplate",
+            render: "noDataRender",
+            component: "noDataComponent"
+        },
+    ]), []);
+    return (React.createElement((BaseComponent), {
+        WidgetClass: dxCardView,
+        ref: baseRef,
+        subscribableOptions,
+        independentEvents,
+        defaults,
+        expectedChildren,
+        templateProps,
+        ...props,
+    }));
+}));
+const _componentAnimation = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "animation",
+            ExpectedChildren: {
+                hide: { optionName: "hide", isCollectionItem: false },
+                show: { optionName: "show", isCollectionItem: false }
+            },
+        },
+    });
+};
+const Animation = Object.assign(_componentAnimation, {
+    componentType: "option",
+});
+const _componentAsyncRule = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "validationRules",
+            IsCollectionItem: true,
+            PredefinedProps: {
+                type: "async"
+            },
+        },
+    });
+};
+const AsyncRule = Object.assign(_componentAsyncRule, {
+    componentType: "option",
+});
+const _componentAt = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "at",
+        },
+    });
+};
+const At = Object.assign(_componentAt, {
+    componentType: "option",
+});
+const _componentBoundaryOffset = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "boundaryOffset",
+        },
+    });
+};
+const BoundaryOffset = Object.assign(_componentBoundaryOffset, {
+    componentType: "option",
+});
+const _componentCardCover = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "cardCover",
+            TemplateProps: [{
+                    tmplOption: "template",
+                    render: "render",
+                    component: "component"
+                }],
+        },
+    });
+};
+const CardCover = Object.assign(_componentCardCover, {
+    componentType: "option",
+});
+const _componentCardHeader = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "cardHeader",
+            ExpectedChildren: {
+                cardHeaderItem: { optionName: "items", isCollectionItem: true },
+                item: { optionName: "items", isCollectionItem: true }
+            },
+            TemplateProps: [{
+                    tmplOption: "template",
+                    render: "render",
+                    component: "component"
+                }],
+        },
+    });
+};
+const CardHeader = Object.assign(_componentCardHeader, {
+    componentType: "option",
+});
+const _componentCardHeaderItem = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "items",
+            IsCollectionItem: true,
+            TemplateProps: [{
+                    tmplOption: "menuItemTemplate",
+                    render: "menuItemRender",
+                    component: "menuItemComponent"
+                }, {
+                    tmplOption: "template",
+                    render: "render",
+                    component: "component"
+                }],
+        },
+    });
+};
+const CardHeaderItem = Object.assign(_componentCardHeaderItem, {
+    componentType: "option",
+});
+const _componentChange = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "changes",
+            IsCollectionItem: true,
+        },
+    });
+};
+const Change = Object.assign(_componentChange, {
+    componentType: "option",
+});
+const _componentCollision = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "collision",
+        },
+    });
+};
+const Collision = Object.assign(_componentCollision, {
+    componentType: "option",
+});
+const _componentColumn = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "columns",
+            IsCollectionItem: true,
+            DefaultsProps: {
+                defaultFilterValue: "filterValue",
+                defaultFilterValues: "filterValues",
+                defaultSortIndex: "sortIndex",
+                defaultSortOrder: "sortOrder",
+                defaultVisible: "visible",
+                defaultVisibleIndex: "visibleIndex"
+            },
+            ExpectedChildren: {
+                AsyncRule: { optionName: "validationRules", isCollectionItem: true },
+                CompareRule: { optionName: "validationRules", isCollectionItem: true },
+                CustomRule: { optionName: "validationRules", isCollectionItem: true },
+                EmailRule: { optionName: "validationRules", isCollectionItem: true },
+                format: { optionName: "format", isCollectionItem: false },
+                formItem: { optionName: "formItem", isCollectionItem: false },
+                NumericRule: { optionName: "validationRules", isCollectionItem: true },
+                PatternRule: { optionName: "validationRules", isCollectionItem: true },
+                RangeRule: { optionName: "validationRules", isCollectionItem: true },
+                RequiredRule: { optionName: "validationRules", isCollectionItem: true },
+                StringLengthRule: { optionName: "validationRules", isCollectionItem: true },
+                validationRule: { optionName: "validationRules", isCollectionItem: true }
+            },
+            TemplateProps: [{
+                    tmplOption: "fieldCaptionTemplate",
+                    render: "fieldCaptionRender",
+                    component: "fieldCaptionComponent"
+                }, {
+                    tmplOption: "fieldTemplate",
+                    render: "fieldRender",
+                    component: "fieldComponent"
+                }, {
+                    tmplOption: "fieldValueTemplate",
+                    render: "fieldValueRender",
+                    component: "fieldValueComponent"
+                }, {
+                    tmplOption: "headerItemTemplate",
+                    render: "headerItemRender",
+                    component: "headerItemComponent"
+                }],
+        },
+    });
+};
+const Column = Object.assign(_componentColumn, {
+    componentType: "option",
+});
+const _componentCompareRule = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "validationRules",
+            IsCollectionItem: true,
+            PredefinedProps: {
+                type: "compare"
+            },
+        },
+    });
+};
+const CompareRule = Object.assign(_componentCompareRule, {
+    componentType: "option",
+});
+const _componentCustomOperation = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "customOperations",
+            IsCollectionItem: true,
+            TemplateProps: [{
+                    tmplOption: "editorTemplate",
+                    render: "editorRender",
+                    component: "editorComponent"
+                }],
+        },
+    });
+};
+const CustomOperation = Object.assign(_componentCustomOperation, {
+    componentType: "option",
+});
+const _componentCustomRule = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "validationRules",
+            IsCollectionItem: true,
+            PredefinedProps: {
+                type: "custom"
+            },
+        },
+    });
+};
+const CustomRule = Object.assign(_componentCustomRule, {
+    componentType: "option",
+});
+const _componentEditing = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "editing",
+            ExpectedChildren: {
+                change: { optionName: "changes", isCollectionItem: true }
+            },
+        },
+    });
+};
+const Editing = Object.assign(_componentEditing, {
+    componentType: "option",
+});
+const _componentEmailRule = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "validationRules",
+            IsCollectionItem: true,
+            PredefinedProps: {
+                type: "email"
+            },
+        },
+    });
+};
+const EmailRule = Object.assign(_componentEmailRule, {
+    componentType: "option",
+});
+const _componentField = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "fields",
+            IsCollectionItem: true,
+            ExpectedChildren: {
+                format: { optionName: "format", isCollectionItem: false },
+                lookup: { optionName: "lookup", isCollectionItem: false }
+            },
+            TemplateProps: [{
+                    tmplOption: "editorTemplate",
+                    render: "editorRender",
+                    component: "editorComponent"
+                }],
+        },
+    });
+};
+const Field = Object.assign(_componentField, {
+    componentType: "option",
+});
+const _componentFilterBuilder = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "filterBuilder",
+            DefaultsProps: {
+                defaultValue: "value"
+            },
+            ExpectedChildren: {
+                customOperation: { optionName: "customOperations", isCollectionItem: true },
+                field: { optionName: "fields", isCollectionItem: true },
+                filterOperationDescriptions: { optionName: "filterOperationDescriptions", isCollectionItem: false },
+                groupOperationDescriptions: { optionName: "groupOperationDescriptions", isCollectionItem: false }
+            },
+        },
+    });
+};
+const FilterBuilder = Object.assign(_componentFilterBuilder, {
+    componentType: "option",
+});
+const _componentFilterOperationDescriptions = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "filterOperationDescriptions",
+        },
+    });
+};
+const FilterOperationDescriptions = Object.assign(_componentFilterOperationDescriptions, {
+    componentType: "option",
+});
+const _componentFormat = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "format",
+        },
+    });
+};
+const Format = Object.assign(_componentFormat, {
+    componentType: "option",
+});
+const _componentFormItem = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "formItem",
+            ExpectedChildren: {
+                AsyncRule: { optionName: "validationRules", isCollectionItem: true },
+                CompareRule: { optionName: "validationRules", isCollectionItem: true },
+                CustomRule: { optionName: "validationRules", isCollectionItem: true },
+                EmailRule: { optionName: "validationRules", isCollectionItem: true },
+                label: { optionName: "label", isCollectionItem: false },
+                NumericRule: { optionName: "validationRules", isCollectionItem: true },
+                PatternRule: { optionName: "validationRules", isCollectionItem: true },
+                RangeRule: { optionName: "validationRules", isCollectionItem: true },
+                RequiredRule: { optionName: "validationRules", isCollectionItem: true },
+                StringLengthRule: { optionName: "validationRules", isCollectionItem: true },
+                validationRule: { optionName: "validationRules", isCollectionItem: true }
+            },
+            TemplateProps: [{
+                    tmplOption: "template",
+                    render: "render",
+                    component: "component"
+                }],
+        },
+    });
+};
+const FormItem = Object.assign(_componentFormItem, {
+    componentType: "option",
+});
+const _componentFrom = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "from",
+            ExpectedChildren: {
+                position: { optionName: "position", isCollectionItem: false }
+            },
+        },
+    });
+};
+const From = Object.assign(_componentFrom, {
+    componentType: "option",
+});
+const _componentGroupOperationDescriptions = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "groupOperationDescriptions",
+        },
+    });
+};
+const GroupOperationDescriptions = Object.assign(_componentGroupOperationDescriptions, {
+    componentType: "option",
+});
+const _componentHeaderPanel = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "headerPanel",
+            TemplateProps: [{
+                    tmplOption: "itemTemplate",
+                    render: "itemRender",
+                    component: "itemComponent"
+                }],
+        },
+    });
+};
+const HeaderPanel = Object.assign(_componentHeaderPanel, {
+    componentType: "option",
+});
+const _componentHide = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "hide",
+            ExpectedChildren: {
+                from: { optionName: "from", isCollectionItem: false },
+                to: { optionName: "to", isCollectionItem: false }
+            },
+        },
+    });
+};
+const Hide = Object.assign(_componentHide, {
+    componentType: "option",
+});
+const _componentItem = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "items",
+            IsCollectionItem: true,
+            TemplateProps: [{
+                    tmplOption: "menuItemTemplate",
+                    render: "menuItemRender",
+                    component: "menuItemComponent"
+                }, {
+                    tmplOption: "template",
+                    render: "render",
+                    component: "component"
+                }],
+        },
+    });
+};
+const Item = Object.assign(_componentItem, {
+    componentType: "option",
+});
+const _componentLabel = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "label",
+            TemplateProps: [{
+                    tmplOption: "template",
+                    render: "render",
+                    component: "component"
+                }],
+        },
+    });
+};
+const Label = Object.assign(_componentLabel, {
+    componentType: "option",
+});
+const _componentLoadPanel = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "loadPanel",
+            DefaultsProps: {
+                defaultPosition: "position",
+                defaultVisible: "visible"
+            },
+            ExpectedChildren: {
+                animation: { optionName: "animation", isCollectionItem: false },
+                position: { optionName: "position", isCollectionItem: false }
+            },
+        },
+    });
+};
+const LoadPanel = Object.assign(_componentLoadPanel, {
+    componentType: "option",
+});
+const _componentLookup = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "lookup",
+        },
+    });
+};
+const Lookup = Object.assign(_componentLookup, {
+    componentType: "option",
+});
+const _componentMy = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "my",
+        },
+    });
+};
+const My = Object.assign(_componentMy, {
+    componentType: "option",
+});
+const _componentNumericRule = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "validationRules",
+            IsCollectionItem: true,
+            PredefinedProps: {
+                type: "numeric"
+            },
+        },
+    });
+};
+const NumericRule = Object.assign(_componentNumericRule, {
+    componentType: "option",
+});
+const _componentOffset = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "offset",
+        },
+    });
+};
+const Offset = Object.assign(_componentOffset, {
+    componentType: "option",
+});
+const _componentPager = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "pager",
+        },
+    });
+};
+const Pager = Object.assign(_componentPager, {
+    componentType: "option",
+});
+const _componentPaging = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "paging",
+            DefaultsProps: {
+                defaultPageIndex: "pageIndex",
+                defaultPageSize: "pageSize"
+            },
+        },
+    });
+};
+const Paging = Object.assign(_componentPaging, {
+    componentType: "option",
+});
+const _componentPatternRule = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "validationRules",
+            IsCollectionItem: true,
+            PredefinedProps: {
+                type: "pattern"
+            },
+        },
+    });
+};
+const PatternRule = Object.assign(_componentPatternRule, {
+    componentType: "option",
+});
+const _componentPosition = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "position",
+            ExpectedChildren: {
+                at: { optionName: "at", isCollectionItem: false },
+                boundaryOffset: { optionName: "boundaryOffset", isCollectionItem: false },
+                collision: { optionName: "collision", isCollectionItem: false },
+                my: { optionName: "my", isCollectionItem: false },
+                offset: { optionName: "offset", isCollectionItem: false }
+            },
+        },
+    });
+};
+const Position = Object.assign(_componentPosition, {
+    componentType: "option",
+});
+const _componentRangeRule = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "validationRules",
+            IsCollectionItem: true,
+            PredefinedProps: {
+                type: "range"
+            },
+        },
+    });
+};
+const RangeRule = Object.assign(_componentRangeRule, {
+    componentType: "option",
+});
+const _componentRemoteOperations = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "remoteOperations",
+        },
+    });
+};
+const RemoteOperations = Object.assign(_componentRemoteOperations, {
+    componentType: "option",
+});
+const _componentRequiredRule = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "validationRules",
+            IsCollectionItem: true,
+            PredefinedProps: {
+                type: "required"
+            },
+        },
+    });
+};
+const RequiredRule = Object.assign(_componentRequiredRule, {
+    componentType: "option",
+});
+const _componentSelection = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "selection",
+        },
+    });
+};
+const Selection = Object.assign(_componentSelection, {
+    componentType: "option",
+});
+const _componentShow = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "show",
+            ExpectedChildren: {
+                from: { optionName: "from", isCollectionItem: false },
+                to: { optionName: "to", isCollectionItem: false }
+            },
+        },
+    });
+};
+const Show = Object.assign(_componentShow, {
+    componentType: "option",
+});
+const _componentStringLengthRule = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "validationRules",
+            IsCollectionItem: true,
+            PredefinedProps: {
+                type: "stringLength"
+            },
+        },
+    });
+};
+const StringLengthRule = Object.assign(_componentStringLengthRule, {
+    componentType: "option",
+});
+const _componentTo = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "to",
+            ExpectedChildren: {
+                position: { optionName: "position", isCollectionItem: false }
+            },
+        },
+    });
+};
+const To = Object.assign(_componentTo, {
+    componentType: "option",
+});
+const _componentToolbar = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "toolbar",
+            ExpectedChildren: {
+                item: { optionName: "items", isCollectionItem: true },
+                toolbarItem: { optionName: "items", isCollectionItem: true }
+            },
+        },
+    });
+};
+const Toolbar = Object.assign(_componentToolbar, {
+    componentType: "option",
+});
+const _componentToolbarItem = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "items",
+            IsCollectionItem: true,
+            TemplateProps: [{
+                    tmplOption: "menuItemTemplate",
+                    render: "menuItemRender",
+                    component: "menuItemComponent"
+                }, {
+                    tmplOption: "template",
+                    render: "render",
+                    component: "component"
+                }],
+        },
+    });
+};
+const ToolbarItem = Object.assign(_componentToolbarItem, {
+    componentType: "option",
+});
+const _componentValidationRule = (props) => {
+    return React.createElement((NestedOption), {
+        ...props,
+        elementDescriptor: {
+            OptionName: "validationRules",
+            IsCollectionItem: true,
+            PredefinedProps: {
+                type: "required"
+            },
+        },
+    });
+};
+const ValidationRule = Object.assign(_componentValidationRule, {
+    componentType: "option",
+});
+export default CardView;
+export { CardView, Animation, AsyncRule, At, BoundaryOffset, CardCover, CardHeader, CardHeaderItem, Change, Collision, Column, CompareRule, CustomOperation, CustomRule, Editing, EmailRule, Field, FilterBuilder, FilterOperationDescriptions, Format, FormItem, From, GroupOperationDescriptions, HeaderPanel, Hide, Item, Label, LoadPanel, Lookup, My, NumericRule, Offset, Pager, Paging, PatternRule, Position, RangeRule, RemoteOperations, RequiredRule, Selection, Show, StringLengthRule, To, Toolbar, ToolbarItem, ValidationRule };