@progress/kendo-react-grid 12.3.0-develop.1 → 12.3.0-develop.10

package/header/HeaderRow.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 j=require("react"),A=require("./GridHeaderCell.js"),c=require("@progress/kendo-react-common"),z=require("@progress/kendo-react-data-tools"),g=require("../messages/index.js"),y=require("@progress/kendo-svg-icons"),i=require("../utils/index.js"),M=require("./client/GridHeaderCellContainer.js"),L=require("./client/HeaderRowDraggable.js"),W=require("./client/GridHeaderRowContainer.js"),V=require("./client/GridHeaderCellElementContainer.js"),_=require("./client/HeaderCellResizer.js");function $(e){const o=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const n in e)if(n!=="default"){const d=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(o,n,d.get?d:{enumerable:!0,get:()=>e[n]})}}return o.default=e,Object.freeze(o)}const t=$(j),B={none:"none",asc:"ascending",desc:"descending"},F=e=>{const o=e.unstyled,n=o&&o.uGrid?o.uGrid:c.uGrid;let d=0,q=-1;const G=a=>{if(!e.sort)return null;const r=c.classNames(n.sortIcon({}));return a>=0&&[t.createElement("span",{key:1,className:r},t.createElement(c.IconWrap,{name:"sort-"+e.sort[a].dir+"-small",icon:e.sort[a].dir==="asc"?y.sortAscSmallIcon:y.sortDescSmallIcon})),e.sort.length>1&&t.createElement("span",{key:2,className:r},t.createElement("span",{className:c.classNames(n.sortOrder({}))},a+1))]},N=a=>a.map(r=>{var I;const l=e.columns[r],H=e.sortable&&l.sortable,u=e.sort?e.sort.findIndex(s=>s.field===l.field):-1,w=u>=0&&e.sort[u].dir||"none",h=l.columnMenu===null?null:l.columnMenu||e.columnMenu,P=l.menuIcon||e.columnMenuIcon,O=c.classNames(c.classNames(n.headerTh({first:l.kFirst,filterable:!!h,locked:l.locked,sorted:e.sort&&e.sort.some(s=>s.field===l.field)})),l.headerClassName);l.locked===!1&&(l.left=0);const D=e.localization.toLanguageString(g.sortAriaLabel,g.messages[g.sortAriaLabel]),x=l.isAccessible?{ariaSort:B[w],role:"columnheader",ariaColumnIndex:l.ariaColumnIndex,ariaSelected:!1,ariaDescription:H?D:""}:{role:"presentation"},S=l.declarationIndex>=0?++q:--d,m={field:l.field,title:l.title,selectionValue:(I=l.headerSelectionValue)!=null?I:e.headerSelectionValue,children:G(u),selectionChange:null,columnMenuWrapperProps:{column:{field:l.field,title:l.title,locked:l.locked,filter:l.filter,id:l.id},sortable:H&&e.sortable,sort:e.sort,filter:e.filter,filterable:e.filterable&&l.filterable,filterOperators:e.filterOperators,navigatable:e.navigatable,group:e.group,groupable:e.groupable,columnMenu:h,columnMenuIcon:P}},C={...x,colSpan:l.headerColSpan,rowSpan:l.rowSpan,className:O,columnId:l.id,navigatable:l.navigatable,role:"columnheader"},f=i.clientColumn(l),k={column:f,sortable:e.sortable,sort:e.sort,columnMenuWrapperProps:m.columnMenuWrapperProps},E=l.defaultHeaderCell?l.defaultHeaderCell:A.GridHeaderCell,R=[t.createElement(M.GridHeaderCellContainer,{key:1,...k,isClient:i.isClientReference(E)},t.createElement(E,{...m})),t.createElement(_.HeaderCellResizer,{key:2,column:f})],b=i.resolveCells(e.cells,l.cells);if(b&&b.headerCell){const s=b.headerCell,T=i.isClientReference(s);return t.createElement(M.GridHeaderCellContainer,{key:S,...k,thProps:C,isCustom:!0,isClient:T},t.createElement(s,{...m,thProps:C,index:r},R))}return t.createElement(V.GridHeaderCellElementContainer,{key:S,column:f},t.createElement(z.HeaderThElement,{...C},R))}),v=e.columns.map(i.clientColumn);return t.createElement(W.GridHeaderRowContainer,{sortable:e.sortable,sort:e.sort,navigatable:e.navigatable,groupable:e.groupable,columns:v},e.columnsMap.map((a,r)=>t.createElement(L.HeaderRowDraggable,{key:r,className:c.classNames(n.simpleTr({})),ariaRowIndex:r+1},N(a))))};exports.HeaderRow=F;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const V=require("react"),_=require("./GridHeaderCell.js"),c=require("@progress/kendo-react-common"),$=require("@progress/kendo-react-data-tools"),S=require("../messages/index.js"),N=require("@progress/kendo-svg-icons"),d=require("../utils/index.js"),v=require("./client/GridHeaderCellContainer.js"),B=require("./client/HeaderRowDraggable.js"),F=require("./client/GridHeaderRowContainer.js"),J=require("./client/GridHeaderCellElementContainer.js"),K=require("./client/HeaderCellResizer.js");function Q(e){const i=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const a in e)if(a!=="default"){const o=Object.getOwnPropertyDescriptor(e,a);Object.defineProperty(i,a,o.get?o:{enumerable:!0,get:()=>e[a]})}}return i.default=e,Object.freeze(i)}const t=Q(V),U={none:"none",asc:"ascending",desc:"descending"},X=e=>{let i=e.columnsState||[];const a=e.unstyled,o=a&&a.uGrid?a.uGrid:c.uGrid;let w=0,P=-1;const O=r=>{if(!e.sort)return null;const n=c.classNames(o.sortIcon({}));return r>=0&&[t.createElement("span",{key:1,className:n},t.createElement(c.IconWrap,{name:"sort-"+e.sort[r].dir+"-small",icon:e.sort[r].dir==="asc"?N.sortAscSmallIcon:N.sortDescSmallIcon})),e.sort.length>1&&t.createElement("span",{key:2,className:n},t.createElement("span",{className:c.classNames(o.sortOrder({}))},r+1))]},D=r=>r.map(n=>{var M,q,G;const l=e.columns[n],u=i[n],m=(q=(M=l.locked)!=null?M:u==null?void 0:u.locked)!=null?q:!1,h=e.sortable&&l.sortable,C=e.sort?e.sort.findIndex(s=>s.field===l.field):-1,T=C>=0&&e.sort[C].dir||"none",k=l.columnMenu===null?null:l.columnMenu||e.columnMenu,j=l.menuIcon||e.columnMenuIcon,A=c.classNames(c.classNames(o.headerTh({first:l.kFirst,filterable:!!k,locked:m,sorted:e.sort&&e.sort.some(s=>s.field===l.field)})),l.headerClassName);m===!1&&(l.left=0);const L=e.localization.toLanguageString(S.sortAriaLabel,S.messages[S.sortAriaLabel]),z=l.isAccessible?{ariaSort:U[T],role:"columnheader",ariaColumnIndex:l.ariaColumnIndex,ariaSelected:!1,ariaDescription:h?L:""}:{role:"presentation"},E=l.declarationIndex>=0?++P:--w,f={field:l.field,title:l.title,selectionValue:(G=l.headerSelectionValue)!=null?G:e.headerSelectionValue,children:O(C),selectionChange:null,columnMenuWrapperProps:{column:{field:l.field,title:l.title,locked:m,filter:l.filter,id:l.id},sortable:h&&e.sortable,sort:e.sort,filter:e.filter,filterable:e.filterable&&l.filterable,filterOperators:e.filterOperators,navigatable:e.navigatable,group:e.group,groupable:e.groupable,columnMenu:k,columnMenuIcon:j}},b={...z,colSpan:l.headerColSpan,rowSpan:l.rowSpan,className:A,columnId:l.id,navigatable:l.navigatable,role:"columnheader"},g=d.clientColumn(l),R={column:g,sortable:e.sortable,sort:e.sort,columnMenuWrapperProps:f.columnMenuWrapperProps},y=l.defaultHeaderCell?l.defaultHeaderCell:_.GridHeaderCell,I=[t.createElement(v.GridHeaderCellContainer,{key:1,...R,isClient:d.isClientReference(y)},t.createElement(y,{...f})),t.createElement(K.HeaderCellResizer,{key:2,column:g})],H=d.resolveCells(e.cells,l.cells);if(H&&H.headerCell){const s=H.headerCell,W=d.isClientReference(s);return t.createElement(v.GridHeaderCellContainer,{key:E,...R,thProps:b,isCustom:!0,isClient:W},t.createElement(s,{...f,thProps:b,index:n},I))}return t.createElement(J.GridHeaderCellElementContainer,{key:E,column:g},t.createElement($.HeaderThElement,{...b},I))}),x=e.columns.map(d.clientColumn);return t.createElement(F.GridHeaderRowContainer,{sortable:e.sortable,sort:e.sort,navigatable:e.navigatable,groupable:e.groupable,columns:x},e.columnsMap.map((r,n)=>t.createElement(B.HeaderRowDraggable,{key:n,className:c.classNames(o.simpleTr({})),ariaRowIndex:n+1},D(r))))};exports.HeaderRow=X;

package/header/HeaderRow.mjs

@@ -6,75 +6,76 @@
  *-------------------------------------------------------------------------------------------
  */
 import * as t from "react";
-import { GridHeaderCell as O } from "./GridHeaderCell.mjs";
-import { uGrid as T, classNames as o, IconWrap as V } from "@progress/kendo-react-common";
-import { HeaderThElement as z } from "@progress/kendo-react-data-tools";
-import { sortAriaLabel as S, messages as B } from "../messages/index.mjs";
-import { sortAscSmallIcon as F, sortDescSmallIcon as j } from "@progress/kendo-svg-icons";
-import { clientColumn as H, isClientReference as M, resolveCells as q } from "../utils/index.mjs";
-import { GridHeaderCellContainer as v } from "./client/GridHeaderCellContainer.mjs";
-import { HeaderRowDraggable as J } from "./client/HeaderRowDraggable.mjs";
-import { GridHeaderRowContainer as K } from "./client/GridHeaderRowContainer.mjs";
-import { GridHeaderCellElementContainer as Q } from "./client/GridHeaderCellElementContainer.mjs";
-import { HeaderCellResizer as U } from "./client/HeaderCellResizer.mjs";
-const X = {
+import { GridHeaderCell as F } from "./GridHeaderCell.mjs";
+import { uGrid as j, classNames as o, IconWrap as q } from "@progress/kendo-react-common";
+import { HeaderThElement as J } from "@progress/kendo-react-data-tools";
+import { sortAriaLabel as y, messages as K } from "../messages/index.mjs";
+import { sortAscSmallIcon as Q, sortDescSmallIcon as U } from "@progress/kendo-svg-icons";
+import { clientColumn as G, isClientReference as N, resolveCells as X } from "../utils/index.mjs";
+import { GridHeaderCellContainer as P } from "./client/GridHeaderCellContainer.mjs";
+import { HeaderRowDraggable as Y } from "./client/HeaderRowDraggable.mjs";
+import { GridHeaderRowContainer as Z } from "./client/GridHeaderRowContainer.mjs";
+import { GridHeaderCellElementContainer as _ } from "./client/GridHeaderCellElementContainer.mjs";
+import { HeaderCellResizer as $ } from "./client/HeaderCellResizer.mjs";
+const p = {
   none: "none",
   asc: "ascending",
   desc: "descending"
-}, oe = (e) => {
-  const s = e.unstyled, c = s && s.uGrid ? s.uGrid : T;
-  let y = 0, G = -1;
-  const N = (n) => {
+}, de = (e) => {
+  let R = e.columnsState || [];
+  const s = e.unstyled, c = s && s.uGrid ? s.uGrid : j;
+  let w = 0, x = -1;
+  const A = (a) => {
     if (!e.sort)
       return null;
-    const a = o(c.sortIcon({}));
-    return n >= 0 && [
-      /* @__PURE__ */ t.createElement("span", { key: 1, className: a }, /* @__PURE__ */ t.createElement(
-        V,
+    const n = o(c.sortIcon({}));
+    return a >= 0 && [
+      /* @__PURE__ */ t.createElement("span", { key: 1, className: n }, /* @__PURE__ */ t.createElement(
+        q,
         {
-          name: "sort-" + e.sort[n].dir + "-small",
-          icon: e.sort[n].dir === "asc" ? F : j
+          name: "sort-" + e.sort[a].dir + "-small",
+          icon: e.sort[a].dir === "asc" ? Q : U
         }
       )),
-      e.sort.length > 1 && /* @__PURE__ */ t.createElement("span", { key: 2, className: a }, /* @__PURE__ */ t.createElement("span", { className: o(c.sortOrder({})) }, n + 1))
+      e.sort.length > 1 && /* @__PURE__ */ t.createElement("span", { key: 2, className: n }, /* @__PURE__ */ t.createElement("span", { className: o(c.sortOrder({})) }, a + 1))
     ];
-  }, P = (n) => n.map((a) => {
-    var k;
-    const l = e.columns[a], C = e.sortable && l.sortable, i = e.sort ? e.sort.findIndex((r) => r.field === l.field) : -1, w = i >= 0 && e.sort[i].dir || "none", b = l.columnMenu === null ? null : l.columnMenu || e.columnMenu, x = l.menuIcon || e.columnMenuIcon, A = o(
+  }, D = (a) => a.map((n) => {
+    var H, M, v;
+    const l = e.columns[n], i = R[n], m = (M = (H = l.locked) != null ? H : i == null ? void 0 : i.locked) != null ? M : !1, g = e.sortable && l.sortable, d = e.sort ? e.sort.findIndex((r) => r.field === l.field) : -1, W = d >= 0 && e.sort[d].dir || "none", h = l.columnMenu === null ? null : l.columnMenu || e.columnMenu, O = l.menuIcon || e.columnMenuIcon, T = o(
       o(
         c.headerTh({
           first: l.kFirst,
-          filterable: !!b,
-          locked: l.locked,
+          filterable: !!h,
+          locked: m,
           sorted: e.sort && e.sort.some((r) => r.field === l.field)
         })
       ),
       l.headerClassName
     );
-    l.locked === !1 && (l.left = 0);
-    const D = e.localization.toLanguageString(S, B[S]), W = l.isAccessible ? {
-      ariaSort: X[w],
+    m === !1 && (l.left = 0);
+    const V = e.localization.toLanguageString(y, K[y]), z = l.isAccessible ? {
+      ariaSort: p[W],
       role: "columnheader",
       ariaColumnIndex: l.ariaColumnIndex,
       ariaSelected: !1,
-      ariaDescription: C ? D : ""
+      ariaDescription: g ? V : ""
     } : {
       role: "presentation"
-    }, g = l.declarationIndex >= 0 ? ++G : --y, m = {
+    }, E = l.declarationIndex >= 0 ? ++x : --w, u = {
       field: l.field,
       title: l.title,
-      selectionValue: (k = l.headerSelectionValue) != null ? k : e.headerSelectionValue,
-      children: N(i),
+      selectionValue: (v = l.headerSelectionValue) != null ? v : e.headerSelectionValue,
+      children: A(d),
       selectionChange: null,
       columnMenuWrapperProps: {
         column: {
           field: l.field,
           title: l.title,
-          locked: l.locked,
+          locked: m,
           filter: l.filter,
           id: l.id
         },
-        sortable: C && e.sortable,
+        sortable: g && e.sortable,
         sort: e.sort,
         filter: e.filter,
         filterable: e.filterable && l.filterable,
@@ -82,54 +83,54 @@ const X = {
         navigatable: e.navigatable,
         group: e.group,
         groupable: e.groupable,
-        columnMenu: b,
-        columnMenuIcon: x
+        columnMenu: h,
+        columnMenuIcon: O
       }
-    }, d = {
-      ...W,
+    }, f = {
+      ...z,
       colSpan: l.headerColSpan,
       rowSpan: l.rowSpan,
-      className: A,
+      className: T,
       columnId: l.id,
       navigatable: l.navigatable,
       role: "columnheader"
-    }, u = H(l), h = {
-      column: u,
+    }, C = G(l), S = {
+      column: C,
       sortable: e.sortable,
       sort: e.sort,
-      columnMenuWrapperProps: m.columnMenuWrapperProps
-    }, E = l.defaultHeaderCell ? l.defaultHeaderCell : O, I = [
-      /* @__PURE__ */ t.createElement(v, { key: 1, ...h, isClient: M(E) }, /* @__PURE__ */ t.createElement(E, { ...m })),
-      /* @__PURE__ */ t.createElement(U, { key: 2, column: u })
-    ], f = q(e.cells, l.cells);
-    if (f && f.headerCell) {
-      const r = f.headerCell, L = M(r);
+      columnMenuWrapperProps: u.columnMenuWrapperProps
+    }, k = l.defaultHeaderCell ? l.defaultHeaderCell : F, I = [
+      /* @__PURE__ */ t.createElement(P, { key: 1, ...S, isClient: N(k) }, /* @__PURE__ */ t.createElement(k, { ...u })),
+      /* @__PURE__ */ t.createElement($, { key: 2, column: C })
+    ], b = X(e.cells, l.cells);
+    if (b && b.headerCell) {
+      const r = b.headerCell, B = N(r);
       return /* @__PURE__ */ t.createElement(
-        v,
+        P,
         {
-          key: g,
-          ...h,
-          thProps: d,
+          key: E,
+          ...S,
+          thProps: f,
           isCustom: !0,
-          isClient: L
+          isClient: B
         },
-        /* @__PURE__ */ t.createElement(r, { ...m, thProps: d, index: a }, I)
+        /* @__PURE__ */ t.createElement(r, { ...u, thProps: f, index: n }, I)
       );
     }
-    return /* @__PURE__ */ t.createElement(Q, { key: g, column: u }, /* @__PURE__ */ t.createElement(z, { ...d }, I));
-  }), R = e.columns.map(H);
+    return /* @__PURE__ */ t.createElement(_, { key: E, column: C }, /* @__PURE__ */ t.createElement(J, { ...f }, I));
+  }), L = e.columns.map(G);
   return /* @__PURE__ */ t.createElement(
-    K,
+    Z,
     {
       sortable: e.sortable,
       sort: e.sort,
       navigatable: e.navigatable,
       groupable: e.groupable,
-      columns: R
+      columns: L
     },
-    e.columnsMap.map((n, a) => /* @__PURE__ */ t.createElement(J, { key: a, className: o(c.simpleTr({})), ariaRowIndex: a + 1 }, P(n)))
+    e.columnsMap.map((a, n) => /* @__PURE__ */ t.createElement(Y, { key: n, className: o(c.simpleTr({})), ariaRowIndex: n + 1 }, D(a)))
   );
 };
 export {
-  oe as HeaderRow
+  de as HeaderRow
 };

package/index.d.mts

@@ -121,7 +121,7 @@ export declare interface CompositeHighlightDescriptor {
     /**
      * An array of filter descriptors representing the filters applied to the grid.
      */
-    filters: FilterDescriptor[];
+    filters: Array<FilterDescriptor | CompositeFilterDescriptor>;
     /**
      * The logical operator ('and' | 'or') used to combine the filters.
      */
@@ -350,6 +350,147 @@ export declare const GRID_PREVENT_SELECTION_ELEMENT = "data-prevent-selection";
 /** The attribute required by the Grid selection on Grid `tr` elements. */
 export declare const GRID_ROW_INDEX_ATTRIBUTE = "data-grid-row-index";
 
+/**
+ * Represents a command structure returned by AI services for grid operations.
+ * Each command contains the operation type and relevant configuration data.
+ *
+ * @example
+ * ```tsx
+ * // Sort command example
+ * const sortCommand: GridAIAssistantCommand = {
+ *   type: 'GridSort',
+ *   sort: { field: 'productName', dir: 'asc' },
+ *   message: 'Sorted by Product Name ascending'
+ * };
+ *
+ * // Filter command example
+ * const filterCommand: GridAIAssistantCommand = {
+ *   type: 'GridFilter',
+ *   filter: {
+ *     logic: 'and',
+ *     filters: [{ field: 'price', operator: 'gte', value: 100 }]
+ *   },
+ *   message: 'Filtered products with price >= 100'
+ * };
+ * ```
+ */
+export declare interface GridAIAssistantCommand {
+    /**
+     * The type of grid operation to perform.
+     * Possible values: 'GridSort', 'GridFilter', 'GridGroup', 'GridHighlight', 'GridClearSort', 'GridClearFilter', 'GridClearGroup', 'GridClearHighlight'
+     */
+    type: GridAICommands;
+    /**
+     * The filename for export operations, including the file extension.
+     * Used when the AI assistant performs export commands such as PDF generation.
+     * Expected data type: string ending with file extension (e.g., '.pdf', '.xlsx').
+     */
+    fileName?: string;
+    /**
+     * The sort descriptor for sorting operations.
+     */
+    sort?: SortDescriptor | SortDescriptor[];
+    /**
+     * The filter descriptor for filtering operations.
+     */
+    filter?: CompositeFilterDescriptor;
+    /**
+     * The group descriptor for grouping operations.
+     */
+    group?: GroupDescriptor | GroupDescriptor[];
+    /**
+     * The highlight descriptor for highlight operations.
+     */
+    highlight?: any;
+    /**
+     * The select descriptor for selection operations.
+     * Used when type is 'GridSelect' to define cell or row selection criteria.
+     *
+     * @example
+     * ```tsx
+     * select: {
+     *   cells: { 'Age': true },
+     *   filters: [{ field: 'Age', operator: 'gt', value: 60 }],
+     *   logic: 'and'
+     * }
+     * ```
+     */
+    select?: CompositeHighlightDescriptor;
+    /**
+     * The message describing the operation.
+     */
+    message?: string;
+    /**
+     * The messages describing the operation (alternative to message).
+     */
+    messages?: string[];
+    /**
+     * The new size value for column resize operations.
+     * Specifies the width dimension when resizing grid columns.
+     */
+    size?: string;
+    /**
+     * The unique identifier of the column to resize.
+     * Used when type is 'GridColumnResize' to specify which column should be resized.
+     */
+    id?: string;
+    /**
+     * The target position for column reordering operations.
+     * Used when type is 'GridColumnReorder' to specify the new column index.
+     */
+    position?: number;
+}
+
+/**
+ * Enum defining the available AI command types for grid operations.
+ * These commands control different aspects of grid functionality through AI prompts.
+ *
+ * @example
+ * ```tsx
+ * // Used internally when processing AI responses
+ * const command = {
+ *   type: GridAICommands.GridSort,
+ *   sort: { field: 'name', dir: 'asc' }
+ * };
+ * ```
+ */
+export declare enum GridAICommands {
+    /** Clears all applied filters from the grid */
+    GridClearFilter = "GridClearFilter",
+    /** Clears all applied sorting from the grid */
+    GridClearSort = "GridClearSort",
+    /** Clears all applied grouping from the grid */
+    GridClearGroup = "GridClearGroup",
+    /** Clears all applied highlighting from the grid */
+    GridClearHighlight = "GridClearHighlight",
+    /** Clears all applied selections from the grid */
+    GridClearSelect = "GridClearSelect",
+    /** Applies sorting to grid columns */
+    GridSort = "GridSort",
+    /** Applies filtering to grid data */
+    GridFilter = "GridFilter",
+    /** Applies grouping to grid data */
+    GridGroup = "GridGroup",
+    /** Applies highlighting to grid cells or rows */
+    GridHighlight = "GridHighlight",
+    /** Applies select to grid cells or rows */
+    GridSelect = "GridSelect",
+    /** Exports the grid data as a PDF document */
+    GridExportPDF = "GridExportPDF",
+    /** Resizes grid columns to specified dimensions */
+    GridColumnResize = "GridColumnResize",
+    /** Hides specified grid columns from view */
+    GridColumnHide = "GridColumnHide",
+    /** Shows previously hidden grid columns */
+    GridColumnShow = "GridColumnShow",
+    /** Reorders grid columns to new positions */
+    GridColumnReorder = "GridColumnReorder",
+    /** Locks grid columns to prevent horizontal scrolling */
+    GridColumnLock = "GridColumnLock",
+    /** Unlocks previously locked grid columns */
+    GridColumnUnlock = "GridColumnUnlock"
+}
+
 export declare const GridAIPrompt: (props: GridAIPromptProps) => JSX.Element;
 
 /**
@@ -1759,6 +1900,10 @@ export declare interface GridColumnState {
      * A collection of child states.
      */
     children?: GridColumnState[];
+    /**
+     * Determines if the column is locked to the left or right side of the grid.
+     */
+    locked?: boolean;
 }
 
 /**
@@ -4108,6 +4253,29 @@ export declare interface GridToolbarAIAssistantHandle {
     hide: () => void;
 }
 
+/**
+ * Represents the props interface for the GridToolbarAIAssistant component.
+ * This component provides AI-powered functionality for grid operations through natural language prompts.
+ * Users can request sorting, filtering, grouping, and highlighting through conversational input.
+ *
+ * @example
+ * ```tsx
+ * <Grid data={products}>
+ *   <GridToolbar>
+ *     <GridToolbarAIAssistant
+ *       requestUrl="/api/ai/grid"
+ *       promptPlaceHolder="Ask AI to sort, filter, or group your data"
+ *       suggestionsList={[
+ *         'Sort products by price',
+ *         'Show only electronics',
+ *         'Group by category'
+ *       ]}
+ *       onResponseSuccess={(response) => console.log('AI processed:', response)}
+ *     />
+ *   </GridToolbar>
+ * </Grid>
+ * ```
+ */
 export declare interface GridToolbarAIAssistantProps {
     /**
      * Defines the URL to which the request will be sent.

package/index.d.ts

@@ -121,7 +121,7 @@ export declare interface CompositeHighlightDescriptor {
     /**
      * An array of filter descriptors representing the filters applied to the grid.
      */
-    filters: FilterDescriptor[];
+    filters: Array<FilterDescriptor | CompositeFilterDescriptor>;
     /**
      * The logical operator ('and' | 'or') used to combine the filters.
      */
@@ -350,6 +350,147 @@ export declare const GRID_PREVENT_SELECTION_ELEMENT = "data-prevent-selection";
 /** The attribute required by the Grid selection on Grid `tr` elements. */
 export declare const GRID_ROW_INDEX_ATTRIBUTE = "data-grid-row-index";
 
+/**
+ * Represents a command structure returned by AI services for grid operations.
+ * Each command contains the operation type and relevant configuration data.
+ *
+ * @example
+ * ```tsx
+ * // Sort command example
+ * const sortCommand: GridAIAssistantCommand = {
+ *   type: 'GridSort',
+ *   sort: { field: 'productName', dir: 'asc' },
+ *   message: 'Sorted by Product Name ascending'
+ * };
+ *
+ * // Filter command example
+ * const filterCommand: GridAIAssistantCommand = {
+ *   type: 'GridFilter',
+ *   filter: {
+ *     logic: 'and',
+ *     filters: [{ field: 'price', operator: 'gte', value: 100 }]
+ *   },
+ *   message: 'Filtered products with price >= 100'
+ * };
+ * ```
+ */
+export declare interface GridAIAssistantCommand {
+    /**
+     * The type of grid operation to perform.
+     * Possible values: 'GridSort', 'GridFilter', 'GridGroup', 'GridHighlight', 'GridClearSort', 'GridClearFilter', 'GridClearGroup', 'GridClearHighlight'
+     */
+    type: GridAICommands;
+    /**
+     * The filename for export operations, including the file extension.
+     * Used when the AI assistant performs export commands such as PDF generation.
+     * Expected data type: string ending with file extension (e.g., '.pdf', '.xlsx').
+     */
+    fileName?: string;
+    /**
+     * The sort descriptor for sorting operations.
+     */
+    sort?: SortDescriptor | SortDescriptor[];
+    /**
+     * The filter descriptor for filtering operations.
+     */
+    filter?: CompositeFilterDescriptor;
+    /**
+     * The group descriptor for grouping operations.
+     */
+    group?: GroupDescriptor | GroupDescriptor[];
+    /**
+     * The highlight descriptor for highlight operations.
+     */
+    highlight?: any;
+    /**
+     * The select descriptor for selection operations.
+     * Used when type is 'GridSelect' to define cell or row selection criteria.
+     *
+     * @example
+     * ```tsx
+     * select: {
+     *   cells: { 'Age': true },
+     *   filters: [{ field: 'Age', operator: 'gt', value: 60 }],
+     *   logic: 'and'
+     * }
+     * ```
+     */
+    select?: CompositeHighlightDescriptor;
+    /**
+     * The message describing the operation.
+     */
+    message?: string;
+    /**
+     * The messages describing the operation (alternative to message).
+     */
+    messages?: string[];
+    /**
+     * The new size value for column resize operations.
+     * Specifies the width dimension when resizing grid columns.
+     */
+    size?: string;
+    /**
+     * The unique identifier of the column to resize.
+     * Used when type is 'GridColumnResize' to specify which column should be resized.
+     */
+    id?: string;
+    /**
+     * The target position for column reordering operations.
+     * Used when type is 'GridColumnReorder' to specify the new column index.
+     */
+    position?: number;
+}
+
+/**
+ * Enum defining the available AI command types for grid operations.
+ * These commands control different aspects of grid functionality through AI prompts.
+ *
+ * @example
+ * ```tsx
+ * // Used internally when processing AI responses
+ * const command = {
+ *   type: GridAICommands.GridSort,
+ *   sort: { field: 'name', dir: 'asc' }
+ * };
+ * ```
+ */
+export declare enum GridAICommands {
+    /** Clears all applied filters from the grid */
+    GridClearFilter = "GridClearFilter",
+    /** Clears all applied sorting from the grid */
+    GridClearSort = "GridClearSort",
+    /** Clears all applied grouping from the grid */
+    GridClearGroup = "GridClearGroup",
+    /** Clears all applied highlighting from the grid */
+    GridClearHighlight = "GridClearHighlight",
+    /** Clears all applied selections from the grid */
+    GridClearSelect = "GridClearSelect",
+    /** Applies sorting to grid columns */
+    GridSort = "GridSort",
+    /** Applies filtering to grid data */
+    GridFilter = "GridFilter",
+    /** Applies grouping to grid data */
+    GridGroup = "GridGroup",
+    /** Applies highlighting to grid cells or rows */
+    GridHighlight = "GridHighlight",
+    /** Applies select to grid cells or rows */
+    GridSelect = "GridSelect",
+    /** Exports the grid data as a PDF document */
+    GridExportPDF = "GridExportPDF",
+    /** Resizes grid columns to specified dimensions */
+    GridColumnResize = "GridColumnResize",
+    /** Hides specified grid columns from view */
+    GridColumnHide = "GridColumnHide",
+    /** Shows previously hidden grid columns */
+    GridColumnShow = "GridColumnShow",
+    /** Reorders grid columns to new positions */
+    GridColumnReorder = "GridColumnReorder",
+    /** Locks grid columns to prevent horizontal scrolling */
+    GridColumnLock = "GridColumnLock",
+    /** Unlocks previously locked grid columns */
+    GridColumnUnlock = "GridColumnUnlock"
+}
+
 export declare const GridAIPrompt: (props: GridAIPromptProps) => JSX.Element;
 
 /**
@@ -1759,6 +1900,10 @@ export declare interface GridColumnState {
      * A collection of child states.
      */
     children?: GridColumnState[];
+    /**
+     * Determines if the column is locked to the left or right side of the grid.
+     */
+    locked?: boolean;
 }
 
 /**
@@ -4108,6 +4253,29 @@ export declare interface GridToolbarAIAssistantHandle {
     hide: () => void;
 }
 
+/**
+ * Represents the props interface for the GridToolbarAIAssistant component.
+ * This component provides AI-powered functionality for grid operations through natural language prompts.
+ * Users can request sorting, filtering, grouping, and highlighting through conversational input.
+ *
+ * @example
+ * ```tsx
+ * <Grid data={products}>
+ *   <GridToolbar>
+ *     <GridToolbarAIAssistant
+ *       requestUrl="/api/ai/grid"
+ *       promptPlaceHolder="Ask AI to sort, filter, or group your data"
+ *       suggestionsList={[
+ *         'Sort products by price',
+ *         'Show only electronics',
+ *         'Group by category'
+ *       ]}
+ *       onResponseSuccess={(response) => console.log('AI processed:', response)}
+ *     />
+ *   </GridToolbar>
+ * </Grid>
+ * ```
+ */
 export declare interface GridToolbarAIAssistantProps {
     /**
      * Defines the URL to which the request will be sent.

package/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 a=require("./Grid.js"),G=require("./GridColumn.js"),s=require("./columnMenu/GridColumnMenuWrapper.js"),C=require("./columnMenu/GridColumnMenuGroup.js"),l=require("./columnMenu/GridColumnMenuSort.js"),o=require("./columnMenu/GridColumnMenuFilter.js"),c=require("./columnMenu/GridColumnMenuFilterUI.js"),m=require("./columnMenu/GridColumnMenuFilterCell.js"),p=require("./columnMenu/GridColumnMenuCheckboxFilter.js"),M=require("./columnMenu/GridColumnMenuColumnsList.js"),g=require("./columnMenu/GridColumnMenuColumnsChooser.js"),T=require("./cells/datacell/GridCell.js"),b=require("./cells/editcell/GridEditCell.js"),q=require("./cells/groupcell/GridGroupCell.js"),I=require("./cells/hierarchycell/GridHierarchyCell.js"),S=require("./cells/GridFilterCell.js"),F=require("./header/GridHeaderCell.js"),E=require("./cells/selectioncell/GridSelectionCell.js"),P=require("./rows/GridDetailRow.js"),D=require("./rows/GridRow.js"),h=require("./GridToolbar.js"),x=require("./toolbar-tools/GridToolbarSpacer.js"),R=require("./toolbar-tools/GridToolbarSeparator.js"),A=require("./toolbar-tools/GridToolbarCheckboxFilter.js"),_=require("./toolbar-tools/GridToolbarColumnsChooser.js"),B=require("./toolbar-tools/GridToolbarFilter.js"),N=require("./toolbar-tools/GridToolbarSort.js"),f=require("./toolbar-tools/GridToolbarGroup.js"),L=require("./toolbar-tools/GridToolbarAIAssistant.js"),O=require("./toolbar-tools/ai-tool/GridAIPrompt.js"),y=require("./components/noRecords/GridNoRecords.js"),w=require("./columnMenu/GridColumnMenuItem.js"),k=require("./columnMenu/GridColumnMenuItemContent.js"),v=require("./columnMenu/GridColumnMenuItemGroup.js"),t=require("./constants/index.js"),i=require("@progress/kendo-react-data-tools"),U=require("./drag/CommonDragLogic.js"),e=require("./filterCommon.js"),r=require("./messages/index.js"),n=require("./StatusBar.js"),u=require("./contextMenu/GridContextMenu.js"),d=require("./contextMenu/enums.js"),H=require("./GridSearchBox.js"),W=require("./GridPdfExportButton.js");exports.Grid=a.Grid;exports.GridColumn=G.GridColumn;exports.GridColumnMenuWrapper=s.GridColumnMenuWrapper;exports.GridColumnMenuGroup=C.GridColumnMenuGroup;exports.GridColumnMenuSort=l.GridColumnMenuSort;exports.isColumnMenuSortActive=l.isColumnMenuSortActive;exports.GridColumnMenuFilter=o.GridColumnMenuFilter;exports.filterGroupByField=o.filterGroupByField;exports.isColumnMenuFilterActive=o.isColumnMenuFilterActive;exports.rootFilterOrDefault=o.rootFilterOrDefault;exports.GridColumnMenuFilterUI=c.GridColumnMenuFilterUI;exports.GridColumnMenuFilterCell=m.GridColumnMenuFilterCell;exports.GridColumnMenuCheckboxFilter=p.GridColumnMenuCheckboxFilter;exports.GridColumnMenuColumnsList=M.GridColumnMenuColumnsList;exports.GridColumnMenuColumnsChooser=g.GridColumnMenuColumnsChooser;exports.GridCell=T.GridCell;exports.GridEditCell=b.GridEditCell;exports.GridGroupCell=q.GridGroupCell;exports.GridHierarchyCell=I.GridHierarchyCell;exports.GridFilterCell=S.GridFilterCell;exports.GridHeaderCell=F.GridHeaderCell;exports.GridSelectionCell=E.GridSelectionCell;exports.GridDetailRow=P.GridDetailRow;exports.GridRow=D.GridRow;exports.GridToolbar=h.GridToolbar;exports.GridToolbarSpacer=x.GridToolbarSpacer;exports.GridToolbarSeparator=R.GridToolbarSeparator;exports.GridToolbarCheckboxFilter=A.GridToolbarCheckboxFilter;exports.GridToolbarColumnsChooser=_.GridToolbarColumnsChooser;exports.GridToolbarFilter=B.GridToolbarFilter;exports.GridToolbarSort=N.GridToolbarSort;exports.GridToolbarGroup=f.GridToolbarGroup;exports.GridToolbarAIAssistant=L.GridToolbarAIAssistant;exports.GridAIPrompt=O.GridAIPrompt;exports.GridNoRecords=y.GridNoRecords;exports.GridColumnMenuItem=w.GridColumnMenuItem;exports.GridColumnMenuItemContent=k.GridColumnMenuItemContent;exports.GridColumnMenuItemGroup=v.GridColumnMenuItemGroup;exports.GRID_COL_INDEX_ATTRIBUTE=t.GRID_COL_INDEX_ATTRIBUTE;exports.GRID_PREVENT_SELECTION_ELEMENT=t.GRID_PREVENT_SELECTION_ELEMENT;exports.GRID_ROW_INDEX_ATTRIBUTE=t.GRID_ROW_INDEX_ATTRIBUTE;Object.defineProperty(exports,"getSelectedState",{enumerable:!0,get:()=>i.getSelectedState});Object.defineProperty(exports,"getSelectedStateFromKeyDown",{enumerable:!0,get:()=>i.getSelectedStateFromKeyDown});Object.defineProperty(exports,"setSelectedState",{enumerable:!0,get:()=>i.setSelectedState});exports.GridCommonDragLogic=U.CommonDragLogic;exports.booleanFilterValues=e.booleanFilterValues;exports.cellBoolDropdownChange=e.cellBoolDropdownChange;exports.cellInputChange=e.cellInputChange;exports.cellOperatorChange=e.cellOperatorChange;exports.combineSmartFilters=e.combineSmartFilters;exports.operators=e.operators;exports.parseFilterDates=e.parseFilterDates;exports.gridMessages=r.messages;exports.pagerFirstPage=r.pagerFirstPage;exports.pagerInfo=r.pagerInfo;exports.pagerItemPerPage=r.pagerItemPerPage;exports.pagerLastPage=r.pagerLastPage;exports.pagerNextPage=r.pagerNextPage;exports.pagerPreviousPage=r.pagerPreviousPage;exports.StatusBar=n.StatusBar;exports.getStatusData=n.getStatusData;exports.leafColumns=n.leafColumns;exports.GridContextMenu=u.GridContextMenu;exports.contextMenuItemsMap=u.contextMenuItemsMap;exports.GridContextMenuAnchorPart=d.GridContextMenuAnchorPart;exports.GridContextMenuItemNames=d.GridContextMenuItemNames;exports.GridSearchBox=H.GridSearchBox;exports.GridPdfExportButton=W.GridPdfExportButton;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const G=require("./Grid.js"),s=require("./GridColumn.js"),C=require("./columnMenu/GridColumnMenuWrapper.js"),m=require("./columnMenu/GridColumnMenuGroup.js"),l=require("./columnMenu/GridColumnMenuSort.js"),o=require("./columnMenu/GridColumnMenuFilter.js"),c=require("./columnMenu/GridColumnMenuFilterUI.js"),p=require("./columnMenu/GridColumnMenuFilterCell.js"),M=require("./columnMenu/GridColumnMenuCheckboxFilter.js"),g=require("./columnMenu/GridColumnMenuColumnsList.js"),T=require("./columnMenu/GridColumnMenuColumnsChooser.js"),I=require("./cells/datacell/GridCell.js"),b=require("./cells/editcell/GridEditCell.js"),q=require("./cells/groupcell/GridGroupCell.js"),S=require("./cells/hierarchycell/GridHierarchyCell.js"),F=require("./cells/GridFilterCell.js"),E=require("./header/GridHeaderCell.js"),P=require("./cells/selectioncell/GridSelectionCell.js"),D=require("./rows/GridDetailRow.js"),h=require("./rows/GridRow.js"),x=require("./GridToolbar.js"),R=require("./toolbar-tools/GridToolbarSpacer.js"),A=require("./toolbar-tools/GridToolbarSeparator.js"),_=require("./toolbar-tools/GridToolbarCheckboxFilter.js"),B=require("./toolbar-tools/GridToolbarColumnsChooser.js"),N=require("./toolbar-tools/GridToolbarFilter.js"),f=require("./toolbar-tools/GridToolbarSort.js"),L=require("./toolbar-tools/GridToolbarGroup.js"),u=require("./toolbar-tools/GridToolbarAIAssistant.js"),O=require("./toolbar-tools/ai-tool/GridAIPrompt.js"),y=require("./components/noRecords/GridNoRecords.js"),w=require("./columnMenu/GridColumnMenuItem.js"),k=require("./columnMenu/GridColumnMenuItemContent.js"),v=require("./columnMenu/GridColumnMenuItemGroup.js"),i=require("./constants/index.js"),t=require("@progress/kendo-react-data-tools"),U=require("./drag/CommonDragLogic.js"),e=require("./filterCommon.js"),r=require("./messages/index.js"),n=require("./StatusBar.js"),d=require("./contextMenu/GridContextMenu.js"),a=require("./contextMenu/enums.js"),H=require("./GridSearchBox.js"),W=require("./GridPdfExportButton.js");exports.Grid=G.Grid;exports.GridColumn=s.GridColumn;exports.GridColumnMenuWrapper=C.GridColumnMenuWrapper;exports.GridColumnMenuGroup=m.GridColumnMenuGroup;exports.GridColumnMenuSort=l.GridColumnMenuSort;exports.isColumnMenuSortActive=l.isColumnMenuSortActive;exports.GridColumnMenuFilter=o.GridColumnMenuFilter;exports.filterGroupByField=o.filterGroupByField;exports.isColumnMenuFilterActive=o.isColumnMenuFilterActive;exports.rootFilterOrDefault=o.rootFilterOrDefault;exports.GridColumnMenuFilterUI=c.GridColumnMenuFilterUI;exports.GridColumnMenuFilterCell=p.GridColumnMenuFilterCell;exports.GridColumnMenuCheckboxFilter=M.GridColumnMenuCheckboxFilter;exports.GridColumnMenuColumnsList=g.GridColumnMenuColumnsList;exports.GridColumnMenuColumnsChooser=T.GridColumnMenuColumnsChooser;exports.GridCell=I.GridCell;exports.GridEditCell=b.GridEditCell;exports.GridGroupCell=q.GridGroupCell;exports.GridHierarchyCell=S.GridHierarchyCell;exports.GridFilterCell=F.GridFilterCell;exports.GridHeaderCell=E.GridHeaderCell;exports.GridSelectionCell=P.GridSelectionCell;exports.GridDetailRow=D.GridDetailRow;exports.GridRow=h.GridRow;exports.GridToolbar=x.GridToolbar;exports.GridToolbarSpacer=R.GridToolbarSpacer;exports.GridToolbarSeparator=A.GridToolbarSeparator;exports.GridToolbarCheckboxFilter=_.GridToolbarCheckboxFilter;exports.GridToolbarColumnsChooser=B.GridToolbarColumnsChooser;exports.GridToolbarFilter=N.GridToolbarFilter;exports.GridToolbarSort=f.GridToolbarSort;exports.GridToolbarGroup=L.GridToolbarGroup;exports.GridAICommands=u.GridAICommands;exports.GridToolbarAIAssistant=u.GridToolbarAIAssistant;exports.GridAIPrompt=O.GridAIPrompt;exports.GridNoRecords=y.GridNoRecords;exports.GridColumnMenuItem=w.GridColumnMenuItem;exports.GridColumnMenuItemContent=k.GridColumnMenuItemContent;exports.GridColumnMenuItemGroup=v.GridColumnMenuItemGroup;exports.GRID_COL_INDEX_ATTRIBUTE=i.GRID_COL_INDEX_ATTRIBUTE;exports.GRID_PREVENT_SELECTION_ELEMENT=i.GRID_PREVENT_SELECTION_ELEMENT;exports.GRID_ROW_INDEX_ATTRIBUTE=i.GRID_ROW_INDEX_ATTRIBUTE;Object.defineProperty(exports,"getSelectedState",{enumerable:!0,get:()=>t.getSelectedState});Object.defineProperty(exports,"getSelectedStateFromKeyDown",{enumerable:!0,get:()=>t.getSelectedStateFromKeyDown});Object.defineProperty(exports,"setSelectedState",{enumerable:!0,get:()=>t.setSelectedState});exports.GridCommonDragLogic=U.CommonDragLogic;exports.booleanFilterValues=e.booleanFilterValues;exports.cellBoolDropdownChange=e.cellBoolDropdownChange;exports.cellInputChange=e.cellInputChange;exports.cellOperatorChange=e.cellOperatorChange;exports.combineSmartFilters=e.combineSmartFilters;exports.operators=e.operators;exports.parseFilterDates=e.parseFilterDates;exports.gridMessages=r.messages;exports.pagerFirstPage=r.pagerFirstPage;exports.pagerInfo=r.pagerInfo;exports.pagerItemPerPage=r.pagerItemPerPage;exports.pagerLastPage=r.pagerLastPage;exports.pagerNextPage=r.pagerNextPage;exports.pagerPreviousPage=r.pagerPreviousPage;exports.StatusBar=n.StatusBar;exports.getStatusData=n.getStatusData;exports.leafColumns=n.leafColumns;exports.GridContextMenu=d.GridContextMenu;exports.contextMenuItemsMap=d.contextMenuItemsMap;exports.GridContextMenuAnchorPart=a.GridContextMenuAnchorPart;exports.GridContextMenuItemNames=a.GridContextMenuItemNames;exports.GridSearchBox=H.GridSearchBox;exports.GridPdfExportButton=W.GridPdfExportButton;