@creatio/base 0.830.0 → 0.832.0

package/index.d.ts

@@ -10,6 +10,14 @@ declare interface BaseDataSourceFunctionConfig {
     type: ɵFunctionStringType;
 }
 
+export declare interface DataSourceHierarchyConfig {
+    hierarchicalMaxDepth?: number;
+    hierarchicalColumnName: string;
+    hierarchicalColumnValue?: string;
+    hierarchicalFullDataLoad?: boolean;
+    hierarchicalColumnFiltersValue?: ɵFilterGroup;
+}
+
 /**
  * @public
  * @description SysAdminUnitInRole source type.
@@ -49,6 +57,75 @@ export declare enum eAdminUnitRoleSources {
     All = 63
 }
 
+/**
+ * @generativeApi
+ * @description Combined type for all ESQ expressions.If you plan to create a new expression, please add it to this type
+ * */
+declare type IESQExpression = ɵBaseExpression | ɵArithmeticExpression | ɵColumnExpression | ɵParameterExpression | ɵAggregationFunctionExpression | ɵArgumentFunctionExpression | ɵDatePartFunctionExpression | ɵLengthFunctionExpression | ɵMacrosFunctionExpression | ɵWindowFunctionExpression;
+
+/**
+ * @generativeApi
+ * @description Combined type for all ESQ filters. If you plan to create a new filter, please add it to this type.
+ * */
+export declare type IESQFilter = ɵBaseFilter | ɵBetweenFilter | ɵCompareFilter | ɵExistsFilter | IFilterGroup | ɵInFilter | ɵIsNullFilter | ɵSingleFilter;
+
+/**
+ * @public
+ * this interface is created, because JSON schema generation does not support getters
+ * @generativeApi
+ * @description Group of filters. Usually one, or several filters, combined with a logical operation (And, Or).
+ * Groups of filters can be nested into each other,
+ * i.e. The collection itself can be an element of another collection.
+ * @extends {ɵBaseFilter}
+ */
+export declare type IFilterGroup = ɵBaseFilter & {
+    /**
+     * @description Type of filter. 6 means that this is a filter group.
+     * @default 6
+     */
+    readonly filterType: ɵFilterType.FilterGroup;
+    /**
+     * @description Returns collection of child filters or filter groups.
+     * Each item is a key-value pair,
+     * where the key is autogenerated or user-defined name, and value - filter or a filter group
+     */
+    items: Record<string, IESQFilter>;
+    /**
+     * @description The type of the logical operation for a combination of filters in this filter group.
+     */
+    logicalOperation: ɵLogicalOperatorType;
+    /**
+     * @description Root entity schema name or table name.
+     */
+    rootSchemaName?: string;
+};
+
+/**
+ * @public
+ * @generativeApi
+ * @description Parameter object reference. Defines the value and type of the parameter.
+ * dateValue property exists only if dataValueType is 7.
+ */
+export declare interface IParameterDefinition<TDataValueType extends ɵDataValueType = ɵDataValueType> {
+    /**
+     * @description type of the parameter value.
+     * */
+    dataValueType: TDataValueType;
+    /**
+     * @description exists only if dataValueType is 7. Contains the ISO 8601 date string.
+     * */
+    dateValue?: TDataValueType extends ɵDataValueType.DateTime ? `${string}T${string}Z` : never;
+    /**
+     * @description defines the value of the parameter.
+     * If dataValueType is 7. Contains the ISO 8601 date string. but wrapped in escaped string.
+     * E.g.: `\"2023-01-01T00:00:00.000Z\"`, otherwise it is the value of the parameter.
+     * If dataValueType is 10, then value is ɵLookupValue.
+     * value cannot be an array
+     * */
+    value?: TDataValueType extends ɵDataValueType.DateTime ? string : ɵEntityColumnValue;
+    arrayValue?: string[];
+}
+
 /* Excluded from this release type: LookupMode */
 
 /* Excluded from this release type: UsedColumn */
@@ -67,7 +144,10 @@ export declare type ɵAggregationEval = 'all' | 'distinct' | 'none';
 
 /**
  * @public
- * @description Scope of the aggregation function.
+ * @generativeApi
+ * @description Defines the scope or evaluation mode for aggregation functions.
+ * 0 - None (No specific scope defined), 1 - All (Includes all values including duplicates),
+ * 2 - Distinct (Only unique values, eliminates duplicates)
  */
 export declare enum ɵAggregationEvalType {
     /**
@@ -121,15 +201,16 @@ export declare enum ɵAggregationFunction {
 
 /**
  * @public
- * @classdesc Class contains info about column with aggregation function.
+ * @description Class contains info about column with aggregation function.
  * @extends {ɵBaseQueryColumn}
  */
 export declare class ɵAggregationFunctionColumn extends ɵBaseQueryColumn<ɵAggregationFunctionExpression> {
-    constructor(aggregationType: ɵAggregationType, aggregationEvalType: ɵAggregationEvalType, functionArgument: ɵBaseExpression);
+    constructor(aggregationType: ɵAggregationType, aggregationEvalType: ɵAggregationEvalType, functionArgument: ɵColumnExpression);
 }
 
 /**
  * @public
+ * @generativeApi
  * @description A class that describes expression with aggregate function.
  * @extends {ɵArgumentFunctionExpression}
  */
@@ -207,7 +288,15 @@ export declare type ɵAggregationSubQueryExpressionConfig = ɵSubQueryExpression
 
 /**
  * @public
- * The type of the aggregation (can be set to None).
+ * @generativeApi
+ * @description The type of aggregation function used in queries and data operations.
+ * 0 - None (No aggregation),
+ * 1 - Count (Count records - can be used with any column type),
+ * 2 - Sum (Total of values - numeric columns only),
+ * 3 - Avg (Average value - numeric columns only),
+ * 4 - Min (Minimum value - numeric and date columns),
+ * 5 - Max (Maximum value - numeric and date columns),
+ * 6 - TopOne (First record - any column type)
  */
 export declare enum ɵAggregationType {
     /**
@@ -252,6 +341,7 @@ export declare class ɵArgumentEmptyException extends Error {
 /**
  * @public
  * @abstract
+ * @generativeApi
  * @description A class that describes a functional expression with argument.
  * @extends {ɵFunctionExpression}
  */
@@ -261,7 +351,7 @@ export declare abstract class ɵArgumentFunctionExpression extends ɵFunctionExp
     /**
      * @description Expression argument.
      */
-    readonly functionArgument: ɵBaseExpression;
+    readonly functionArgument: IESQExpression;
     protected constructor(config: ɵArgumentFunctionExpressionConfig<ɵArgumentFunctionExpression>);
     /**
      * @public
@@ -290,6 +380,7 @@ export declare class ɵArgumentOutOfRangeException extends Error {
 
 /**
  * @public
+ * @genearativeApi
  * @description Arithmetic expression.
  * @extends {ɵBaseExpression}
  */
@@ -307,11 +398,11 @@ export declare class ɵArithmeticExpression extends ɵBaseExpression {
     /**
      * @description Left operand expression.
      */
-    readonly leftArithmeticOperand: ɵBaseExpression;
+    readonly leftArithmeticOperand: IESQExpression;
     /**
      * @description Right operand expression.
      */
-    readonly rightArithmeticOperand: ɵBaseExpression;
+    readonly rightArithmeticOperand: IESQExpression;
     constructor(config: ɵArithmeticExpressionConfig);
     /**
      * Parses expression from json.
@@ -334,7 +425,10 @@ export declare type ɵArithmeticExpressionConfig = ɵExpressionConfig<ɵArithmet
 
 /**
  * @public
- * @description Arithmetic operation.
+ * @generativeApi
+ * @description Represents arithmetic operations that can be performed in queries and expressions.
+ * 0 - Addition (Adds values), 1 - Subtraction (Subtracts values),
+ * 2 - Multiplication (Multiplies values), 3 - Division (Divides values)
  */
 export declare enum ɵArithmeticOperation {
     /**
@@ -446,6 +540,7 @@ export declare interface ɵBaseDialogService<TConfig extends ɵBaseDialogConfig
 
 /**
  * @public
+ * @generativeApi
  * @abstract
  * @description The base class of the expression.
  * @extends {ɵSerializable}
@@ -455,8 +550,9 @@ export declare abstract class ɵBaseExpression implements ɵSerializable {
     /* Excluded from this release type: _instanceOfKeys */
     /**
      * @description True if expression has brackets.
+     * @default false
      */
-    readonly isBlock: boolean;
+    readonly isBlock?: boolean;
     /**
      * @public
      * @description Method for checking if an instance is of the current class type.
@@ -509,7 +605,8 @@ export declare class ɵBaseExpressionParser {
 /**
  * @public
  * @abstract
- * @description The base class of the filter.
+ * @generativeApi
+ * @description Base class for all filters in the system.
  * @extends {ɵSerializable}
  */
 export declare abstract class ɵBaseFilter implements ɵSerializable {
@@ -521,12 +618,14 @@ export declare abstract class ɵBaseFilter implements ɵSerializable {
     readonly filterType: ɵFilterType;
     /**
      * @description Indicates that the filter is active and will be taken into account when building the query.
+     * @default true
      */
     isEnabled: boolean;
     /**
-     * @description Drop the time for the date / time type parameters.
+     * @description Drop the time for the date / time type parameters. In FilterGroup this option is not supported.
+     * @default false
      */
-    trimDateTimeParameterToDate: boolean;
+    trimDateTimeParameterToDate?: boolean;
     /**
      * @public
      * @description Method for checking if an instance is of the current class type.
@@ -705,6 +804,9 @@ export declare interface ɵBaseModel<TLoadOptions extends ɵDataSourceLoadOption
 export declare abstract class ɵBaseQuery implements ɵMetadataProvider<Record<string, unknown>> {
     readonly operationType: ɵQueryOperationType;
     readonly rootSchemaName: string;
+    queryId?: string;
+    /* Excluded from this release type: _queryDtoType */
+    get queryDtoType(): string;
     protected constructor(operationType: ɵQueryOperationType, rootSchemaName: string);
     /** {@inheritDoc ɵMetadataProvider.getMetadata} */
     getMetadata(): Record<string, unknown>;
@@ -713,6 +815,7 @@ export declare abstract class ɵBaseQuery implements ɵMetadataProvider<Record<s
 /**
  * @public
  * @abstract
+ * @generativeApi
  * @classdesc Class contains info about column for query.
  */
 export declare abstract class ɵBaseQueryColumn<TExpression extends ɵBaseExpression = ɵBaseExpression> {
@@ -759,6 +862,7 @@ export declare abstract class ɵBaseQueryColumn<TExpression extends ɵBaseExpres
      */
     withCaption(caption: string): this;
     /* Excluded from this release type: _getUsedColumns */
+    /* Excluded from this release type: toJson */
 }
 
 /**
@@ -806,21 +910,29 @@ export declare interface ɵBaseSysSettingsService {
 
 /**
  * @public
+ * generativeApi
  * @description Filter class of the "Between" type.
+ * It contains RightLessExpression and RightGreaterExpression,
+ * which represent the boundaries of values for filtering.
  * @extends {ɵSingleFilter}
  */
 export declare class ɵBetweenFilter extends ɵSingleFilter {
+    /**
+     * @description Type of filter.
+     * @default 3
+     * */
+    readonly filterType: 3;
     /* Excluded from this release type: _instanceOfKey */
     /* Excluded from this release type: _instanceOfKeys */
     /**
      * @description The initial expression of the filtering range.
      */
-    readonly rightLessExpression: ɵBaseExpression;
+    readonly rightLessExpression: IESQExpression;
     /**
      * @description The final expression of the filtering range.
      */
-    readonly rightGreaterExpression: ɵBaseExpression;
-    constructor(leftExpression: ɵBaseExpression, rightLessExpression: ɵBaseExpression, rightGreaterExpression: ɵBaseExpression);
+    readonly rightGreaterExpression: IESQExpression;
+    constructor(leftExpression: IESQExpression, rightLessExpression: IESQExpression, rightGreaterExpression: IESQExpression);
     /**
      * Parses filter from json.
      * @public
@@ -839,6 +951,7 @@ export declare type ɵButtonColor = 'primary' | 'accent' | 'warn' | 'default';
 
 /**
  * @public
+ * @generativeApi
  * @description A class that defines an expression of type column EntitySchema.
  * @extends {ɵBaseExpression}
  */
@@ -875,17 +988,24 @@ export declare type ɵColumnExpressionConfig = ɵExpressionConfig<ɵColumnExpres
 
 /**
  * @public
- * @description Comparison filter class.
+ * @generativeApi
+ * @description Filter class for comparing two expressions. leftExpression describes column from the schema,
+ * by which the comparison is made, rightExpression describes the value to which the column is compared.
  * @extends {ɵSingleFilter}
  */
 export declare class ɵCompareFilter extends ɵSingleFilter {
+    /**
+     * @description Type of filter.
+     * @default 1
+     */
+    readonly filterType: 1;
     /* Excluded from this release type: _instanceOfKey */
     /* Excluded from this release type: _instanceOfKeys */
     /**
-     * @description Filter expression.
+     * @description Filter expression. Right expression is used to compare values of column from the left expression
      */
-    readonly rightExpression: ɵBaseExpression;
-    constructor(comparisonType: ɵComparisonType, leftExpression: ɵBaseExpression, rightExpression: ɵBaseExpression);
+    readonly rightExpression: IESQExpression;
+    constructor(comparisonType: ɵComparisonType, leftExpression: IESQExpression, rightExpression: IESQExpression);
     /**
      * Parses filter from json.
      * @public
@@ -898,12 +1018,22 @@ export declare class ɵCompareFilter extends ɵSingleFilter {
 
 /**
  * @public
- * @description The type of comparison operation in the filter.
+ * @generativeApi
+ * @description The type of comparison operation used in filters and query conditions.
+ 1 - Is_null (Value is null), 2 - Is_not_null (Value is not null),
+ * 3 - Equal (Value equals), 4 - Not_equal (Value doesn't equal), 5 - Less (Value is less than),
+ * 6 - Less_or_equal (Value is less than or equal), 7 - Greater (Value is greater than),
+ * 8 - Greater_or_equal (Value is greater than or equal), 9 - Start_with (Value starts with string),
+ * 10 - Not_start_with (Value doesn't start with string), 11 - Contain (Value contains string),
+ * 12 - Not_contain (Value doesn't contain string), 13 - End_with (Value ends with string),
+ * 14 - Not_end_with (Value doesn't end with string), 15 - Exists (Value exists),
+ * 16 - Not_exists (Value doesn't exist)
  */
 export declare enum ɵComparisonType {
     /**
      * @public
      * @description Value is between two specified values.
+     * @hidden
      */
     Between = 0,
     /**
@@ -1193,6 +1323,7 @@ export declare interface ɵDataSchemaAttribute {
      */
     isRequired: boolean;
     /* Excluded from this release type: lookupMode */
+    /* Excluded from this release type: useSeconds */
 }
 
 /**
@@ -1285,7 +1416,8 @@ export declare interface ɵDataSchemaAttributeValueMaskingSettings {
 
 /**
  * @public
- * @decription Type of DataSchema. In combination with the name is used for unique identification of {@link ɵDataSchema}.
+ * @description Type of DataSchema.
+ * In combination with the name is used for unique identification of {@link ɵDataSchema}.
  */
 export declare enum ɵDataSchemaType {
     /**
@@ -1533,6 +1665,10 @@ export declare interface ɵDataSourceLoadOptions {
      * @description Sorting options.
      */
     sortingConfig?: ɵDataSourceSortingConfig;
+    /**
+     * @description Hierarchy options.
+     */
+    hierarchyConfig?: DataSourceHierarchyConfig;
 }
 
 /**
@@ -1640,6 +1776,57 @@ export declare interface ɵDataSourceSortingConfig {
 
 /**
  * @public
+ * @generativeApi
+ * @description possible BE value types. Try to keep it same as {@link ɵEntityColumnValue}.
+ * 0 - Global unique identifier.
+ * 1 - String.
+ * 4 - Integer.
+ * 5 - Real number.
+ * 6 - Currency.
+ * 7 - Date and time.
+ * 8 - Date.
+ * 9 - Time.
+ * 10 - Lookup.
+ * 11 - Enumeration.
+ * 12 - Boolean.
+ * 13 - Binary data object.
+ * 14 - The object of image binary data.
+ * 15 - Custom object.
+ * 16 - Image from a lookup.
+ * 17 - Collection of items.
+ * 18 - Color.
+ * 19 - Localized string.
+ * 20 - Object (Entity).
+ * 21 - Collection of objects (EntityCollection).
+ * 22 - List of object column values (EntityColumnMappingCollection).
+ * 23 - Hash string.
+ * 24 - Encrypted string.
+ * 25 - File.
+ * 26 - Mapping.
+ * 27 - Short length text.
+ * 28 - Medium length text.
+ * 29 - Unlimited length text.
+ * 30 - Long length text.
+ * 31 - float1.
+ * 32 - float2.
+ * 33 - float3.
+ * 34 - float4.
+ * 35 - Localizable parameter values list.
+ * 36 - Process not localizable text.
+ * 37 - Stage indicator.
+ * 38 - Serializable list of values.
+ * 39 - Serializable list of composite values.
+ * 40 - float8.
+ * 41 - File.
+ * 42 - Phone.
+ * 43 - Text with formating tags.
+ * 44 - Web link.
+ * 45 - Email.
+ * 46 - Composite object.
+ * 47 - Float0.
+ * 48 - Currency0.
+ * 49 - Currency1.
+ * 50 - Currency3.
  * Types of values.
  */
 export declare enum ɵDataValueType {
@@ -1664,7 +1851,9 @@ export declare enum ɵDataValueType {
      */
     Money = 6,
     /**
-     * @description Date and time.
+     * @description Date and time. if used this type of a value, then value should consist of two parts:
+     * "dateValue": "ISO 8601 date string",
+     * "value": "\"ISO 8601 date string\""
      */
     DateTime = 7,
     /**
@@ -1804,7 +1993,23 @@ export declare enum ɵDataValueType {
      * @description Email.
      */
     EMAIL_TEXT = 45,
-    COMPOSITE_OBJECT = 46
+    COMPOSITE_OBJECT = 46,
+    /**
+     * @description Float0.
+     */
+    FLOAT0 = 47,
+    /**
+     * @description Currency0.
+     */
+    MONEY0 = 48,
+    /**
+     * @description Currency1.
+     */
+    MONEY1 = 49,
+    /**
+     * @description Currency3.
+     */
+    MONEY3 = 50
 }
 
 /**
@@ -1815,7 +2020,9 @@ export declare type ɵDatePart = 'minute' | 'hour' | 'day' | 'weekday' | 'week'
 
 /**
  * @public
+ * @generativeApi
  * @classdesc Class contains info about column with date part.
+ * @description Class contains info about column with date part.
  * @extends {ɵBaseQueryColumn}
  */
 export declare class ɵDatePartFunctionColumn extends ɵBaseQueryColumn<ɵDatePartFunctionExpression> {
@@ -1828,6 +2035,7 @@ export declare class ɵDatePartFunctionColumn extends ɵBaseQueryColumn<ɵDatePa
 
 /**
  * @public
+ * @gererativeApi
  * @description A class that describes expression part of date function.
  * @extends {ɵArgumentFunctionExpression}
  */
@@ -1860,7 +2068,16 @@ export declare type ɵDatePartFunctionExpressionConfig = ɵArgumentFunctionExpre
 
 /**
  * @public
- * @description Part of the date.
+ * @generativeApi
+ * @description Defines possible parts of the date.
+ * 0 - Empty value.
+ * 1 - Day.
+ * 2 - Week.
+ * 3 - Month.
+ * 4 - Year.
+ * 5 - Day of the week.
+ * 6 - Hour.
+ * 7 - Minute.
  */
 export declare enum ɵDatePartType {
     /**
@@ -1929,6 +2146,7 @@ export declare enum ɵDefaultValueSource {
  * @extends {ɵBaseFilterableQuery}
  */
 export declare class ɵDeleteQuery extends ɵBaseFilterableQuery {
+    /* Excluded from this release type: _queryDtoType */
     constructor(rootSchemaName: string);
 }
 
@@ -1964,12 +2182,14 @@ export declare function ɵencodeDate(date: Date): string;
 
 /**
  * @public
- * @description type of column value.
+ * @generativeApi
+ * @description possible type of column value.
  */
 export declare type ɵEntityColumnValue = boolean | number | string | ɵGuid | Date | ɵLookupValue | null;
 
 /**
  * @public
+ * @generativeApi
  * @classdesc Class contains info about common column from entity.
  * @extends {ɵBaseQueryColumn}
  */
@@ -1984,6 +2204,7 @@ export declare class ɵEntityQueryColumn extends ɵBaseQueryColumn<ɵColumnExpre
  */
 export declare class ɵEntitySchemaQuery extends ɵBaseFilterableQuery {
     private _columns;
+    /* Excluded from this release type: _queryDtoType */
     /**
      * @description Determines if merge duplicates in query result.
      */
@@ -2014,6 +2235,30 @@ export declare class ɵEntitySchemaQuery extends ɵBaseFilterableQuery {
      * @description Bit mask that indicates which role sources will be considered when checking record rights.
      */
     adminUnitRoleSources?: eAdminUnitRoleSources;
+    /**
+     * @description Indicates whether the query is hierarchical.
+     */
+    isHierarchical: boolean;
+    /**
+     * @description Maximum depth of hierarchical data retrieval.
+     */
+    hierarchicalMaxDepth?: number;
+    /**
+     * @description Name of the hierarchical column.
+     */
+    hierarchicalColumnName?: string;
+    /**
+     * @description Value of the hierarchical column.
+     */
+    hierarchicalColumnValue?: string;
+    /**
+     * @description Indicates whether to perform a full data load for hierarchical queries.
+     */
+    hierarchicalFullDataLoad?: boolean;
+    /**
+     * @description Filters applied to hierarchical parent records.
+     */
+    hierarchicalColumnFiltersValue?: ɵFilterGroup | undefined;
     constructor(rootSchemaName: string);
     private _internalAddColumn;
     private _getIsPageable;
@@ -2126,21 +2371,29 @@ export declare class ɵEntitySchemaQuery extends ɵBaseFilterableQuery {
 
 /**
  * @public
+ * @generativeApi
  * @description The comparison filter class [Exists according to the specified condition].
  * @extends {ɵSingleFilter}
  */
 export declare class ɵExistsFilter extends ɵSingleFilter {
+    /**
+     * @description Type of filter.
+     * @default 5
+     */
+    readonly filterType: 5;
     /* Excluded from this release type: _instanceOfKey */
     /* Excluded from this release type: _instanceOfKeys */
     /**
      * @description Subquery filters. Cannot contain filters with other subqueries.
+     * @hidden
      */
     readonly subFilters?: ɵFilterGroup;
     /**
      * @description Indicates that the filter is aggregating.
+     * @default true
      */
     readonly isAggregative: boolean;
-    constructor(leftExpression: ɵBaseExpression, subFilters?: ɵFilterGroup, comparisonType?: ɵComparisonType, isAggregative?: boolean);
+    constructor(leftExpression: IESQExpression, subFilters?: ɵFilterGroup, comparisonType?: ɵComparisonType, isAggregative?: boolean);
     /**
      * Parses filter from json.
      * @public
@@ -2200,7 +2453,11 @@ export declare class ɵExpressionResolver {
 
 /**
  * @public
+ * @generativeApi
  * @description Type of expression.
+ * 0 - SchemaColumn (Reference to a data column), 1 - Function (Function call expression),
+ * 2 - Parameter (Parameter value), 3 - SubQuery (Nested query expression),
+ * 4 - ArithmeticOperation (Mathematical operation)
  */
 export declare enum ɵExpressionType {
     /**
@@ -2231,23 +2488,33 @@ export declare enum ɵExpressionType {
  * i.e. The collection itself can be an element of another collection.
  * @extends {ɵBaseFilter}
  */
-export declare class ɵFilterGroup extends ɵBaseFilter {
+export declare class ɵFilterGroup extends ɵBaseFilter implements IFilterGroup {
+    /**
+     * @description Type of filter.
+     * @default 6
+     */
+    readonly filterType = ɵFilterType.FilterGroup;
     /* Excluded from this release type: _instanceOfKey */
     /* Excluded from this release type: _instanceOfKeys */
     /**
      * @public
+     * @hidden
      * @description Collection of child filters.
      */
     filters: Map<string, ɵBaseFilter>;
     /**
      * @public
-     * @description Return collecion of deserialized filters.
+     * @description Returns collection of child filters or filter groups.
+     * Each item is a key-value pair,
+     * where the key is autogenerated or user-defined name, and value - filter or a filter group
+     * @default {}
      */
     get items(): {
         [key: string]: ɵBaseFilter;
     };
     /**
-     * @description The type of the logical operation for a combination of filters in the collection.
+     * @description The type of the logical operation for a combination of filters in this filter group.
+     * @default 0
      */
     logicalOperation: ɵLogicalOperatorType;
     /**
@@ -2387,6 +2654,12 @@ export declare class ɵFilterResolver {
 /**
  * @public
  * @description The type of filter.
+ * - 0 None, No filter applied.
+ * - 1 Compare, Comparison filter (e.g., equal to, greater than).
+ * - 2 IsNull, Checks if a value is null.
+ * - 4 In, Checks if a value is in a specified set of values.
+ * - 5 Exists, Checks if a value exists.
+ * - 6 FilterGroup, A group of filters combined with logical operators (AND, OR).
  */
 export declare enum ɵFilterType {
     /**
@@ -2407,6 +2680,8 @@ export declare enum ɵFilterType {
     /**
      * @public
      * @description Checks if a value is between two specified values.
+     * should be used with {@link ɵBetweenFilter}
+     * @hidden
      */
     Between = 3,
     /**
@@ -2440,7 +2715,9 @@ export declare interface ɵFiltrationPlatformAPIOptions extends ɵPlatformAPIOpt
 /**
  * @public
  * @abstract
+ * @generativeApi
  * @description A class that describes a functional expression.
+ * Functional expressions are evaluated on BE to produce a value based on the function type.
  * @extends {ɵFunctionExpression}
  */
 export declare abstract class ɵFunctionExpression extends ɵBaseExpression {
@@ -2448,6 +2725,7 @@ export declare abstract class ɵFunctionExpression extends ɵBaseExpression {
     /* Excluded from this release type: _instanceOfKeys */
     /**
      * @description Expression type. Default 'Function'.
+     * @default 1.
      */
     readonly expressionType: ɵExpressionType;
     /**
@@ -2475,7 +2753,13 @@ export declare type ɵFunctionStringType = 'aggregation' | 'datePart' | 'none';
 
 /**
  * @public
- * @description The type of function in the filter.
+ * @generativeApi
+ * @description The type of function in the filter, or in the aggregation function
+ * 0 - None (Function type not defined), 1 - Macros (Substitution by macro),
+ * 2 - Aggregation (Aggregating function), 3 - DatePart (Date fragment),
+ * 4 - Length (Size of value in bytes), 5 - Window (Window query function),
+ * 6 - DateAdd (Date addition), 7 - DateDiff (Date difference).
+ * if used in aggregation function, use 2 by default.
  */
 export declare enum ɵFunctionType {
     /**
@@ -2523,6 +2807,7 @@ export declare function ɵgenerateGuid(): ɵGuid;
 /* Excluded from this release type: ɵgetFilterPlainObj */
 
 /**
+ * @generativeApi
  * @description Type for Guid value.
  * @public
  */
@@ -2530,17 +2815,24 @@ export declare type ɵGuid = string;
 
 /**
  * @public
- * @description In-Filter Class
+ * @generativeApi
+ * @description Filter that checks if the value of {@link #leftExpression} is satisfied
+ * by each of expressions in the array of {@link #rightExpressions}.
  * @extends {ɵSingleFilter}
  */
 export declare class ɵInFilter extends ɵSingleFilter {
+    /**
+     * @description Type of filter. 4 means filter of type "In".
+     * @default 4
+     */
+    readonly filterType: 4;
     /* Excluded from this release type: _instanceOfKey */
     /* Excluded from this release type: _instanceOfKeys */
     /**
      * @description An array of expressions that will be compared with {@link #leftExpression}.
      */
-    readonly rightExpressions: ɵBaseExpression[];
-    constructor(comparisonType: ɵComparisonType, leftExpression: ɵBaseExpression, rightExpressions: ɵBaseExpression[]);
+    readonly rightExpressions: IESQExpression[];
+    constructor(comparisonType: ɵComparisonType, leftExpression: IESQExpression, rightExpressions: IESQExpression[]);
     /**
      * @description Parses in filter from json.
      * @public
@@ -2559,6 +2851,7 @@ export declare class ɵInFilter extends ɵSingleFilter {
  */
 export declare class ɵInsertQuery extends ɵBaseQuery {
     private _columnValues;
+    /* Excluded from this release type: _queryDtoType */
     constructor(rootSchemaName: string);
     /**
      * @description A collection of column values for updating entities.
@@ -2595,17 +2888,27 @@ export declare function ɵisGuid(value: unknown): boolean;
 
 /**
  * @public
- * @description IsNull filter Class
+ * @generativeApi
+ * @description Filter that checks if the value of {@link #leftExpression} equals to null or not.
  * @extends {ɵSingleFilter}
  */
 export declare class ɵIsNullFilter extends ɵSingleFilter {
+    /**
+     * @description Type of filter.
+     * @default 2
+     */
+    readonly filterType: 2;
     /**
      * @description Flag that indicates if expression is empty or not.
      */
     isNull: boolean;
     /* Excluded from this release type: _instanceOfKey */
-    /* Excluded from this release type: _instanceOfKeys */
-    constructor(comparisonType: ɵComparisonType.Is_null | ɵComparisonType.Is_not_null, leftExpression: ɵBaseExpression);
+    /**
+     * @internale
+     * @dontChange
+     */
+    protected static get _instanceOfKeys(): string[];
+    constructor(comparisonType: ɵComparisonType.Is_null | ɵComparisonType.Is_not_null, leftExpression: IESQExpression);
     private static _getComparisonType;
     /**
      * @description Parses isNull filter from json.
@@ -2661,9 +2964,14 @@ export declare type ɵJsonData = string | number | boolean | null | undefined |
 
 /**
  * @public
+ * @generativeApi
+ * @hidden
  * @description JSON object.
  */
 export declare interface ɵJsonObject {
+    /**
+     * @hidden
+     * */
     [key: string]: ɵJsonData;
 }
 
@@ -2678,6 +2986,7 @@ export declare class ɵLengthFunctionColumn extends ɵBaseQueryColumn<ɵLengthFu
 
 /**
  * @public
+ * @generativeApi
  * @description A class that describes expression with length function.
  * @extends {ɵArgumentFunctionExpression}
  */
@@ -2729,7 +3038,9 @@ export declare type ɵLocalizeFn = (key: string) => string;
 
 /**
  * @public
- * @description The type of logical operation.
+ * @generativeApi
+ * @description The type of logical operation used to combine multiple conditions in filters.
+ * 0 - And (All conditions must be true), 1 - Or (At least one condition must be true)
  */
 export declare enum ɵLogicalOperatorType {
     /**
@@ -2744,6 +3055,7 @@ export declare enum ɵLogicalOperatorType {
 
 /**
  * @public
+ * @genearativeApi
  * @description Required shape for lookup.
  * @extends {ɵJsonObject}
  * @property {string} displayValue - Value witch will be displayed in lookup
@@ -2799,6 +3111,7 @@ export declare class ɵMacrosFunctionColumn extends ɵBaseQueryColumn<ɵMacrosFu
 
 /**
  * @public
+ * @generativeApi
  * @description A class that describes expression with macros function.
  * @extends {ɵFunctionExpression}
  */
@@ -2807,6 +3120,7 @@ export declare class ɵMacrosFunctionExpression extends ɵFunctionExpression {
     /* Excluded from this release type: _instanceOfKeys */
     /**
      * @description Function type. Default 'Macros'.
+     * @default 1
      */
     readonly functionType: ɵFunctionType;
     /**
@@ -2815,8 +3129,9 @@ export declare class ɵMacrosFunctionExpression extends ɵFunctionExpression {
     readonly macrosType: ɵQueryMacrosType;
     /**
      * @description Function argument.
+     * it is optional and exists only for some macros functions.
      */
-    readonly functionArgument?: ɵBaseExpression;
+    readonly functionArgument?: IESQExpression;
     constructor(config: ɵMacrosFunctionExpressionConfig);
     /**
      * Parses expression from json.
@@ -3013,7 +3328,9 @@ export declare class ɵNextHandlerAlreadySpecifiedException extends Error {
 
 /**
  * @public
- * @description Sort order (can be set to None).
+ * @generativeApi
+ * @description Specifies the sort direction for query results.
+ * 0 - None (No specific ordering), 1 - Asc (Ascending order, A-Z, 0-9), 2 - Desc (Descending order, Z-A, 9-0)
  */
 export declare enum ɵOrderDirection {
     /**
@@ -3032,7 +3349,9 @@ export declare enum ɵOrderDirection {
 
 /**
  * @public
+ * @generativeApi
  * @description The class that defines the parametric expression.
+ * It means that result of this expression is a parameter value.
  * @extends {ɵBaseExpression}
  */
 export declare class ɵParameterExpression extends ɵBaseExpression {
@@ -3044,20 +3363,21 @@ export declare class ɵParameterExpression extends ɵBaseExpression {
     readonly expressionType: ɵExpressionType;
     /**
      * @description Parameter value.
+     * @hidden
      */
     readonly value: ɵEntityColumnValue;
     /**
      * @description Parameter value type.
+     * @hidden
      */
     readonly dataValueType: ɵDataValueType;
     /**
-     * @description Parameter object reference.
+     * @description Parameter object reference. Defines the value and type of the parameter.
+     * dateValue property exists only if dataValueType === ɵDataValueType.DateTime.
+     * if dataValueType === ɵDataValueType.DateTime, dataValueType will contain the ISO 8601 date string and
+     * value will contain the same date, but wrapped in escaped string. E.g.: "\"2023-01-01T00:00:00.000Z\""
      */
-    readonly parameter: {
-        value?: ɵEntityColumnValue;
-        arrayValue?: string[];
-        dataValueType: ɵDataValueType;
-    };
+    readonly parameter: IParameterDefinition;
     constructor(config: ɵParameterExpressionConfig);
     /**
      * Parses expression from json.
@@ -3140,7 +3460,36 @@ export declare interface ɵPrimaryDisplayFilterDataSourceParameter extends ɵBas
 
 /**
  * @public
- * @description The type of macros.
+ * @generativeApi
+ * @description Defines the types of macros that can be used in queries.
+ * 0 - None (No macro), 1 - CurrentUser (Current user ID), 2 - CurrentUserContact (User's contact),
+ * 3 - Yesterday (Previous day), 4 - Today (Current day), 5 - Tomorrow (Next day),
+ * 6 - PreviousWeek (Last week), 7 - CurrentWeek (This week), 8 - NextWeek (Coming week),
+ * 9 - PreviousMonth (Last month), 10 - CurrentMonth (This month), 11 - NextMonth (Coming month)
+ * 12 - Previous quarter.
+ * 13 - Current quarter.
+ * 14 - Next quarter.
+ * 15 - Previous half of the year.
+ * 16 - Current half-year.
+ * 17 - Next half-year.
+ * 18 - Last year.
+ * 19 - This year.
+ * 20 - Previous hour.
+ * 21 - Current hour.
+ * 22 - Next hour.
+ * 23 - Next year.
+ * 24 - Next N Days.
+ * 25 - Previous N days.
+ * 26 - Next N hours.
+ * 27 - Previous N hours.
+ * 34 - Primary column.
+ * 35 - Primary displayed column.
+ * 36 - Primary image display column.
+ * 37 - Anniversary today.
+ * 38 - Anniversary on the date computed as today plus days offset.
+ * 39 - Anniversary on the next several days.
+ * 40 - Anniversary on the previous several days.
+ * 41 - Primary color display column.
  */
 export declare enum ɵQueryMacrosType {
     /**
@@ -3417,6 +3766,7 @@ export declare interface ɵSerializable {
 
 /**
  * @public
+ * @generativeApi
  * @description Basic filter class with one condition.
  * @extends {ɵBaseFilter}
  */
@@ -3425,13 +3775,20 @@ export declare abstract class ɵSingleFilter extends ɵBaseFilter {
     /* Excluded from this release type: _instanceOfKeys */
     /**
      * @description Type of comparison operation.
+     * this comparison type defines how the {@link #leftExpression} will be compared
+     * with the value of the right expression.
      */
     readonly comparisonType: ɵComparisonType;
     /**
-     * @description The test expression.
+     * @description expression that contains the value to be compared with the right expressions.
+     */
+    readonly leftExpression: IESQExpression;
+    /**
+     * @description name of the entity schema, connected to the root schema of the filter.
+     * Used, when one of the expressions uses a column from another schema.
      */
-    readonly leftExpression: ɵBaseExpression;
-    protected constructor(filterType: ɵFilterType, comparisonType: ɵComparisonType, leftExpression: ɵBaseExpression);
+    readonly referenceSchemaName?: string;
+    protected constructor(filterType: ɵFilterType, comparisonType: ɵComparisonType, leftExpression: IESQExpression);
     /** {@inheritDoc ɵSerializable.toJson} */
     toJson(): ɵJsonObject;
     /* Excluded from this release type: _getUsedColumns */
@@ -3576,6 +3933,7 @@ export declare type ɵType<T = any> = new (...args: any[]) => T;
  */
 export declare class ɵUpdateQuery extends ɵBaseFilterableQuery {
     private _columnValues;
+    /* Excluded from this release type: _queryDtoType */
     /**
      * @description Flag that indicates whether to force save data.
      */
@@ -3675,6 +4033,7 @@ export declare class ɵWindowFunctionColumn extends ɵBaseQueryColumn<ɵWindowFu
 
 /**
  * @public
+ * @generativeApi
  * @description A class that describes expression with window function.
  * @extends {ɵArgumentFunctionExpression}
  */