Grids AI Assistant: Add (Update) API Descriptions Part 3

api-reference/10 UI Components/dxDataGrid/9 Types/DataGridPredefinedCommands/DataGridPredefinedCommands.md

@@ -31,7 +31,7 @@ The following code snippet lists available commands with their arguments:
         width: number | string;
     };
     filterValue: {
-        expression: FilterExprObj | null;
+        expression: FilterExprTree | null;
     };
     clearFilter: {};
     focusRowByKey: {

api-reference/40 Common Types/15 grids/BasicFilterExprObj/BasicFilterExprObj.md → api-reference/40 Common Types/15 grids/BasicFilterExpr/BasicFilterExpr.md

@@ -1,7 +1,7 @@
 ---
-id: BasicFilterExprObj
+id: BasicFilterExpr
 module: common/grids
-export: BasicFilterExprObj
+export: BasicFilterExpr
 type: Object
 ---
 ---

api-reference/40 Common Types/15 grids/CombinedFilterExprObj/CombinedFilterExprObj.md → api-reference/40 Common Types/15 grids/CombinedFilterExpr/CombinedFilterExpr.md

@@ -1,7 +1,7 @@
 ---
-id: CombinedFilterExprObj
+id: CombinedFilterExpr
 module: common/grids
-export: CombinedFilterExprObj
+export: CombinedFilterExpr
 type: Object
 ---
 ---
@@ -12,6 +12,6 @@ A combined DataGrid/TreeList filter expression.
 This object includes the following fields:
 
 - **type**: The expression type. Set to *"combined"*.
-- **left**: The first filter expression.
+- **leftId**: The ID of the first filter expression's node ([FilterExprNode]({basewidgetpath}/FilterExprNode/)).
 - **combiner**: The combination operation. Accepted values: *"and"*, *"or"*.
-- **right**: The second filter expression.
+- **rightId**: The ID of the second filter expression's node ([FilterExprNode]({basewidgetpath}/FilterExprNode/)).

api-reference/40 Common Types/15 grids/FilterExpr/FilterExpr.md

@@ -0,0 +1,16 @@
+---
+id: FilterExpr
+module: common/grids
+export: FilterExpr
+type: BasicFilterExpr | CombinedFilterExpr | NegatedFilterExpr
+---
+---
+##### shortDescription
+A DataGrid/TreeList filter expression.
+
+---
+**FilterExpr** is a union of multiple types whose structure depends on the represented filter expression. For additional information, see the following topics:
+
+- [BasicFilterExpr](/api-reference/40%20Common%20Types/15%20grids/BasicFilterExpr '{basewidgetpath}/BasicFilterExpr/')
+- [CombinedFilterExpr](/api-reference/40%20Common%20Types/15%20grids/CombinedFilterExpr '{basewidgetpath}/CombinedFilterExpr/')
+- [NegatedFilterExpr](/api-reference/40%20Common%20Types/15%20grids/NegatedFilterExpr '{basewidgetpath}/NegatedFilterExpr/')

api-reference/40 Common Types/15 grids/FilterExprNode/FilterExprNode.md

@@ -0,0 +1,14 @@
+---
+id: FilterExprNode
+module: common/grids
+export: FilterExprNode
+---
+---
+##### shortDescription
+A node in a filter expression tree ([FilterExprTree]({basewidgetpath}/FilterExprTree/)).
+
+---
+This object includes the following fields:
+
+- **id**: A unique identifier for the node. Nodes reference each other by ID.
+- **expr**: The filter expression ([FilterExpr]({basewidgetpath}/FilterExpr/)).

api-reference/40 Common Types/15 grids/FilterExprTree/FilterExprTree.md

@@ -0,0 +1,16 @@
+---
+id: FilterExprTree
+module: common/grids
+export: FilterExprTree
+---
+---
+##### shortDescription
+A complex filter expression in a flat data structure.
+
+---
+**FilterExprTree** stores a filter expression tree as a flat list rather than a hierarchical structure. This flat structure improves compatibility with AI services for the AI Assistant's `filterValue` command.
+
+This object includes the following fields:
+
+- **rootId**: The ID of the root [FilterExprNode]({basewidgetpath}/FilterExprNode/). This node is evaluated first. **rootId** must match the **id** value of an object in the **nodes** array.
+- **nodes**: An array of [FilterExprNode]({basewidgetpath}/FilterExprNode/) objects. Each node must have a unique **id**.

api-reference/40 Common Types/15 grids/NegatedFilterExprObj/NegatedFilterExprObj.md → api-reference/40 Common Types/15 grids/NegatedFilterExpr/NegatedFilterExpr.md

@@ -1,7 +1,7 @@
 ---
-id: NegatedFilterExprObj
+id: NegatedFilterExpr
 module: common/grids
-export: NegatedFilterExprObj
+export: NegatedFilterExpr
 type: Object
 ---
 ---
@@ -12,4 +12,4 @@ A negated ([unary NOT](/concepts/70%20Data%20Binding/5%20Data%20Layer/2%20Readin
 This object includes the following fields:
 
 - **type**: The expression type. Set to *"negated"*.
-- **expression**: A filter expression ([FilterExprObj](/api-reference/40%20Common%20Types/15%20grids/FilterExprObj '{basewidgetpath}/FilterExprObj/')) to negate.
+- **expressionId**: The ID of a filter expression node ([FilterExprNode]({basewidgetpath}/FilterExprNode/)) to negate.

api-reference/40 Common Types/15 grids/PredefinedCommands/PredefinedCommands.md

@@ -30,7 +30,7 @@ The following code snippet lists available commands with their arguments:
         width: number | string;
     };
     filterValue: {
-        expression: FilterExprObj | null;
+        expression: FilterExprTree | null;
     };
     clearFilter: {};
     focusRowByKey: {