@progress/kendo-react-data-tools 13.3.0-develop.9 → 13.4.0-develop.1

package/clipboard/clipboard.service.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { ClipboardActionType } from './common.js';
+/**
+ * @hidden
+ */
+export declare class ClipboardService {
+    private clipboardEvent;
+    constructor(ClipboardEventHandler: (clipboardType: ClipboardActionType, event: ClipboardEvent) => void);
+    private copyHandler;
+    private cutHandler;
+    private pasteHandler;
+    addEventListeners: (document: Document | undefined) => void;
+    removeEventListeners: (document: Document | undefined) => void;
+}

package/clipboard/common.d.ts

@@ -0,0 +1,188 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { ColumnBaseProps } from '../header/index.js';
+import { SelectDescriptor } from '../selection/TableSelection.js';
+/**
+ * The possible values of the  `type` property.
+ */
+export declare enum ClipboardActionType {
+    copy = "copy",
+    cut = "cut",
+    paste = "paste"
+}
+/**
+ * Represents the object of the `ClipboardDataEvent` event.
+ */
+export interface ClipboardDataEvent {
+    /**
+     * Represents the type of the clipboard action.
+     */
+    type: ClipboardActionType;
+    /**
+     * Represents the native [ClipboardEvent](https://www.telerik.com/kendo-react-ui/components/grid/api/gridcellssettings)
+     */
+    nativeEvent?: ClipboardEvent;
+    /**
+     * All the Grid columns. It takes value of type of [ColumnBaseProps](https://www.telerik.com/kendo-react-ui/components/datatools/api/columnbaseprops)<[CellProps](https://www.telerik.com/kendo-react-ui/components/datatools/api/cellprops)>[]
+     */
+    columns: ColumnBaseProps[];
+    /**
+     * Passes the dataItemKey prop in the clipboard action.
+     */
+    dataItemKey: string;
+    /**
+     * Passes the clipboard prop copyHeaders value in the clipboard action.
+     */
+    copyHeaders?: boolean;
+    /**
+     * Sets the cell delimiter used when manipulating the clipboard data Defaults to `\t`.
+     */
+    cellDelimiter?: string;
+    /**
+     * Sets the row delimiter used when manipulating the clipboard data Defaults to `\r\n`.
+     */
+    newLineDelimiter?: string;
+    /**
+     * This is the item that is clicked if the action is raised from the contextMenu.
+     */
+    dataItem?: any;
+    /**
+     *  This is the column field that is clicked if the action is raised from the contextMenu.
+     */
+    field?: string;
+}
+/**
+ * Represents the object of the `GridClipboardEvent` event.
+ */
+export interface GridClipboardEvent extends ClipboardDataEvent, ClipboardData {
+}
+/**
+ * Represents the `PopulateClipboardArgs` event argument.
+ */
+export interface PopulateClipboardArgs {
+    /**
+     * Represents the base object of the `ClipboardDataEvent` event.
+     */
+    event: ClipboardDataEvent;
+    /**
+     * Represents the current selected state of the data.
+     */
+    selectedState: SelectDescriptor;
+    /**
+     * Passes the data currently displayed.
+     */
+    data: any[];
+    /**
+     * Passes dataItemKey name of the field that could be used to make difference between dataItems.
+     */
+    dataItemKey?: string;
+    /**
+     * Passes subItemsField that will be used in grouping cases.
+     */
+    subItemsField?: string;
+    /**
+     * Previous copied items.
+     */
+    previousCopiedItems?: ClipboardItem[];
+}
+/**
+ * Represents the object that is returned form the `populateClipboardData` function.
+ */
+export interface ClipboardData {
+    /**
+     * A collection of the ClipboardItem that are selected.
+     */
+    copiedItems: ClipboardItem[];
+    /**
+     * A collection of the ClipboardItem that are pasted.
+     */
+    pastedItems: ClipboardItem[];
+    /**
+     * When the action is `copy` or `cut` - the Grid data, copied to the clipboard, in Excel-compatible format.
+     * When the action is `paste` - the current clipboard data, available in the original DOM event.
+     */
+    clipboardData: string;
+}
+/**
+ * Represents the aria that is copied - the dataItem and the fields.
+ */
+export interface ClipboardItem {
+    /**
+     * Represents the dataItem used in the clipboard action.
+     */
+    dataItem: any;
+    /**
+     * Represents the fields used in the clipboard action.
+     */
+    fields: string[];
+}
+/**
+ * Represents settings that can be added to the clipboard behavior.
+ */
+export interface ClipboardSettings {
+    /**
+     * Determines whether column titles or field names will be included in the generated data
+     * during the `copy` and `cut` actions.
+     * Defaults to `false`.
+     */
+    copyHeaders: boolean;
+    /**
+     * Determines what is the delimiter used to separate the cells.
+     * Defaults to `\t`.
+     */
+    cellDelimiter?: string;
+    /**
+     * Determines what is the delimiter used to separate the rows.
+     * Defaults to `'\r\n'`.
+     */
+    newLineDelimiter?: string;
+}
+/**
+ * @hidden
+ */
+export declare const getItemsToUpdateOnPaste: (args: PopulateClipboardArgs, selectedItems: ClipboardItem[], dataLength: number, dataItemKey: string) => any[];
+/**
+ * @hidden
+ */
+export declare const getPreviouslyCopiedItemsData: (previousCopiedItems?: ClipboardItem[]) => any[][];
+/**
+ * @hidden
+ */
+export declare const getClipboardItemsToPaste: (args: PopulateClipboardArgs, clipboardText: string) => string[][];
+/**
+ * @hidden
+ */
+export declare const getItemsToPaste: (args: PopulateClipboardArgs, clipboardText: string) => any[][];
+/**
+ * @hidden
+ */
+export declare const getPastedItems: (args: PopulateClipboardArgs, clipboardText: string) => ClipboardItem[];
+/**
+ * @hidden
+ */
+export declare const itemToString: (item: any, cols: string[]) => string | null;
+/**
+ * @hidden
+ */
+export declare const addHeaders: (initialData: string, cols: string[], event: ClipboardDataEvent) => string;
+/**
+ * @hidden
+ */
+export declare const getSelectedItems: (args: PopulateClipboardArgs) => ClipboardItem[];
+/**
+ * @hidden
+ */
+export declare const getClipboardText: (copiedItems: ClipboardItem[], event: ClipboardDataEvent) => string;
+/**
+ * @hidden
+ */
+export declare const getClipboardData: (event: ClipboardDataEvent, copiedItems: ClipboardItem[]) => string;
+/**
+ * A function used to populate the Clipboard data.
+ */
+export declare const populateClipboardData: (args: PopulateClipboardArgs) => ClipboardData;

package/columnmenu/ColumnMenu.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { SortDescriptor, CompositeFilterDescriptor } from '@progress/kendo-data-query';
+import * as React from 'react';
+/**
+ * Defines the props of the ColumnMenu component.
+ */
+export interface ColumnMenuProps {
+    /**
+     * Sets the `SortDescriptor[]` applied to the data.
+     */
+    sort?: SortDescriptor[];
+    /**
+     * Fires when sorting changes. Receives the browser event, the new `SortDescriptor[]`, and the column `field`.
+     */
+    onSortChange?: (event: React.SyntheticEvent<any>, sort: SortDescriptor[], field: string) => void;
+    /**
+     * Sets the `CompositeFilterDescriptor[]` applied to the data.
+     */
+    filter?: CompositeFilterDescriptor[];
+    /**
+     * Fires when filtering changes. Receives the browser event, the new `CompositeFilterDescriptor[]`, and the column `field`.
+     */
+    onFilterChange?: (event: React.SyntheticEvent<any>, filter: CompositeFilterDescriptor[], field: string) => void;
+    /**
+     * Sets the column `field` the menu operates on.
+     */
+    field?: string;
+    /**
+     * Shows the ascending sort button when `true`.
+     *
+     * @default false
+     */
+    sortAsc?: boolean;
+    /**
+     * Shows the descending sort button when `true`.
+     *
+     * @default false
+     */
+    sortDesc?: boolean;
+    /**
+     * Provides the filtering UI components in render order. Supply up to three components: first filter, logic, second filter.
+     */
+    filterContent?: any[];
+    /**
+     * Sets the initial expand state of the filters.
+     *
+     * @default false
+     */
+    expandFilters?: boolean;
+    /**
+     * Returns the initial `CompositeFilterDescriptor` based on the current `field`. Use to customize starting filter values.
+     */
+    initialFilter?: (field: string) => CompositeFilterDescriptor;
+    /**
+     * Fires before the ColumnMenu items render. Use to add or remove items.
+     * `defaultRendering` holds sorting and filtering elements.
+     * `props` exposes the column `field` and `closeMenu()` helper.
+     */
+    itemsRender?: (defaultRendering: (React.ReactElement<HTMLDivElement> | null)[], props: {
+        field?: string;
+        closeMenu: () => void;
+    }) => React.ReactNode;
+    /**
+     * Fires before the ColumnMenu renders. Use to override the entire rendering.
+     * `defaultRendering` contains the menu button and popup elements (and license watermark when present).
+     */
+    render?: (defaultRendering: React.ReactElement<any>[]) => React.ReactNode;
+}
+/**
+ * Represents the ColumnMenuTextColumn component. Use it for `string` type columns.
+ */
+export declare const ColumnMenuTextColumn: React.FunctionComponent<ColumnMenuProps>;
+/**
+ * Represents the ColumnMenuNumericColumn component. Use it for `number` type columns.
+ */
+export declare const ColumnMenuNumericColumn: React.FunctionComponent<ColumnMenuProps>;
+/**
+ * Represents the ColumnMenuDateColumn component. Use it for `Date` type columns.
+ */
+export declare const ColumnMenuDateColumn: React.FunctionComponent<ColumnMenuProps>;
+/**
+ * Represents the ColumnMenuBooleanColumn component. Use it for `boolean` type columns.
+ */
+export declare const ColumnMenuBooleanColumn: React.FunctionComponent<ColumnMenuProps>;

package/columnmenu/ColumnMenuFilterForm.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import * as React from 'react';
+export interface ColumnMenuFormProps {
+    /** Whether to show the form */
+    show?: boolean;
+    /** Event handler for form submission */
+    onSubmit?: React.FormEventHandler<HTMLFormElement>;
+    /** Event handler for form reset */
+    onReset?: React.FormEventHandler<HTMLFormElement>;
+    /** Action buttons or custom action elements */
+    actions?: React.ReactNode;
+    /** Form content and child elements */
+    children?: React.ReactNode;
+}
+export declare const ColumnMenuForm: React.FunctionComponent<ColumnMenuFormProps>;
+/**
+ * @hidden
+ */
+export declare const ColumnMenuFilterForm: React.FunctionComponent<ColumnMenuFormProps>;

package/columnmenu/ColumnMenuFilterLogic.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { DropDownListProps } from '@progress/kendo-react-dropdowns';
+import * as React from 'react';
+export declare const ColumnMenuFilterLogic: React.FunctionComponent<DropDownListProps>;

package/columnmenu/ColumnMenuFilterLogic.mjs

@@ -9,14 +9,14 @@
 import * as n from "react";
 import { DropDownList as i } from "@progress/kendo-react-dropdowns";
 import { useLocalization as l } from "@progress/kendo-react-intl";
-import { messages as c, columnMenuFilterAndLogic as r, columnMenuFilterOrLogic as m } from "../messages/index.mjs";
+import { columnMenuFilterAndLogic as c, columnMenuFilterOrLogic as r, messages as m } from "../messages/index.mjs";
 const g = [
-  { text: r, logic: "and" },
-  { text: m, logic: "or" }
+  { text: c, logic: "and" },
+  { text: r, logic: "or" }
 ], d = (e) => {
   const a = l(), o = (e.data || g).map((t) => ({
     ...t,
-    text: a.toLanguageString(t.text, c[t.text])
+    text: a.toLanguageString(t.text, m[t.text])
   }));
   return /* @__PURE__ */ n.createElement(
     i,

package/columnmenu/ColumnMenuFilters.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { FilterDescriptor } from '@progress/kendo-data-query';
+import * as React from 'react';
+export interface ColumnMenuFilterProps {
+    /** The current filter descriptor for the column */
+    filter: FilterDescriptor;
+    /** Event handler for filter changes */
+    onFilterChange: (event: React.SyntheticEvent<any>, nextFilter: FilterDescriptor, prevFilter: FilterDescriptor) => void;
+    /** Available filter operators for the column */
+    operators?: {
+        text: string;
+        operator: string;
+    }[];
+    /** Initial filter descriptor when creating a new filter */
+    initialFilter?: FilterDescriptor;
+    /** Custom input component for filter value entry */
+    input?: React.ComponentType<{
+        value: any;
+        onChange: any;
+    }>;
+}
+export declare const ColumnMenuBooleanFilter: React.FunctionComponent<ColumnMenuFilterProps>;
+export declare const ColumnMenuTextFilter: React.FunctionComponent<ColumnMenuFilterProps>;
+export declare const ColumnMenuNumericFilter: React.FunctionComponent<ColumnMenuFilterProps>;
+export declare const ColumnMenuDateFilter: React.FunctionComponent<ColumnMenuFilterProps>;

package/columnmenu/ColumnMenuItem.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { SVGIcon } from '@progress/kendo-react-common';
+import * as React from 'react';
+/**
+ * Defines the props of the ColumnMenuItem component.
+ */
+export interface ColumnMenuItemProps {
+    /**
+     * Fires when the item is clicked.
+     */
+    onClick?: (event: React.MouseEvent<HTMLDivElement>) => void;
+    /**
+     * Indicates that the item is selected when `true`.
+     */
+    selected?: boolean;
+    /**
+     * Disables the item when `true`.
+     */
+    disabled?: boolean;
+    /**
+     * Sets the font icon CSS class.
+     */
+    iconClass?: string;
+    /**
+     * Sets the SVG icon definition.
+     */
+    svgIcon?: SVGIcon;
+    /**
+     * Sets the item title text.
+     */
+    title: string;
+}
+export declare const ColumnMenuItem: React.FunctionComponent<ColumnMenuItemProps>;

package/columnmenu/ColumnMenuOperators.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { FilterOperator } from '../filteringCells/index.js';
+/**
+ * Represents the operators for the ColumnMenuTextFilter, ColumnMenuNumericFilter,
+ * ColumnMenuDateFilter and ColumnMenuBooleanFilter components.
+ *
+ * The text field of each operator object will be resolved according to the
+ * [localization messages](https://www.telerik.com/kendo-react-ui/components/datatools/globalization#toc-messages).
+ */
+export declare class ColumnMenuOperators {
+    /**
+     * An array containing the operators for the ColumnMenuTextFilter component.
+     *
+     * The operators are:
+     *
+     * - { text: 'columnMenu.filterContainsOperator', operator: 'contains' }
+     * - { text: 'columnMenu.filterNotContainsOperator', operator: 'doesnotcontain' }
+     * - { text: 'columnMenu.filterEqOperator', operator: 'eq' }
+     * - { text: 'columnMenu.filterNotEqOperator', operator: 'neq' }
+     * - { text: 'columnMenu.filterStartsWithOperator', operator: 'startswith' }
+     * - { text: 'columnMenu.filterEndsWithOperator', operator: 'endswith' }
+     * - { text: 'columnMenu.filterIsNullOperator', operator: 'isnull' }
+     * - { text: 'columnMenu.filterIsNotNullOperator', operator: 'isnotnull' }
+     * - { text: 'columnMenu.filterIsEmptyOperator', operator: 'isempty' }
+     * - { text: 'columnMenu.filterIsNotEmptyOperator', operator: 'isnotempty' }
+     */
+    static get text(): FilterOperator[];
+    /**
+     * An array containing the operators for the ColumnMenuNumericFilter component.
+     *
+     * The operators are:
+     *
+     * - { text: 'columnMenu.filterEqOperator', operator: 'eq' }
+     * - { text: 'columnMenu.filterNotEqOperator', operator: 'neq' }
+     * - { text: 'columnMenu.filterGteOperator', operator: 'gte' }
+     * - { text: 'columnMenu.filterGtOperator', operator: 'gt' }
+     * - { text: 'columnMenu.filterLteOperator', operator: 'lte' }
+     * - { text: 'columnMenu.filterLtOperator', operator: 'lt' }
+     * - { text: 'columnMenu.filterIsNullOperator', operator: 'isnull' }
+     * - { text: 'columnMenu.filterIsNotNullOperator', operator: 'isnotnull' }
+     */
+    static get numeric(): FilterOperator[];
+    /**
+     * An array containing the operators for the ColumnMenuDateFilter component.
+     *
+     * The operators are:
+     *
+     * - { text: 'columnMenu.filterEqOperator', operator: 'eq' }
+     * - { text: 'columnMenu.filterNotEqOperator', operator: 'neq' }
+     * - { text: 'columnMenu.filterAfterOrEqualOperator', operator: 'gte' }
+     * - { text: 'columnMenu.filterAfterOperator', operator: 'gt' }
+     * - { text: 'columnMenu.filterBeforeOperator', operator: 'lt' }
+     * - { text: 'columnMenu.filterBeforeOrEqualOperator', operator: 'lte' }
+     * - { text: 'columnMenu.filterIsNullOperator', operator: 'isnull' }
+     * - { text: 'columnMenu.filterIsNotNullOperator', operator: 'isnotnull' }
+     */
+    static get date(): FilterOperator[];
+    /**
+     * An array containing the operators for the ColumnMenuBooleanFilter component.
+     *
+     * The operators are:
+     *
+     * - { text: 'columnMenu.filterIsTrue', operator: '' }
+     */
+    static get boolean(): FilterOperator[];
+}

package/columnmenu/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+export * from './ColumnMenu.js';
+export * from './ColumnMenuFilterForm.js';
+export * from './ColumnMenuFilterLogic.js';
+export * from './ColumnMenuFilters.js';
+export * from './ColumnMenuItem.js';
+export * from './ColumnMenuOperators.js';