@progress/kendo-react-grid 13.3.0 → 13.4.0-develop.2

package/utils/handleAIResponse.d.ts

@@ -0,0 +1,221 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { AxiosResponse } from 'axios';
+import { CompositeFilterDescriptor, GroupDescriptor, SortDescriptor } from '@progress/kendo-data-query';
+import { GridColumnState, GridHandle } from '../interfaces/index.js';
+/**
+ * Represents the grid state that can be controlled externally.
+ * This interface contains all the stateful properties that can be modified through AI commands.
+ *
+ * @example
+ * ```tsx
+ * const [gridState, setGridState] = useState<GridAIState>({
+ *   sort: [],
+ *   filter: undefined,
+ *   group: [],
+ *   columnsState: initialColumns,
+ *   skip: 0,
+ *   take: 20
+ * });
+ * ```
+ */
+export interface GridAIState {
+    /**
+     * The current sort descriptors applied to the grid.
+     * Array of sort objects defining field and direction.
+     */
+    sort?: SortDescriptor[];
+    /**
+     * The current filter descriptor applied to the grid.
+     * Composite filter defining logic and filter array.
+     */
+    filter?: CompositeFilterDescriptor;
+    /**
+     * The current group descriptors applied to the grid.
+     * Array of group objects defining field and aggregates.
+     */
+    group?: GroupDescriptor[];
+    /**
+     * The current column state including visibility, width, order, and lock status.
+     * Array of column state objects.
+     */
+    columnsState?: GridColumnState[];
+    /**
+     * The number of items to skip for pagination.
+     * Zero-based index for the first item to display.
+     */
+    skip?: number;
+    /**
+     * The number of items to take (page size) for pagination.
+     * Number of items to display per page.
+     */
+    take?: number;
+    /**
+     * The highlight descriptor for highlighting cells/rows in the grid.
+     * Object with dataItemKey as keys, values can be boolean (whole row) or number array (specific cells).
+     *
+     * @example
+     * ```tsx
+     * highlight: {
+     *   '1': true,           // Highlight entire row with dataItemKey = 1
+     *   '2': [0, 1, 2]       // Highlight cells at column indices 0, 1, 2 in row with dataItemKey = 2
+     * }
+     * ```
+     */
+    highlight?: any;
+    /**
+     * The select descriptor for selecting cells/rows in the grid.
+     * Object with dataItemKey as keys, values can be boolean (whole row) or number array (specific cells).
+     *
+     * @example
+     * ```tsx
+     * select: {
+     *   '1': true,           // Select entire row with dataItemKey = 1
+     *   '2': [0, 1]          // Select cells at column indices 0 and 1 in row with dataItemKey = 2
+     * }
+     * ```
+     */
+    select?: any;
+}
+/**
+ * Represents the result of processing an AI response.
+ * Contains the updated grid state and any messages to display.
+ */
+export interface GridAIResponseResult {
+    /**
+     * The updated grid state after processing AI commands.
+     * Spread this into your Grid component props.
+     */
+    state: GridAIState;
+    /**
+     * Array of user-friendly messages describing what changes were made.
+     * Can be displayed to users as feedback.
+     */
+    messages: string[];
+    /**
+     * Indicates whether the AI triggered a PDF export.
+     * Handle this separately as it's an action, not state.
+     */
+    shouldExportPdf: boolean;
+}
+/**
+ * Processes an AI response and returns the updated grid state.
+ * This is a pure function that takes the current state and AI response,
+ * and returns a new state object with all the changes applied.
+ *
+ * @param response - The axios response from the AI service containing commands
+ * @param currentState - The current grid state
+ * @param gridRef - Reference to grid methods (getTotal, getLeafDataItems, exportAsPdf)
+ * @returns Object containing the new state, messages, and export flag
+ *
+ * @example
+ * ```tsx
+ * const App = () => {
+ *   const [gridState, setGridState] = useState<GridAIState>({
+ *     sort: [],
+ *     filter: undefined,
+ *     group: [],
+ *     columnsState: initialColumns,
+ *     skip: 0,
+ *     take: 20
+ *   });
+ *   const gridRef = useRef<GridHandle>(null);
+ *
+ *   const handleAIRequest = async (prompt: string) => {
+ *     const response = await axios.post('/api/ai/grid', { prompt, columns: gridState.columnsState });
+ *     const result = handleAIResponse(response, gridState, gridRef.current);
+ *
+ *     // Update state with AI changes
+ *     setGridState(result.state);
+ *
+ *     // Handle PDF export if requested
+ *     if (result.shouldExportPdf && gridRef.current) {
+ *       gridRef.current.exportAsPdf();
+ *     }
+ *
+ *     // Show messages to user
+ *     console.log(result.messages);
+ *   };
+ *
+ *   return (
+ *     <Grid
+ *       ref={gridRef}
+ *       data={data}
+ *       {...gridState}
+ *       onSortChange={(e) => setGridState(prev => ({ ...prev, sort: e.sort }))}
+ *       onFilterChange={(e) => setGridState(prev => ({ ...prev, filter: e.filter }))}
+ *       onGroupChange={(e) => setGridState(prev => ({ ...prev, group: e.group }))}
+ *       onColumnsStateChange={(e) => setGridState(prev => ({ ...prev, columnsState: e.columnsState }))}
+ *       onPageChange={(e) => setGridState(prev => ({ ...prev, skip: e.page.skip, take: e.page.take }))}
+ *     />
+ *   );
+ * };
+ * ```
+ */
+export declare function handleAIResponse(response: AxiosResponse<any>, currentState: GridAIState, gridRef: Pick<GridHandle, 'getLeafDataItems' | 'getTotal' | 'exportAsPdf' | 'props'> | null): GridAIResponseResult;
+/**
+ * Handles sort command by merging new sort with existing sorts.
+ *
+ * @hidden
+ */
+declare const handleSortCommand: (commandSort: SortDescriptor | SortDescriptor[], currentSort?: SortDescriptor[]) => SortDescriptor[];
+/**
+ * Handles filter command by combining new filter with existing filters.
+ *
+ * @hidden
+ */
+declare const handleFilterCommand: (commandFilter: CompositeFilterDescriptor, currentFilter?: CompositeFilterDescriptor) => CompositeFilterDescriptor | undefined;
+/**
+ * Handles group command by merging new group with existing groups.
+ *
+ * @hidden
+ */
+declare const handleGroupCommand: (commandGroup: GroupDescriptor | GroupDescriptor[], currentGroup?: GroupDescriptor[]) => GroupDescriptor[];
+/**
+ * Handles column visibility change.
+ *
+ * @hidden
+ */
+declare const handleColumnVisibility: (columnId: string, hidden: boolean, columnsState: GridColumnState[]) => GridColumnState[];
+/**
+ * Handles column resize.
+ *
+ * @hidden
+ */
+declare const handleColumnResize: (columnId: string, newWidth: string, columnsState: GridColumnState[]) => GridColumnState[];
+/**
+ * Handles column reorder.
+ *
+ * @hidden
+ */
+declare const handleColumnReorder: (columnId: string, position: number, columnsState: GridColumnState[]) => GridColumnState[];
+/**
+ * Handles column lock/unlock.
+ *
+ * @hidden
+ */
+declare const handleColumnLock: (columnId: string, locked: boolean, columnsState: GridColumnState[]) => GridColumnState[];
+/**
+ * Handles page change by calculating new skip/take values.
+ *
+ * @hidden
+ */
+declare const handlePageChange: (gridRef: Pick<GridHandle, 'getLeafDataItems' | 'getTotal' | 'exportAsPdf' | 'props'>, targetPage: number, currentSkip?: number, currentTake?: number) => {
+    skip: number;
+    take: number;
+};
+/**
+ * Handles page size change by recalculating skip/take values.
+ *
+ * @hidden
+ */
+declare const handlePageSizeChange: (pageSize: number, currentSkip?: number, currentTake?: number) => {
+    skip: number;
+    take: number;
+};
+export { handleSortCommand, handleFilterCommand, handleGroupCommand, handleColumnVisibility, handleColumnResize, handleColumnReorder, handleColumnLock, handlePageChange, handlePageSizeChange };

package/utils/index.d.ts

@@ -0,0 +1,185 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { GridProps } from '../interfaces/GridProps.js';
+import { ExtendedColumnProps } from '../GridColumn.js';
+import { DataResult, GroupDescriptor, SortDescriptor } from '@progress/kendo-data-query';
+import { GridRowType } from '../interfaces/GridRowType.js';
+import { GridColumnProps } from '../interfaces/GridColumnProps.js';
+import { DetailExpandDescriptor, GroupExpandDescriptor, GroupState } from '@progress/kendo-react-data-tools';
+import { GridCellsSettings } from '../interfaces/GridCellsSettings.js';
+import { GridContextMenuItemNames } from '../contextMenu/enums.js';
+import { GridDetailExpandableSettings } from '../interfaces/GridDetailExpandableSettings.js';
+import { GridCellProps } from '../interfaces/GridCellProps.js';
+import { GridRowSpannableSettings } from '../interfaces/GridRowSpannableSettings.js';
+import { GridRowReorderSettings } from '../interfaces/GridRowReorderSettings.js';
+import { GridColumnState } from '../interfaces/GridColumnState.js';
+import * as React from 'react';
+/**
+ * @hidden
+ */
+export declare function getNestedValue(fieldName: string | undefined, dataItem: any): any;
+/**
+ * @hidden
+ */
+export interface DataItemWrapper {
+    dataItem: any;
+    rowType: GridRowType;
+    level: number;
+    expanded: boolean;
+    dataIndex: number;
+    group?: GroupState;
+}
+/**
+ * @hidden
+ */
+export declare function flatData(output: Array<DataItemWrapper>, input: Array<any>, footer: 'always' | 'visible' | 'none', dataIndex: {
+    index: number;
+}, groupDefined: boolean, expand?: DetailExpandDescriptor, groupExpand?: GroupExpandDescriptor[], defaultGroupExpand?: boolean, dataItemKey?: string, level?: number, parentGroup?: GroupState | undefined): number;
+/**
+ * @hidden
+ */
+export declare function syncLockedColumns(columns: Array<{
+    locked?: boolean;
+    index: number;
+}>, columnsState: GridColumnState[]): void;
+/**
+ * @hidden
+ */
+export declare const getColSpan: (column: GridColumnProps, dataItem: any) => number;
+/**
+ * @hidden
+ */
+export declare function checkPropCompatibility(props: GridProps): void;
+/**
+ * @hidden
+ */
+export declare function mapColumns(columns: Array<{
+    parentIndex: number;
+    rowSpan: number;
+    depth: number;
+    kFirst?: boolean;
+    children: any[];
+    headerColSpan: number;
+    width?: string | number;
+    locked?: boolean;
+    index: number;
+    left: number;
+    right: number;
+    rightBorder: boolean;
+    ariaColumnIndex: number;
+}>, columnsState: GridColumnState[], changedColumnLength?: boolean): number[][];
+/**
+ * @hidden
+ */
+export declare function readColumns(elements: (React.ReactNode | React.ReactElement | GridColumnProps)[], columnsState: GridColumnState[], idInfo: {
+    prevId: number;
+    idPrefix: string;
+}, depth?: number, parentHidden?: boolean): ExtendedColumnProps[];
+/**
+ * @hidden
+ */
+export declare const getDataAsArray: (data: any[] | DataResult | null | undefined) => any[];
+/**
+ * @hidden
+ */
+export declare function autoGenerateColumns(data: any[] | DataResult | null | undefined, group: GroupDescriptor[] | undefined, expandable: GridDetailExpandableSettings, idInfo: {
+    prevId: number;
+    idPrefix: string;
+}): ExtendedColumnProps[];
+/**
+ * @hidden
+ */
+export declare const footerColumns: (columns: ExtendedColumnProps[]) => ExtendedColumnProps[];
+/**
+ * @hidden
+ */
+export declare const getColumnWidth: (column: ExtendedColumnProps) => string | undefined;
+/**
+ * @hidden
+ */
+export declare const isSorted: (field: string | undefined, sort?: SortDescriptor[]) => boolean | undefined;
+/**
+ * @hidden
+ */
+export declare const sanitizeColumns: (columns: ExtendedColumnProps[]) => GridColumnProps[];
+/**
+ * @hidden
+ */
+export declare const clientColumn: (column: ExtendedColumnProps) => ExtendedColumnProps;
+/**
+ * @hidden
+ */
+export declare const getColumnState: (column: ExtendedColumnProps) => GridColumnState;
+/**
+ * @hidden
+ */
+export declare const getColumnsState: (columns: ExtendedColumnProps[]) => GridColumnState[];
+/**
+ * @hidden
+ */
+export declare const getFlatColumnsState: (state: GridColumnState[]) => GridColumnState[];
+/**
+ * @hidden
+ */
+export declare const firefox: boolean;
+/**
+ * @hidden
+ */
+export declare const firefoxMaxHeight = 17895697;
+/**
+ * @hidden
+ */
+export declare const getDefaultHeadContextMenuItems: (options: {
+    pdf?: boolean;
+    sortable?: boolean;
+    selectable?: boolean;
+    editable?: boolean;
+    reorderable?: boolean;
+    clipboard?: boolean;
+}) => GridContextMenuItemNames[];
+/**
+ * @hidden
+ */
+export declare const getDefaultBodyContextMenuItems: (options: {
+    pdf?: boolean;
+    sortable?: boolean;
+    selectable?: boolean;
+    editable?: boolean;
+    rowReorderable?: boolean;
+    clipboard?: boolean;
+}) => GridContextMenuItemNames[];
+/**
+ * @hidden
+ */
+export declare const resolveCells: (gridCells?: GridCellsSettings, columnCells?: GridCellsSettings) => GridCellsSettings | undefined;
+/**
+ * @hidden
+ */
+export declare const isRowReorderEnabled: (rowReorderable?: GridRowReorderSettings | boolean) => boolean;
+/**
+ * @hidden
+ */
+export declare const isClient: () => boolean;
+/**
+ * @hidden
+ */
+export declare const isClientReference: (component: any) => boolean;
+/**
+ * @hidden
+ */
+export declare const getClientCellProps: (props: GridCellProps) => GridCellProps;
+/**
+ * @hidden
+ */
+export declare const getRowSpanOptions: (rowSpannable?: boolean | GridRowSpannableSettings) => Required<GridRowSpannableSettings>;
+/** @hidden */
+export declare const getReactElement: (children: React.ReactElement<any> | undefined) => React.ReactElement<any>;
+/** @hidden */
+export declare const cloneReactElement: (children: React.ReactElement<any>, props: any) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+/** @hidden */
+export declare const calcRowHeight: (tableBody: HTMLTableSectionElement | null) => number;

package/utils/index.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 G=require("react"),v=require("../GridColumn.js"),w=require("@progress/kendo-data-query"),y=require("@progress/kendo-react-data-tools"),O=require("./_serverModule.js"),T=require("./_clientModule.js"),l=require("../contextMenu/enums.js"),H=require("@progress/kendo-react-common");function j(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const a in e)if(a!=="default"){const r=Object.getOwnPropertyDescriptor(e,a);Object.defineProperty(t,a,r.get?r:{enumerable:!0,get:()=>e[a]})}}return t.default=e,Object.freeze(t)}const M=j(G);function q(e,t){const a=(e!=null?e:"").split(".");let r=t;return a.forEach(n=>{r=r?r[n]:void 0}),r}function N(e,t,a,r,n,d,h,i,s,f=0,o){var c;let x=f;for(let g=0;g<t.length;g++){let C;if(!n||t[g].value===void 0||t[g].items===void 0){e[e.length]={dataIndex:r.index,dataItem:t[g],rowType:"data",level:f,group:o,expanded:(c=s?!!(d!=null&&d[w.getter(s)(t[g])]):!1)!=null?c:!1},r.index++;continue}else{let S;o!=null&&o.parents?S=[{field:o.field,value:o.value},...o.parents]:o?S=[o]:S=[],C={field:t[g].field,value:t[g].value,parents:S}}x=Math.max(x,f+1);let I=!1;const b=y.findGroupExpand(h||[],C);b?I=b.expanded!==!1:I=i!==!1,e[e.length]={dataIndex:-1,dataItem:t[g],level:f,group:C,rowType:"groupHeader",expanded:I},I&&(C.expanded=I,x=Math.max(N(e,t[g].items,a,r,n,d,h,i,s,f+1,C),x)),(a==="always"||I&&a==="visible")&&(e[e.length]={dataIndex:-1,dataItem:t[g],rowType:"groupFooter",level:f,expanded:I})}return x}function R(e,t){for(let a=0;a<e.length;a++){const r=e[a];if(!r.locked){const n=t[r.index];n&&(r.locked=n.locked)}}}const u=(e,t)=>typeof e.colSpan=="function"?e.colSpan({dataItem:t,column:e}):e.colSpan||1;function B(e,t,a){const r=[[]];let n=0;for(let i=e.length-1;i>=0;i--)n=Math.max(n,e[i].depth),e[i].headerColSpan=e[i].headerColSpan||1,e[i].children.length>0&&(e[i].headerColSpan=e[i].children.reduce((s,f)=>f.hidden?s:s+f.headerColSpan,0));const d=[];let h=1;return e.forEach((i,s)=>{r[i.depth]=r[i.depth]||[];let f=!1;r[i.depth].length===0&&(h<=1?h=1+(i.children.length>0?0:n-i.depth):(h--,f=!0)),i.rowSpan=1+(i.children.length>0?0:n-i.depth),i.kFirst=f,i.index=r[i.depth].length,r[i.depth].push(s),i.ariaColumnIndex=d[i.depth]?d[i.depth]+1:1;for(let o=i.depth;o<i.depth+i.rowSpan;o++)d[o]=(d[o]||0)+i.headerColSpan}),R(e,t),y.updateLeft(r,e,a),y.updateRight(r,e,a),r}function p(e,t,a,r=0,n=!1){const d=[];if(!e)return[];e&&e.length===void 0&&(e=[e]),e.forEach((i,s)=>{i=i.props?i.props:i;const f=i.id?i.id:y.tableKeyboardNavigationTools.generateNavigatableId(`${a.prevId++}`,a.idPrefix,"column"),o=H.canUseDOM&&i.media&&window.matchMedia?!window.matchMedia(i.media).matches:!1,x=n||o||i.hidden,c=t==null?void 0:t.find(C=>C.id===f),g=p(i.children,(c==null?void 0:c.children)||[],a,r+1,x);d.push(Object.assign({depth:r},v.gridDefaultProps,g.length?{cell:()=>null,filterCell:()=>null}:{},i,{id:f,declarationIndex:d.length,children:g,headerColSpan:0,rowSpan:0,columnType:i.columnType||"data",colSpan:i.colSpan||1,isAccessible:!0,hidden:x,left:null,right:null,rowSpannable:i.rowSpannable},c?{width:c.width,orderIndex:c.orderIndex}:{}))});const h=(i,s)=>i.orderIndex===s.orderIndex?i.declarationIndex-s.declarationIndex:(i.orderIndex||0)-(s.orderIndex||0);if(d.sort(h),r===0){const i=[],s=(f,o)=>f.forEach(x=>{x.parentIndex=o,s(x.children,i.push(x)-1)});return s(d,-1),i}return d}const D=e=>Array.isArray(e)?e:e?e.data:[];function z(e,t,a,r){const n=D(e),d=[];if(n.length>0){let h=n[0];if(t)for(let s=0;s<t.length;s++)h=h.items&&h.items[0];Object.getOwnPropertyNames(h).forEach(s=>{s!==a.column&&d.push(Object.assign({id:y.tableKeyboardNavigationTools.generateNavigatableId(`${r.prevId++}`,r.idPrefix,"column"),declarationIndex:-1,parentIndex:-1,depth:0,colSpan:0,headerColSpan:0,rowSpan:0,index:0,columnType:"data",left:0,right:0,rightBorder:!1,children:[],ariaColumnIndex:0,isAccessible:!0},v.gridDefaultProps,{field:s}))})}return d}const _=(e,t)=>{var r;let a=e[t.parentIndex];for(;a;){if((r=a.cells)!=null&&r.footerCell)return!0;a=e[a.parentIndex]}return!1},L=e=>e.filter(t=>{var a;return _(e,t)?!1:!!((a=t.cells)!=null&&a.footerCell)||!(t.children&&t.children.length>0)}),$=e=>{let t=e.width;return typeof(e==null?void 0:e.width)=="number"&&(e!=null&&e.minResizableWidth)&&(e==null?void 0:e.width)<(e==null?void 0:e.minResizableWidth)&&(t=e==null?void 0:e.minResizableWidth),typeof(e==null?void 0:e.width)=="number"&&(e!=null&&e.minWidth)&&(e==null?void 0:e.width)<(e==null?void 0:e.minWidth)?t=e==null?void 0:e.minWidth:typeof(e==null?void 0:e.width)=="number"&&(e!=null&&e.maxWidth)&&(e==null?void 0:e.width)>(e==null?void 0:e.maxWidth)&&(t=e==null?void 0:e.maxWidth),t!==void 0?Math.floor(parseFloat(t.toString()))+"px":void 0},V=(e,t)=>t&&t.filter(a=>a.field===e).length>0,E=e=>(e.sort((t,a)=>t.declarationIndex-a.declarationIndex),e.map(t=>{const{declarationIndex:a,parentIndex:r,depth:n,headerColSpan:d,rowSpan:h,index:i,kFirst:s,children:f,...o}=t;return f.length?{children:E(f),...o}:o})),W=e=>{const{cells:t,rowSpannable:a,defaultCell:r,...n}=e;return e.children.length?{...n,children:e.children.map(W)}:n},F=e=>({id:e.id,field:e.field,title:e.title,width:e.width,orderIndex:e.orderIndex,hidden:!1,minWidth:e.minWidth,maxWidth:e.maxWidth,children:e.children?k(e.children):null}),k=e=>e.map(F),P=e=>{const t=[],a=r=>r==null?void 0:r.forEach(n=>{t.push(n),a(n.children)});return a(e),t},K=typeof window!="undefined"&&/Firefox/.test(window.navigator.userAgent),Q=17895697,U=e=>{let t=[];return e.sortable&&(t=t.concat([l.GridContextMenuItemNames.sortAsc,l.GridContextMenuItemNames.sortDesc])),e.pdf&&(t.length&&(t=t.concat([l.GridContextMenuItemNames.separator])),t=t.concat([l.GridContextMenuItemNames.exportPDF])),t},J=e=>{let t=[];return e.clipboard&&(t=t.concat([l.GridContextMenuItemNames.copySelection,l.GridContextMenuItemNames.copySelectionNoHeaders,l.GridContextMenuItemNames.paste])),e.editable&&(t.length&&(t=t.concat([l.GridContextMenuItemNames.separator])),t=t.concat([l.GridContextMenuItemNames.create,l.GridContextMenuItemNames.edit,l.GridContextMenuItemNames.delete])),e.selectable&&(t.length&&(t=t.concat([l.GridContextMenuItemNames.separator])),t=t.concat([l.GridContextMenuItemNames.select])),e.rowReorderable&&(t.length&&(t=t.concat([l.GridContextMenuItemNames.separator])),t=t.concat([l.GridContextMenuItemNames.reorderRow])),e.pdf&&(t.length&&(t=t.concat([l.GridContextMenuItemNames.separator])),t=t.concat([l.GridContextMenuItemNames.exportPDF])),t},X=(e,t)=>{if(!(!e&&!t))return t?e?{...e,...t,select:{...e.select||{},...t.select||{}},hierarchy:{...e.hierarchy||{},...t.hierarchy||{}},group:{...e.group||{},...t.group||{}},edit:{...e.edit||{},...t.edit||{}}}:t:e},Y=e=>{var a;return typeof e=="object"?(a=e.enabled)!=null?a:!0:e!=null?e:!1},Z=()=>O.ServerFragment===T.ClientFragment,m=e=>!!(e&&e.$$typeof===Symbol.for("react.client.reference")),ee=e=>({id:e.id,ariaColumnIndex:e.ariaColumnIndex,isSelected:e.isSelected,isHighlighted:e.isHighlighted,isInEdit:e.isInEdit,isSorted:e.isSorted,isAlt:e.isAlt,expanded:e.expanded,className:e.className,style:e.style,field:e.field,dataItem:e.dataItem,format:e.format,colSpan:e.colSpan,dataIndex:e.dataIndex,columnIndex:e.columnIndex,columnsCount:e.columnsCount,rowType:e.rowType,level:e.level,editor:e.editor,locked:e.locked,isRtl:e.isRtl,rowDataIndex:e.rowDataIndex,columnPosition:e.columnPosition,group:e.group}),te=e=>{var r,n;const t=typeof e=="object"?(r=e.enabled)!=null?r:!0:e!=null?e:!1,a=typeof e=="object"?(n=e.valueGetter)!=null?n:(d,h)=>w.getter(h)(d):(d,h)=>w.getter(h)(d);return{enabled:t,valueGetter:a}},A=e=>{var t;return M.isValidElement(e)?e:(t=M.Children.toArray(e))==null?void 0:t[0]},ie=(e,t)=>{const a=A(e);return a?M.cloneElement(a,t):null},ae=e=>{let t=0;if(e){const a=e.insertRow(0),r=a.insertCell(0);r.textContent="&nbsp;",t=a.getBoundingClientRect().height,e.deleteRow(0)}return t};exports.autoGenerateColumns=z;exports.calcRowHeight=ae;exports.clientColumn=W;exports.cloneReactElement=ie;exports.firefox=K;exports.firefoxMaxHeight=Q;exports.flatData=N;exports.footerColumns=L;exports.getClientCellProps=ee;exports.getColSpan=u;exports.getColumnState=F;exports.getColumnWidth=$;exports.getColumnsState=k;exports.getDataAsArray=D;exports.getDefaultBodyContextMenuItems=J;exports.getDefaultHeadContextMenuItems=U;exports.getFlatColumnsState=P;exports.getNestedValue=q;exports.getReactElement=A;exports.getRowSpanOptions=te;exports.isClient=Z;exports.isClientReference=m;exports.isRowReorderEnabled=Y;exports.isSorted=V;exports.mapColumns=B;exports.readColumns=p;exports.resolveCells=X;exports.sanitizeColumns=E;exports.syncLockedColumns=R;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const G=require("react"),v=require("../GridColumn.js"),w=require("@progress/kendo-data-query"),y=require("@progress/kendo-react-data-tools"),O=require("./_serverModule.js"),T=require("./_clientModule.js"),l=require("../contextMenu/enums.js"),H=require("@progress/kendo-react-common");function j(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const a in e)if(a!=="default"){const r=Object.getOwnPropertyDescriptor(e,a);Object.defineProperty(t,a,r.get?r:{enumerable:!0,get:()=>e[a]})}}return t.default=e,Object.freeze(t)}const M=j(G);function q(e,t){const a=(e!=null?e:"").split(".");let r=t;return a.forEach(n=>{r=r?r[n]:void 0}),r}function N(e,t,a,r,n,d,h,i,s,f=0,o){var c;let x=f;for(let g=0;g<t.length;g++){let C;if(!n||t[g].value===void 0||t[g].items===void 0){e[e.length]={dataIndex:r.index,dataItem:t[g],rowType:"data",level:f,group:o,expanded:(c=s?!!(d!=null&&d[w.getter(s)(t[g])]):!1)!=null?c:!1},r.index++;continue}else{let S;o!=null&&o.parents?S=[{field:o.field,value:o.value},...o.parents]:o?S=[o]:S=[],C={field:t[g].field,value:t[g].value,parents:S}}x=Math.max(x,f+1);let I=!1;const b=y.findGroupExpand(h||[],C);b?I=b.expanded!==!1:I=i!==!1,e[e.length]={dataIndex:-1,dataItem:t[g],level:f,group:C,rowType:"groupHeader",expanded:I},I&&(C.expanded=I,x=Math.max(N(e,t[g].items,a,r,n,d,h,i,s,f+1,C),x)),(a==="always"||I&&a==="visible")&&(e[e.length]={dataIndex:-1,dataItem:t[g],rowType:"groupFooter",level:f,expanded:I})}return x}function R(e,t){for(let a=0;a<e.length;a++){const r=e[a];if(!r.locked){const n=t[r.index];n&&(r.locked=n.locked)}}}const u=(e,t)=>typeof e.colSpan=="function"?e.colSpan({dataItem:t,column:e}):e.colSpan||1;function B(e,t,a){const r=[[]];let n=0;for(let i=e.length-1;i>=0;i--)n=Math.max(n,e[i].depth),e[i].headerColSpan=e[i].headerColSpan||1,e[i].children.length>0&&(e[i].headerColSpan=e[i].children.reduce((s,f)=>f.hidden?s:s+f.headerColSpan,0));const d=[];let h=1;return e.forEach((i,s)=>{r[i.depth]=r[i.depth]||[];let f=!1;r[i.depth].length===0&&(h<=1?h=1+(i.children.length>0?0:n-i.depth):(h--,f=!0)),i.rowSpan=1+(i.children.length>0?0:n-i.depth),i.kFirst=f,i.index=r[i.depth].length,r[i.depth].push(s),i.ariaColumnIndex=d[i.depth]?d[i.depth]+1:1;for(let o=i.depth;o<i.depth+i.rowSpan;o++)d[o]=(d[o]||0)+i.headerColSpan}),R(e,t),y.updateLeft(r,e,a),y.updateRight(r,e,a),r}function p(e,t,a,r=0,n=!1){const d=[];if(!e)return[];e&&e.length===void 0&&(e=[e]),e.forEach((i,s)=>{i=i.props?i.props:i;const f=i.id?i.id:y.tableKeyboardNavigationTools.generateNavigatableId(`${a.prevId++}`,a.idPrefix,"column"),o=H.canUseDOM&&i.media&&window.matchMedia?!window.matchMedia(i.media).matches:!1,x=n||o||i.hidden,c=t==null?void 0:t.find(C=>C.id===f),g=p(i.children,(c==null?void 0:c.children)||[],a,r+1,x);d.push(Object.assign({depth:r},v.gridDefaultProps,g.length?{cell:()=>null,filterCell:()=>null}:{},i,{id:f,declarationIndex:d.length,children:g,headerColSpan:0,rowSpan:0,columnType:i.columnType||"data",colSpan:i.colSpan||1,isAccessible:!0,hidden:x,left:null,right:null,rowSpannable:i.rowSpannable},c?{width:c.width,orderIndex:c.orderIndex}:{}))});const h=(i,s)=>i.orderIndex===s.orderIndex?i.declarationIndex-s.declarationIndex:(i.orderIndex||0)-(s.orderIndex||0);if(d.sort(h),r===0){const i=[],s=(f,o)=>f.forEach(x=>{x.parentIndex=o,s(x.children,i.push(x)-1)});return s(d,-1),i}return d}const D=e=>Array.isArray(e)?e:e?e.data:[];function z(e,t,a,r){const n=D(e),d=[];if(n.length>0){let h=n[0];if(t)for(let s=0;s<t.length;s++)h=h.items&&h.items[0];Object.getOwnPropertyNames(h).forEach(s=>{s!==a.column&&d.push(Object.assign({id:y.tableKeyboardNavigationTools.generateNavigatableId(`${r.prevId++}`,r.idPrefix,"column"),declarationIndex:-1,parentIndex:-1,depth:0,colSpan:0,headerColSpan:0,rowSpan:0,index:0,columnType:"data",left:0,right:0,rightBorder:!1,children:[],ariaColumnIndex:0,isAccessible:!0},v.gridDefaultProps,{field:s}))})}return d}const _=(e,t)=>{var r;let a=e[t.parentIndex];for(;a;){if((r=a.cells)!=null&&r.footerCell)return!0;a=e[a.parentIndex]}return!1},L=e=>e.filter(t=>{var a;return _(e,t)?!1:!!((a=t.cells)!=null&&a.footerCell)||!(t.children&&t.children.length>0)}),$=e=>{let t=e.width;return typeof(e==null?void 0:e.width)=="number"&&(e!=null&&e.minResizableWidth)&&(e==null?void 0:e.width)<(e==null?void 0:e.minResizableWidth)&&(t=e==null?void 0:e.minResizableWidth),typeof(e==null?void 0:e.width)=="number"&&(e!=null&&e.minWidth)&&(e==null?void 0:e.width)<(e==null?void 0:e.minWidth)?t=e==null?void 0:e.minWidth:typeof(e==null?void 0:e.width)=="number"&&(e!=null&&e.maxWidth)&&(e==null?void 0:e.width)>(e==null?void 0:e.maxWidth)&&(t=e==null?void 0:e.maxWidth),t!==void 0?Math.floor(parseFloat(t.toString()))+"px":void 0},V=(e,t)=>t&&t.filter(a=>a.field===e).length>0,E=e=>(e.sort((t,a)=>t.declarationIndex-a.declarationIndex),e.map(t=>{const{declarationIndex:a,parentIndex:r,depth:n,headerColSpan:d,rowSpan:h,index:i,kFirst:s,children:f,...o}=t;return f.length?{children:E(f),...o}:o})),W=e=>{const{cells:t,rowSpannable:a,defaultCell:r,...n}=e;return e.children.length?{...n,children:e.children.map(W)}:n},F=e=>({id:e.id,field:e.field,title:e.title,width:e.width,orderIndex:e.orderIndex,hidden:!1,minWidth:e.minWidth,maxWidth:e.maxWidth,children:e.children?k(e.children):null}),k=e=>e.map(F),P=e=>{const t=[],a=r=>r==null?void 0:r.forEach(n=>{t.push(n),a(n.children)});return a(e),t},K=typeof window!="undefined"&&/Firefox/.test(window.navigator.userAgent),Q=17895697,U=e=>{let t=[];return e.sortable&&(t=t.concat([l.GridContextMenuItemNames.sortAsc,l.GridContextMenuItemNames.sortDesc])),e.pdf&&(t.length&&(t=t.concat([l.GridContextMenuItemNames.separator])),t=t.concat([l.GridContextMenuItemNames.exportPDF])),t},J=e=>{let t=[];return e.clipboard&&(t=t.concat([l.GridContextMenuItemNames.copySelection,l.GridContextMenuItemNames.copySelectionNoHeaders,l.GridContextMenuItemNames.paste])),e.editable&&(t.length&&(t=t.concat([l.GridContextMenuItemNames.separator])),t=t.concat([l.GridContextMenuItemNames.create,l.GridContextMenuItemNames.edit,l.GridContextMenuItemNames.delete])),e.selectable&&(t.length&&(t=t.concat([l.GridContextMenuItemNames.separator])),t=t.concat([l.GridContextMenuItemNames.select])),e.rowReorderable&&(t.length&&(t=t.concat([l.GridContextMenuItemNames.separator])),t=t.concat([l.GridContextMenuItemNames.reorderRow])),e.pdf&&(t.length&&(t=t.concat([l.GridContextMenuItemNames.separator])),t=t.concat([l.GridContextMenuItemNames.exportPDF])),t},X=(e,t)=>{if(!(!e&&!t))return t?e?{...e,...t,select:{...e.select||{},...t.select||{}},hierarchy:{...e.hierarchy||{},...t.hierarchy||{}},group:{...e.group||{},...t.group||{}},edit:{...e.edit||{},...t.edit||{}}}:t:e},Y=e=>{var a;return typeof e=="object"?(a=e.enabled)!=null?a:!0:e!=null?e:!1},Z=()=>O.ServerFragment===T.ClientFragment,m=e=>!!(e&&e.$$typeof===Symbol.for("react.client.reference")),ee=e=>({id:e.id,ariaColumnIndex:e.ariaColumnIndex,isSelected:e.isSelected,isHighlighted:e.isHighlighted,isInEdit:e.isInEdit,isSorted:e.isSorted,isAlt:e.isAlt,expanded:e.expanded,className:e.className,style:e.style,field:e.field,dataItem:e.dataItem,format:e.format,colSpan:e.colSpan,dataIndex:e.dataIndex,columnIndex:e.columnIndex,columnsCount:e.columnsCount,rowType:e.rowType,level:e.level,editor:e.editor,locked:e.locked,isRtl:e.isRtl,rowDataIndex:e.rowDataIndex,columnPosition:e.columnPosition,group:e.group}),te=e=>{var r,n;const t=typeof e=="object"?(r=e.enabled)!=null?r:!0:e!=null?e:!1,a=typeof e=="object"?(n=e.valueGetter)!=null?n:((d,h)=>w.getter(h)(d)):(d,h)=>w.getter(h)(d);return{enabled:t,valueGetter:a}},A=e=>{var t;return M.isValidElement(e)?e:(t=M.Children.toArray(e))==null?void 0:t[0]},ie=(e,t)=>{const a=A(e);return a?M.cloneElement(a,t):null},ae=e=>{let t=0;if(e){const a=e.insertRow(0),r=a.insertCell(0);r.textContent="&nbsp;",t=a.getBoundingClientRect().height,e.deleteRow(0)}return t};exports.autoGenerateColumns=z;exports.calcRowHeight=ae;exports.clientColumn=W;exports.cloneReactElement=ie;exports.firefox=K;exports.firefoxMaxHeight=Q;exports.flatData=N;exports.footerColumns=L;exports.getClientCellProps=ee;exports.getColSpan=u;exports.getColumnState=F;exports.getColumnWidth=$;exports.getColumnsState=k;exports.getDataAsArray=D;exports.getDefaultBodyContextMenuItems=J;exports.getDefaultHeadContextMenuItems=U;exports.getFlatColumnsState=P;exports.getNestedValue=q;exports.getReactElement=A;exports.getRowSpanOptions=te;exports.isClient=Z;exports.isClientReference=m;exports.isRowReorderEnabled=Y;exports.isSorted=V;exports.mapColumns=B;exports.readColumns=p;exports.resolveCells=X;exports.sanitizeColumns=E;exports.syncLockedColumns=R;

package/utils/index.mjs

@@ -8,7 +8,7 @@
 import * as C from "react";
 import { gridDefaultProps as p } from "../GridColumn.mjs";
 import { getter as S } from "@progress/kendo-data-query";
-import { findGroupExpand as W, updateLeft as F, updateRight as R, tableKeyboardNavigationTools as b } from "@progress/kendo-react-data-tools";
+import { findGroupExpand as W, tableKeyboardNavigationTools as b, updateLeft as F, updateRight as R } from "@progress/kendo-react-data-tools";
 import { ServerFragment as D } from "./_serverModule.mjs";
 import { ClientFragment as E } from "./_clientModule.mjs";
 import { GridContextMenuItemNames as o } from "../contextMenu/enums.mjs";
@@ -292,7 +292,7 @@ const j = (e, t) => {
   group: e.group
 }), se = (e) => {
   var a, d;
-  const t = typeof e == "object" ? (a = e.enabled) != null ? a : !0 : e != null ? e : !1, r = typeof e == "object" ? (d = e.valueGetter) != null ? d : (n, l) => S(l)(n) : (n, l) => S(l)(n);
+  const t = typeof e == "object" ? (a = e.enabled) != null ? a : !0 : e != null ? e : !1, r = typeof e == "object" ? (d = e.valueGetter) != null ? d : ((n, l) => S(l)(n)) : (n, l) => S(l)(n);
   return { enabled: t, valueGetter: r };
 }, $ = (e) => {
   var t;

package/utils/premium.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 { GridColumnProps } from '../interfaces/GridColumnProps.js';
+import { GridComponentProps } from '../interfaces/GridProps.js';
+/**
+ * @hidden
+ */
+export declare const isPremiumGridByProps: (props: GridComponentProps) => {
+    [key: string]: boolean;
+};
+/**
+ * @hidden
+ */
+export declare const isPremiumGridByColumns: (columns: GridColumnProps[]) => {
+    [key: string]: boolean;
+};
+/**
+ * @hidden
+ */
+export declare const isPremiumGridByComponents: (props: GridComponentProps) => {
+    [key: string]: boolean;
+};
+/**
+ * @hidden
+ */
+export declare const gridPremiumFeatures: (props: GridComponentProps, columns: GridColumnProps[]) => string[];

package/utils/virtualColumns.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { ExtendedColumnProps } from '../GridColumn.js';
+import { GridCellRenderModel } from '../interfaces/GridCellRenderModel.js';
+/**
+ * @hidden
+ */
+export declare function getVirtualCellsToRender(args: {
+    cellModels: GridCellRenderModel[];
+    columns: ExtendedColumnProps[];
+    tableViewPortWidth: number;
+    scrollLeft: number;
+}): GridCellRenderModel[];