@progress/kendo-react-data-tools 12.0.2-develop.1 → 12.0.2-develop.2

package/index.d.ts

@@ -107,7 +107,7 @@ export declare interface CellProps {
      */
     id: string;
     /**
-     * The index to be applied to the `aria-colindex` attribute.
+     * The index applied to the `aria-colindex` attribute.
      */
     ariaColumnIndex: number;
     /**
@@ -127,30 +127,29 @@ export declare interface CellProps {
      */
     isAlt?: boolean;
     /**
-     * The expanded value of the cell.
+     * Indicates if the cell is expanded.
      */
     expanded?: boolean;
     /**
-     * The custom CSS classes of the cells.
+     * Custom CSS classes for the cell.
      */
     className?: string;
     /**
-     * The styles for the cell.
+     * Inline styles for the cell.
      */
     style?: React_2.CSSProperties;
     /**
-     * The field to which the cell is bound.
+     * The data field that the cell binds to.
      */
     field?: string;
     /**
-     * The data item which corresponds to the current row.
+     * The data item for the current row.
      */
     dataItem: any;
     /**
-     * The format that is applied to the value before the value is displayed.
+     * The format applied to the value before display.
      * Takes the `{0:format}` form where `format` is a standard number format, a custom number format,
-     * a standard date format, or a custom date format. For more information on the supported date and number formats,
-     * refer to the [kendo-intl](https://github.com/telerik/kendo-intl/blob/develop/docs/index.md) documentation.
+     * a standard date format, or a custom date format.
      */
     format?: string;
     /**
@@ -158,13 +157,13 @@ export declare interface CellProps {
      */
     colSpan?: number;
     /**
-     * The event that is fired when the cell is selected.
+     * Fires when the cell is selected.
      */
     selectionChange?: (event: {
         syntheticEvent: React_2.SyntheticEvent<any>;
     }) => void;
     /**
-     * The event that is fired when the cell value is changed.
+     * Fires when the cell value changes.
      */
     onChange?: (event: {
         dataItem: any;
@@ -173,7 +172,7 @@ export declare interface CellProps {
         value?: any;
     }) => void;
     /**
-     * A function for overriding the default rendering of the cell.
+     * Overrides the default cell rendering.
      */
     render?: (defaultRendering: React_2.ReactElement<HTMLTableCellElement> | null, props: CellProps) => React_2.ReactElement<HTMLTableCellElement> | null;
 }
@@ -303,69 +302,73 @@ export declare const closestTagName: (target: HTMLElement | null, tagName: 'TD'
 
 export declare interface ColumnBaseProps<C = CellProps> {
     /**
-     * The field to which the column is bound.
+     * Sets the data field that the column binds to.
      */
     field?: string;
     /**
-     * The title of the column.
+     * Sets the column header text.
      */
     title?: string;
     /**
-     * Allows the column headers to be clicked and the `sortChange` event emitted.
-     * You have to handle the `sortChange` event yourself and sort the data.
-     * Defaults to `true`.
+     * Enables header click to emit the `sortChange` event. Handle `sortChange` to sort the data.
+     *
+     * @default true
      */
     sortable?: boolean | ColumnSortSettings;
     /**
-     * The width of the column (in pixels).
+     * Sets the width of the column (in pixels).
      */
     width?: string | number;
     /**
-     * Defines if the header selection checkbox is checked.
+     * Indicates that the header selection checkbox is checked when `true`.
      */
     headerSelectionValue?: boolean;
     /**
-     * The format that is applied to the value before it is displayed.
+     * Applies a format to the value before display.
      * Takes the `{0:format}` form where `format` is a standard number format, a custom number format,
-     * a standard date format, or a custom date format. For more information on the supported date and number formats,
-     * refer to the [kendo-intl](https://github.com/telerik/kendo-intl/blob/develop/docs/index.md) documentation.
+     * a standard date format, or a custom date format. For more information on supported formats see the
+     * [kendo-intl](https://github.com/telerik/kendo-intl/blob/develop/docs/index.md) documentation.
      */
     format?: string;
     /**
-     * Sets the custom CSS classes to the column header cell.
+     * Sets custom CSS classes on the header cell.
      */
     headerClassName?: string;
     /**
-     * Sets the custom CSS classes to the column cells.
+     * Sets custom CSS classes on the column cells.
      */
     className?: string;
     /**
-     * Indicates whether the column is resizable.
+     * Enables column resizing when `true`.
+     *
+     * @default true
      */
     resizable?: boolean;
     /**
-     * Indicates whether the column is reorderable.
+     * Enables column reordering when `true`.
+     *
+     * @default true
      */
     reorderable?: boolean;
     /**
-     * The width of the column (in pixels) below which the user is not able to resize the column through the UI. Defaults to `10`.
+     * Sets the minimum resize width (in pixels).
+     *
+     * @default 10
      */
     minResizableWidth?: number;
     /**
-     * Determinates the position of the column.
-     * Columns with smaller `orderIndex` will appear before columns with bigger `orderIndex`.
-     * Defaults to `0`.
+     * Determines the column position. Smaller `orderIndex` values render first.
+     *
+     * @default 0
      */
     orderIndex?: number;
     /**
-     * The column identifier used to distinguish columns for example in multi column header scenarios with resize and keyboard navigation.
-     * Also used for unique key for rendering the component cells.
-     * If not set, the component will generate unique `id` automatically.
+     * Sets the column id for distinguishing columns (multi header, resize, or keyboard navigation scenarios).
+     * Also used as the unique key for rendering cells. If not set, a unique id is generated.
      */
     id?: string;
     /**
-     * Defines the component that will be rendered as a cell.
-     * If not set, a `Cell` will be rendered by default.
+     * Defines the component rendered as a cell. If not set, a `Cell` renders.
      */
     cell?: ComponentType<C>;
     /**
@@ -402,14 +405,14 @@ declare interface ColumnDraggableProps {
 }
 
 /**
- * The `ColumnMenuBooleanColumn` component. Use it for `boolean` type columns.
+ * Represents the ColumnMenuBooleanColumn component. Use it for `boolean` type columns.
  */
 export declare const ColumnMenuBooleanColumn: React_2.FunctionComponent<ColumnMenuProps>;
 
 export declare const ColumnMenuBooleanFilter: React_2.FunctionComponent<ColumnMenuFilterProps>;
 
 /**
- * The `ColumnMenuDateColumn` component. Use it for `Date` type columns.
+ * Represents the ColumnMenuDateColumn component. Use it for `Date` type columns.
  */
 export declare const ColumnMenuDateColumn: React_2.FunctionComponent<ColumnMenuProps>;
 
@@ -423,13 +426,18 @@ export declare const ColumnMenuFilterForm: React_2.FunctionComponent<ColumnMenuF
 export declare const ColumnMenuFilterLogic: React_2.FunctionComponent<DropDownListProps>;
 
 export declare interface ColumnMenuFilterProps {
+    /** The current filter descriptor for the column */
     filter: FilterDescriptor;
+    /** Event handler for filter changes */
     onFilterChange: (event: React_2.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_2.ComponentType<{
         value: any;
         onChange: any;
@@ -439,26 +447,52 @@ export declare interface ColumnMenuFilterProps {
 export declare const ColumnMenuForm: React_2.FunctionComponent<ColumnMenuFormProps>;
 
 export declare interface ColumnMenuFormProps {
+    /** Whether to show the form */
     show?: boolean;
+    /** Event handler for form submission */
     onSubmit?: React_2.FormEventHandler<HTMLFormElement>;
+    /** Event handler for form reset */
     onReset?: React_2.FormEventHandler<HTMLFormElement>;
+    /** Action buttons or custom action elements */
     actions?: React_2.ReactNode;
+    /** Form content and child elements */
     children?: React_2.ReactNode;
 }
 
 export declare const ColumnMenuItem: React_2.FunctionComponent<ColumnMenuItemProps>;
 
+/**
+ * Defines the props of the ColumnMenuItem component.
+ */
 export declare interface ColumnMenuItemProps {
+    /**
+     * Fires when the item is clicked.
+     */
     onClick?: (event: React_2.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;
 }
 
 /**
- * The `ColumnMenuNumericColumn` component. Use it for `number` type columns.
+ * Represents the ColumnMenuNumericColumn component. Use it for `number` type columns.
  */
 export declare const ColumnMenuNumericColumn: React_2.FunctionComponent<ColumnMenuProps>;
 
@@ -530,69 +564,73 @@ export declare class ColumnMenuOperators {
 }
 
 /**
- * The props of the ColumnMenu component.
+ * Defines the props of the ColumnMenu component.
  */
 export declare interface ColumnMenuProps {
     /**
-     * The descriptors by which the data is sorted.
+     * Sets the `SortDescriptor[]` applied to the data.
      */
     sort?: SortDescriptor[];
     /**
-     * Fires when the sorting of the ColumnMenu is changed.
+     * Fires when sorting changes. Receives the browser event, the new `SortDescriptor[]`, and the column `field`.
      */
     onSortChange?: (event: React_2.SyntheticEvent<any>, sort: SortDescriptor[], field: string) => void;
     /**
-     * The descriptors by which the data is filtered.
+     * Sets the `CompositeFilterDescriptor[]` applied to the data.
      */
     filter?: CompositeFilterDescriptor[];
     /**
-     * Fires when the ColumnMenu filter is changed.
+     * Fires when filtering changes. Receives the browser event, the new `CompositeFilterDescriptor[]`, and the column `field`.
      */
     onFilterChange?: (event: React_2.SyntheticEvent<any>, filter: CompositeFilterDescriptor[], field: string) => void;
     /**
-     * The field to which the ColumnMenu is bound.
+     * Sets the column `field` the menu operates on.
      */
     field?: string;
     /**
-     * If set to `true`, a button for sorting in `asc` direction will be rendered.
+     * Shows the ascending sort button when `true`.
+     *
+     * @default false
      */
     sortAsc?: boolean;
     /**
-     * If set to `true`, a button for sorting in `desc` direction will be rendered.
+     * Shows the descending sort button when `true`.
+     *
+     * @default false
      */
     sortDesc?: boolean;
     /**
-     * Defines the filtering UI and accepts an array with components.
+     * Provides the filtering UI components in render order. Supply up to three components: first filter, logic, second filter.
      */
     filterContent?: any[];
     /**
-     * Defines the initial expand state of the filters.
-     * Defaults to `false`.
+     * Sets the initial expand state of the filters.
+     *
+     * @default false
      */
     expandFilters?: boolean;
     /**
-     * A function that returns the initial filter descriptor base on the ColumnMenu field.
-     * Use it to customize the initial values of the filtering components.
+     * Returns the initial `CompositeFilterDescriptor` based on the current `field`. Use to customize starting filter values.
      */
     initialFilter?: (field: string) => CompositeFilterDescriptor;
     /**
-     * Fires when the ColumnMenu items are about to be rendered. Use it to add or remove menu items.
-     * The `defaultRendering` is an array with the sorting and filtering components.
-     * `props` contains the column's field and the closeMenu function which closes the ColumnMenu.
+     * 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_2.ReactElement<HTMLDivElement> | null)[], props: {
         field?: string;
         closeMenu: () => void;
     }) => React_2.ReactNode;
     /**
-     * Fires when the ColumnMenu is about to be rendered. Use it to override the default rendering of the ColumnMenu.
-     * The defaultRendering is an array with the button `React.ReactElement<HTMLSpanElement>` and popup `React.ReactElement<PopupProps>` components.
+     * 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_2.ReactElement<any>[]) => React_2.ReactNode;
 }
 
 /**
- * The `ColumnMenuTextColumn` component. Use it for `string` type columns.
+ * Represents the ColumnMenuTextColumn component. Use it for `string` type columns.
  */
 export declare const ColumnMenuTextColumn: React_2.FunctionComponent<ColumnMenuProps>;
 
@@ -1795,19 +1833,33 @@ export declare const HeaderTdElement: {
 };
 
 export declare interface HeaderTdElementProps extends React_2.TdHTMLAttributes<HTMLTableCellElement> {
+    /** ARIA sort state indicating column sorting direction */
     ariaSort?: 'none' | 'ascending' | 'descending';
+    /** ARIA label for accessibility */
     ariaLabel?: string;
+    /** ARIA column index for screen readers */
     ariaColumnIndex?: number;
+    /** ARIA selected state for the header cell */
     ariaSelected?: boolean;
+    /** ARIA description for additional context */
     ariaDescription?: string;
+    /** Number of columns the cell spans */
     colSpan?: number;
+    /** Number of rows the cell spans */
     rowSpan?: number;
+    /** ARIA role for the element */
     role?: string;
+    /** Unique identifier for the column */
     columnId: string;
+    /** CSS class names for styling */
     className?: string;
+    /** Inline styles for the element */
     style?: any;
+    /** Child elements to render inside the header cell */
     children?: any;
+    /** Keyboard event handler */
     onKeyDown?: any;
+    /** Whether the cell supports keyboard navigation */
     navigatable?: boolean;
 }
 
@@ -1817,19 +1869,33 @@ export declare const HeaderThElement: {
 };
 
 export declare interface HeaderThElementProps extends React_2.ThHTMLAttributes<HTMLTableCellElement> {
+    /** ARIA sort state indicating column sorting direction */
     ariaSort?: 'none' | 'ascending' | 'descending';
+    /** ARIA label for accessibility */
     ariaLabel?: string;
+    /** ARIA column index for screen readers */
     ariaColumnIndex?: number;
+    /** ARIA selected state for the header cell */
     ariaSelected?: boolean;
+    /** ARIA description for additional context */
     ariaDescription?: string;
+    /** Number of columns the cell spans */
     colSpan?: number;
+    /** Number of rows the cell spans */
     rowSpan?: number;
+    /** ARIA role for the element */
     role?: string;
+    /** Unique identifier for the column */
     columnId: string;
+    /** CSS class names for styling */
     className?: string;
+    /** Inline styles for the element */
     style?: any;
+    /** Child elements to render inside the header cell */
     children?: any;
+    /** Keyboard event handler */
     onKeyDown?: any;
+    /** Whether the cell supports keyboard navigation */
     navigatable?: boolean;
 }
 

package/package-metadata.js

@@ -5,4 +5,4 @@
  * Licensed under commercial license. See LICENSE.md in the package root for more information
  *-------------------------------------------------------------------------------------------
  */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=Object.freeze({name:"@progress/kendo-react-data-tools",productName:"KendoReact",productCode:"KENDOUIREACT",productCodes:["KENDOUIREACT"],publishDate: 1756967076,version:"12.0.2-develop.1",licensingDocsUrl:"https://www.telerik.com/kendo-react-ui/components/my-license/"});exports.packageMetadata=e;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=Object.freeze({name:"@progress/kendo-react-data-tools",productName:"KendoReact",productCode:"KENDOUIREACT",productCodes:["KENDOUIREACT"],publishDate: 1757072699,version:"12.0.2-develop.2",licensingDocsUrl:"https://www.telerik.com/kendo-react-ui/components/my-license/"});exports.packageMetadata=e;

package/package-metadata.mjs

@@ -10,8 +10,8 @@ const e = Object.freeze({
   productName: "KendoReact",
   productCode: "KENDOUIREACT",
   productCodes: ["KENDOUIREACT"],
-  publishDate: 1756967076,
-  version: "12.0.2-develop.1",
+  publishDate: 1757072699,
+  version: "12.0.2-develop.2",
   licensingDocsUrl: "https://www.telerik.com/kendo-react-ui/components/my-license/"
 });
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-react-data-tools",
-  "version": "12.0.2-develop.1",
+  "version": "12.0.2-develop.2",
   "description": "Includes React Pager & React Filter component, an intuitive interface to create complex filter descriptions. KendoReact Data Tools package",
   "author": "Progress",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -28,14 +28,14 @@
     "@progress/kendo-data-query": "^1.0.0",
     "@progress/kendo-drawing": "^1.21.2",
     "@progress/kendo-licensing": "^1.7.0",
-    "@progress/kendo-react-animation": "12.0.2-develop.1",
-    "@progress/kendo-react-buttons": "12.0.2-develop.1",
-    "@progress/kendo-react-common": "12.0.2-develop.1",
-    "@progress/kendo-react-dateinputs": "12.0.2-develop.1",
-    "@progress/kendo-react-dropdowns": "12.0.2-develop.1",
-    "@progress/kendo-react-inputs": "12.0.2-develop.1",
-    "@progress/kendo-react-intl": "12.0.2-develop.1",
-    "@progress/kendo-react-popup": "12.0.2-develop.1",
+    "@progress/kendo-react-animation": "12.0.2-develop.2",
+    "@progress/kendo-react-buttons": "12.0.2-develop.2",
+    "@progress/kendo-react-common": "12.0.2-develop.2",
+    "@progress/kendo-react-dateinputs": "12.0.2-develop.2",
+    "@progress/kendo-react-dropdowns": "12.0.2-develop.2",
+    "@progress/kendo-react-inputs": "12.0.2-develop.2",
+    "@progress/kendo-react-intl": "12.0.2-develop.2",
+    "@progress/kendo-react-popup": "12.0.2-develop.2",
     "@progress/kendo-svg-icons": "^4.0.0",
     "react": "^16.8.2 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc",
     "react-dom": "^16.8.2 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc"
@@ -65,7 +65,7 @@
     "package": {
       "productName": "KendoReact",
       "productCode": "KENDOUIREACT",
-      "publishDate": 1756967076,
+      "publishDate": 1757072699,
       "licensingDocsUrl": "https://www.telerik.com/kendo-react-ui/components/my-license/"
     }
   },