@progress/kendo-angular-treelist 19.1.2-develop.4 → 19.1.2-develop.5

package/columns/checkbox-column.component.d.ts

@@ -7,20 +7,32 @@ import { ColumnBase } from './column-base';
 import { CellTemplateDirective } from '../rendering/cell-template.directive';
 import * as i0 from "@angular/core";
 /**
- * Represents the checkbox for selecting rows in the TreeList. [See example](slug:treelist_row_selection#toc-select-all-checkbox).
+ * Represents the checkbox column for selecting rows in the TreeList. [See example](slug:treelist_row_selection#toc-select-all-checkbox).
+ *
+ * @example
+ * ```html
+ * <kendo-treelist ...>
+ *   <kendo-treelist-checkbox-column
+ *     [showSelectAll]="true"
+ *     [checkChildren]="true"
+ *     [expandable]="true">
+ *   </kendo-treelist-checkbox-column>
+ *   <kendo-treelist-column field="ProductName" title="Product Name"></kendo-treelist-column>
+ * </kendo-treelist>
+ * ```
  */
 export declare class CheckboxColumnComponent extends ColumnBase {
     parent?: ColumnBase;
     /**
-     * Determines whether a select-all checkbox will be displayed in the header.
+     * Specifies if a select-all checkbox appears in the header.
      */
     showSelectAll: boolean;
     /**
-     * Determines whether checkbox click should select / unselect all children
+     * Specifies if clicking the checkbox selects or deselects all children.
      */
     checkChildren: boolean;
     /**
-     * Defines whether the expanded indicator should be rendered in the column.
+     * Specifies if the expanded indicator appears in the column.
      * @default false
      */
     expandable: boolean;

package/columns/column-base.d.ts

@@ -21,7 +21,7 @@ export declare const isCheckboxColumn: (column: any) => any;
  */
 export declare const isRowReorderColumn: (column: any) => any;
 /**
- * The base class for the column components of the TreeList.
+ * Serves as the base class for column components in the TreeList.
  */
 export declare class ColumnBase implements OnChanges {
     parent?: ColumnBase;
@@ -64,26 +64,25 @@ export declare class ColumnBase implements OnChanges {
      */
     reorderable: boolean;
     /**
-     * The width (in pixels) below which the user is not able to resize the column by using the UI.
+     * Sets the minimum width (in pixels) for resizing the column using the UI.
      * @default 10
      */
     minResizableWidth: number;
     /**
-     * The title of the column.
+     * Sets the title of the column.
      */
     title: string;
     /**
-     * The width of the column (in pixels).
+     * Sets the width of the column (in pixels).
      */
     set width(value: number);
     get width(): number;
     /**
-     * Indicates whether the column will be resized during initialization so that it fits its header and row content.
+     * Indicates whether the column is automatically resized during initialization to fit its header and row content.
      */
     autoSize: boolean;
     /**
      * Toggles the locked (frozen) state of the columns ([more information and example](slug:locked_columns_treelist)).
-     *
      * @default false
      */
     set locked(value: boolean);
@@ -91,12 +90,11 @@ export declare class ColumnBase implements OnChanges {
     protected _locked: boolean;
     /**
      * Sets the visibility of the column ([see example](slug:hidden_columns_treelist#toc-using-the-built-in-options)).
-     *
      * @default false
      */
     hidden: boolean;
     /**
-     * Sets the condition that needs to be satisfied for a column to remain visible ([see example](slug:responsive_treelist#toc-columns)).
+     * Sets the condition that must be satisfied for a column to remain visible ([see example](slug:responsive_treelist#toc-columns)).
      * If you set the `hidden` property, the behavior of `media` is overridden.
      */
     media: string;
@@ -106,57 +104,46 @@ export declare class ColumnBase implements OnChanges {
      */
     lockable: boolean;
     /**
-     * Specifies if the column menu will be shown for the column.
+     * Specifies if the column menu is shown for the column.
      * @default true
      */
     columnMenu: boolean;
     /**
-     * Specifies if the column will be included in the column-chooser list.
+     * Specifies if the column is included in the column-chooser list.
      * @default true
      */
     includeInChooser: boolean;
     /**
-     * Allows setting the `role` attribute for the table cells (excluding the footer and header ones) of the column.
+     * Sets the `role` attribute for the table cells (excluding the footer and header) of the column.
      * @default "gridcell"
      */
     tableCellsRole: string;
     /**
-     * Sets the custom styles for the table cells (excluding the footer and header ones) of the column. Under the hood,
-     * to apply the property, the `style` option uses the
-     * [NgStyle](link:site.data.urls.angular['ngstyleapi']) directive. [See example](slug:styling_treelist_columns).
+     * Sets custom styles for the table cells (excluding the footer and header) of the column. Uses the [`NgStyle`](link:site.data.urls.angular['ngstyleapi']) directive. [See example](slug:styling_treelist_columns).
      */
     style: {
         [key: string]: string;
     };
     /**
-     * Sets the custom styles for the header cell of the column. Under the hood, to apply the property,
-     * the `headerStyle` option uses the
-     * [NgStyle](link:site.data.urls.angular['ngstyleapi']) directive. [See example](slug:styling_treelist_columns).
+     * Sets custom styles for the header cell of the column. Uses the [`NgStyle`](link:site.data.urls.angular['ngstyleapi']) directive. [See example.](slug:styling_treelist_columns)
      */
     headerStyle: {
         [key: string]: string;
     };
     /**
-     * Sets the custom styles for the footer cell of the column. Under the hood, to apply the property,
-     * the `footerStyle` option uses the
-     * [NgStyle](link:site.data.urls.angular['ngstyleapi']) directive. [See example](slug:styling_treelist_columns).
+     * Sets custom styles for the footer cell of the column. Uses the [`NgStyle`](link:site.data.urls.angular['ngstyleapi']) directive. [See example.](slug:styling_treelist_columns)
      */
     footerStyle: {
         [key: string]: string;
     };
     /**
-     * Sets the custom CSS classes to the column cells. Under the hood, to apply the property, the `class` option uses the
-     * [NgClass](link:site.data.urls.angular['ngclassapi']) directive.
-     * To customize header and footer column cells, use the [`headerClass`]({% slug api_treelist_columncomponent %}#toc-headerclass)
-     * and [`footerClass`]({% slug api_treelist_columncomponent %}#toc-footerclass) inputs.
+     * Sets custom CSS classes to the column cells. Uses the [`NgClass`](link:site.data.urls.angular['ngclassapi']) directive. To customize header and footer column cells, use the [`headerClass`]({% slug api_treelist_columncomponent %}#toc-headerclass) and [`footerClass`]({% slug api_treelist_columncomponent %}#toc-footerclass) inputs.
      */
     cssClass: string | string[] | Set<string> | {
         [key: string]: any;
     };
     /**
-     * Sets the custom CSS classes to the column header cell. Under the hood, to apply the property,
-     * the `headerClass` option uses the
-     * [NgClass](link:site.data.urls.angular['ngclassapi']) directive. [See example](slug:styling_treelist_columns).
+     * Sets custom CSS classes to the column header cell. Uses the [`NgClass`](link:site.data.urls.angular['ngclassapi']) directive. [See example](slug:styling_treelist_columns).
      */
     headerClass: string | string[] | Set<string> | {
         [key: string]: any;
@@ -164,7 +151,7 @@ export declare class ColumnBase implements OnChanges {
     /**
      * Sets the custom CSS classes to the column footer cell. Under the hood, to apply the property,
      * the `footerClass` option uses the
-     * [NgClass](link:site.data.urls.angular['ngclassapi']) directive. [See example](slug:styling_treelist_columns).
+     * [`NgClass`](link:site.data.urls.angular['ngclassapi']) directive. [See example](slug:styling_treelist_columns).
      */
     footerClass: string | string[] | Set<string> | {
         [key: string]: any;

package/columns/column-group.component.d.ts

@@ -11,8 +11,7 @@ import * as i0 from "@angular/core";
  */
 export declare function isColumnGroupComponent(column: any): column is ColumnGroupComponent;
 /**
- * Represents the column group header of the TreeList
- * ([more information and examples]({% slug multicolumnheaders_columns_treelist %})).
+ * Represents the column group header of the TreeList. ([More information and examples]({% slug multicolumnheaders_columns_treelist %})).
  *
  * @example
  * ```html

package/columns/column.component.d.ts

@@ -16,58 +16,62 @@ import * as i0 from "@angular/core";
  */
 export declare function isColumnComponent(column: any): column is ColumnComponent;
 /**
- * Represents the columns of the TreeList.
+ * Represents a column in the TreeList. Use this component to define a data-bound column.
  *
  * @example
  * ```html
  * <kendo-treelist [kendoTreeListFlatBinding]="data" ...>
  *   <kendo-treelist-column field="name" title="Name"></kendo-treelist-column>
- *   <kendo-treelist-column field="title"title="Title"></kendo-treelist-column>
+ *   <kendo-treelist-column field="title" title="Title"></kendo-treelist-column>
  * </kendo-treelist>
  * ```
+ * @remarks
+ * Supported children components are:
+ * {@link StringFilterCellComponent},
+ * {@link NumericFilterCellComponent},
+ * {@link BooleanFilterCellComponent},
+ * {@link DateFilterCellComponent},
+ * {@link StringFilterMenuComponent},
+ * {@link NumericFilterMenuComponent},
+ * {@link BooleanFilterMenuComponent},
+ * {@link DateFilterMenuComponent},
+ * {@link FilterCellOperatorsComponent}.
  */
 export declare class ColumnComponent extends ColumnBase {
     /**
-     * Defines whether the expanded indicator should be rendered in the column.
-     * @default false
+     * Specifies if the expanded indicator appears in the column.
      */
     expandable: boolean;
     /**
-     * The field to which the column is bound.
+     * Sets the field to which the column is bound.
      */
     field: string;
     /**
-     * The format that is applied to the value before it is displayed. For more information on the supported date and number formats,
-     * refer to the [Column Formats](slug:formats_columns_treelist) documentation article.
+     * Sets the format applied to the value before display. For supported date and number formats, see the [Column Formats](slug:formats_columns_treelist) article.
      */
     format: any;
     /**
-     * Allows the column headers to be clicked and the `sortChange` event emitted.
-     * You have to handle the `sortChange` event yourself and sort the data.
+     * Allows the column headers to be clicked and the `sortChange` event emitted. You must handle the `sortChange` event and sort the data.
+     * @default true
      */
     sortable: boolean | ColumnSortSettings;
     /**
-     * Defines the editor type ([see example]({% slug editing_reactive_forms_treelist %}#toc-setup)).
-     * Used when the column enters the edit mode. [See example](slug:editing_reactive_forms_treelist).
-     *
+     * Sets the editor type ([see example]({% slug editing_reactive_forms_treelist %}#toc-setup)). Used when the column enters edit mode. [See example](slug:editing_reactive_forms_treelist).
      * @default 'text'
      */
     editor: 'text' | 'numeric' | 'date' | 'boolean';
     /**
-     * Defines the filter type that is displayed inside the filter row.
-     *
+     * Sets the filter type displayed inside the filter row.
      * @default 'text'
      */
     filter: 'text' | 'numeric' | 'boolean' | 'date';
     /**
-     * Defines if a filter UI will be displayed for this column.
-     *
+     * Specifies if a filter UI appears for this column.
      * @default true
      */
     filterable: boolean;
     /**
-     * Defines whether the column is editable.
-     *
+     * Specifies if the column is editable.
      * @default true
      */
     editable: boolean;

package/columns/command-column.component.d.ts

@@ -8,9 +8,8 @@ import { CellTemplateDirective } from '../rendering/cell-template.directive';
 import { OptionChangesService } from '../common/option-changes.service';
 import * as i0 from "@angular/core";
 /**
- * Represents the command columns of the TreeList. You have to define the content of the
- * column inside an `<ng-template>` tag. For more information and examples on using the passed fields
- * and the command directives, refer to the article on
+ * Represents the command column of the TreeList. Define the content of the column inside an `<ng-template>` tag.
+ * For more information and examples on using the passed fields and command directives, see
  * [editing the TreeList in Angular Reactive Forms]({% slug editing_reactive_forms_treelist %}).
  *
  * Usually, the template contains CRUD command directives such as:
@@ -23,7 +22,7 @@ import * as i0 from "@angular/core";
  * ```html
  * <kendo-treelist ...>
  *   <kendo-treelist-column field="ProductID"></kendo-treelist-column>
- *   <kendo-treelist-command-column title="command" >
+ *   <kendo-treelist-command-column title="command">
  *      <ng-template kendoTreeListCellTemplate>
  *         <button kendoTreeListEditCommand class="k-primary">Edit</button>
  *         <button kendoTreeListRemoveCommand>Remove</button>

package/columns/rowreorder-column.component.d.ts

@@ -5,7 +5,15 @@
 import { ColumnBase } from './column-base';
 import * as i0 from "@angular/core";
 /**
- * Represents the drag handle for reordering rows in the TreeList.
+ * Represents the drag handle column for reordering rows in the TreeList.
+ *
+ * @example
+ * ```html
+ * <kendo-treelist [data]="data" [fetchChildren]="fetchChildren" [hasChildren]="hasChildren">
+ *   <kendo-treelist-rowreorder-column></kendo-treelist-rowreorder-column>
+ *   <kendo-treelist-column field="ProductName" title="Product Name"></kendo-treelist-column>
+ * </kendo-treelist>
+ * ```
  */
 export declare class RowReorderColumnComponent extends ColumnBase {
     parent?: ColumnBase;

package/columns/sort-settings.d.ts

@@ -3,7 +3,8 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Defines the settings for sorting the TreeList column.
+ * Defines the settings for sorting a TreeList column.
+ * Use this type to configure sorting options such as allowing unsort and setting the initial direction.
  *
  * @example
  * ```html
@@ -19,41 +20,22 @@ export type ColumnSortSettings = boolean | {
      */
     allowUnsort?: boolean;
     /**
-     * Determines the initial (from the unsorted to the sorted state) sort direction.
-     *
-     * The available values for setting the initial sort direction are:
-     * - `asc` (default)
-     * - `desc`
+     * Sets the initial sort direction when changing from unsorted to sorted state.
      */
     initialDirection?: 'asc' | 'desc';
 };
 /**
- * Specifies a modifier key when multiple sort.
+ * Specifies a modifier key for multiple column sorting.
  *
- * @example
- * ```html
- * <kendo-treelist [sortable]="{ mode: 'multiple', multiSortKey: 'shift' }">
- *   <kendo-treelist-column field="ProductID"></kendo-treelist-column>
- *   ...
- * </kendo-treelist>
- * ```
  */
 export type ModifierKey = 'none' | 'ctrl' | 'shift' | 'alt';
 /**
  * Defines the settings for sorting the TreeList.
- *
- * @example
- * ```html
- * <kendo-treelist [sortable]="{ mode: 'multiple', allowUnsort: false}"></kendo-treelist>
- * ```
  */
 export type SortSettings = boolean | ColumnSortSettings & {
     /**
-     * The sort mode of the TreeList.
+     * Sets the sort mode of the TreeList.
      *
-     * The available values for setting the sort modes are:
-     * - `single`
-     * - `multiple`
      */
     mode?: 'single' | 'multiple';
     /**

package/columns/span-column.component.d.ts

@@ -14,16 +14,15 @@ import * as i0 from "@angular/core";
  */
 export declare function isSpanColumnComponent(column: any): column is SpanColumnComponent;
 /**
- * Represents a column which can be spanned over multiple data cells while the individual
- * header and footer cells are retained ([see example]({% slug spanned_columns_treelist %})).
- * Enables you to achieve more flexible layout while keeping the built-in UI element for
- * [sorting]({% slug sorting_treelist %}) and [filtering]({% slug filtering_treelist %}). Wrap the columns that will be
- * merged inside the `<kendo-treelist-span-column>` tag.
+ * Represents a column that spans multiple data cells while keeping individual header and footer cells.
+ * Use this component to create flexible layouts and retain built-in UI for [sorting]({% slug sorting_treelist %}) and [filtering]({% slug filtering_treelist %}).
+ * Wrap the columns to merge inside the `<kendo-treelist-span-column>` tag.
  *
+ * @example
  * ```html
  * <kendo-treelist-span-column>
- *   <kendo-treelist-column field="field1" ></kendo-treelist-column>
- *   <kendo-treelist-column field="field2" ></kendo-treelist-column>
+ *   <kendo-treelist-column field="field1"></kendo-treelist-column>
+ *   <kendo-treelist-column field="field2"></kendo-treelist-column>
  *   <ng-template kendoTreeListCellTemplate let-dataItem>
  *     <h5>{{ dataItem.field1 }}</h5>
  *     <p>{{ dataItem.field2 }}</p>
@@ -33,8 +32,7 @@ export declare function isSpanColumnComponent(column: any): column is SpanColumn
  */
 export declare class SpanColumnComponent extends ColumnBase {
     /**
-     * Defines whether the expanded indicator should be rendered in the column.
-     * @default false
+     * Specifies if the expanded indicator appears in the column.
      */
     expandable: boolean;
     readonly isSpanColumn: boolean;
@@ -77,10 +75,9 @@ export declare class SpanColumnComponent extends ColumnBase {
      */
     includeInChooser: boolean;
     /**
-     * Defines whether the edit template of the column will be rendered. The default value is `false`.
-     *
-     * To enable the editing functionality for a spanned column, set an edit template for it.
-     *
+     * Defines whether the edit template of the column is rendered.
+     * To enable editing for a spanned column, set an edit template for it.
+     * @default false
      */
     set editable(value: boolean);
     get editable(): boolean;
@@ -109,9 +106,7 @@ export declare class SpanColumnComponent extends ColumnBase {
      */
     get colspan(): number;
     /**
-     * Toggles the locked (frozen) state of the columns. Locked columns are visible
-     * at all times during the horizontal scrolling of the TreeList. [See example](slug:locked_columns_treelist).
-     *
+     * Toggles the locked (frozen) state of the columns. Locked columns are visible at all times during horizontal scrolling. [See example](slug:locked_columns_treelist).
      * @default false
      */
     set locked(value: boolean);

package/common/cell-click-event-args.interface.d.ts

@@ -4,7 +4,8 @@
 *-------------------------------------------------------------------------------------------*/
 import { TreeListComponent } from "../treelist.component";
 /**
- * Arguments for the `cellClick` event.
+ * Provides the arguments for the `cellClick` event.
+ * Use this interface to access information about the clicked cell, including its column, row, data item, and event type.
  */
 export interface CellClickEvent {
     /**
@@ -16,11 +17,11 @@ export interface CellClickEvent {
      */
     columnIndex: number;
     /**
-     * The data item that is associated with the row in which the clicked cell is located.
+     * The data item associated with the row containing the clicked cell.
      */
     dataItem: any;
     /**
-     * Indicates if the cell is being edited.
+     * Specifies if the cell is being edited.
      */
     isEdited: boolean;
     /**

package/common/create-form-group.d.ts

@@ -5,6 +5,7 @@
 import { FormGroup } from "@angular/forms";
 import { CreateFormGroupArgs } from "../editing-directives/create-form-group-args.interface";
 /**
- * The function that creates the `FormGroup` for the edited model.
+ * Creates a `FormGroup` for the edited model. Use this function to generate a reactive form group for editing data in the TreeList.
+ *
  */
 export type CreateFormGroup = (args: CreateFormGroupArgs) => FormGroup;

package/common/pager-settings.d.ts

@@ -3,7 +3,7 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * The type of the TreeList pager.
+ * Represents the type of the TreeList pager. Use this type to specify the pager style.
  *
  * The available values are:
  * * `numeric`—Buttons with numbers.
@@ -11,16 +11,15 @@
  *
  * @example
  * ```html
- * <kendo-treelist [pageable]="{ type: 'numeric'}"></kendo-treelist>
+ * <kendo-treelist [pageable]="{ type: 'numeric' }"></kendo-treelist>
  * ```
  */
 export type PagerType = 'numeric' | 'input';
 /**
- * The pager settings of the TreeList.
+ * Represents the pager settings of the TreeList. Use this interface to configure the pager options.
  *
  * @example
- * ```html-no-run
- *
+ * ```html
  * <kendo-treelist
  *    [pageable]="{
  *        buttonCount: 2,
@@ -31,15 +30,15 @@ export type PagerType = 'numeric' | 'input';
  */
 export interface PagerSettings {
     /**
-     * Sets the maximum numeric buttons count before the buttons are collapsed.
+     * Sets the maximum numeric buttons count before the buttons collapse.
      */
     buttonCount?: number;
     /**
-     * A flag that indicates if child nodes should be fetched and counted for the pager total.
+     * Indicates if child nodes are fetched and counted for the pager total.
      */
     countChildren?: boolean;
     /**
-     * Toggles the information about the current page and the total number of records.
+     * Shows information about the current page and the total number of records.
      */
     info?: boolean;
     /**

package/common/remove-confirmation.d.ts

@@ -4,6 +4,6 @@
 *-------------------------------------------------------------------------------------------*/
 import { Observable } from "rxjs";
 /**
- * A function that is called to confirm if the `dataItem` will be removed.
+ * Represents a callback function that confirms if the `dataItem` will be removed. Use this function to prompt the user or perform custom logic before removing an item from the TreeList.
  */
 export type RemoveConfirmationCallback = (dataItem: any, parent: any) => Promise<boolean> | Observable<boolean> | boolean;

package/common/single-popup.service.d.ts

@@ -10,11 +10,11 @@ import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { ScrollSyncService } from '../scrolling/scroll-sync.service';
 import * as i0 from "@angular/core";
 /**
- * Arguments for the `close` event of the filter and column-menu popup.
+ * Provides arguments for the `close` event of the filter and column-menu popup. Use this event to access the original DOM event that triggers the popup to close and to prevent the default closing behavior if needed.
  */
 export declare class PopupCloseEvent extends PreventableEvent {
     /**
-     * The original DOM event that causes the popup to close.
+     * Stores the original DOM event that causes the popup to close.
      */
     originalEvent: any;
     /**
@@ -23,8 +23,9 @@ export declare class PopupCloseEvent extends PreventableEvent {
     constructor(e: any);
 }
 /**
- * The service that is used for the popups of the filter and column menus
- * ([see example]({% slug filter_menu_treelist %}#toc-filter-menu-with-popup)).
+ * Represents the service used for the popups of the filter and column menus.
+ * Use this service to manage popup opening, closing, and event handling.
+ * ([See example]({% slug filter_menu_treelist %}#toc-filter-menu-with-popup)).
  */
 export declare class SinglePopupService implements OnDestroy {
     private popupService;
@@ -32,8 +33,8 @@ export declare class SinglePopupService implements OnDestroy {
     private ngZone;
     private localization;
     /**
-     * Fires when the filter or column menus are about to close because the user clicked outside their popups.
-     * Used to prevent the popup from closing.
+     * Emits when the filter or column menus are about to close because the user clicked outside their popups.
+     * Use this event to prevent the popup from closing.
      */
     readonly onClose: Subject<PopupCloseEvent>;
     private removeClick;

package/data/change-event-args.interface.d.ts

@@ -4,29 +4,28 @@
 *-------------------------------------------------------------------------------------------*/
 import { SortDescriptor, CompositeFilterDescriptor } from '@progress/kendo-data-query';
 /**
- * Arguments for the [`pageChange`](slug:api_treelist_treelistcomponent#toc-pagechange) event.
+ * Provides arguments for the [`pageChange`](slug:api_treelist_treelistcomponent#toc-pagechange) event.
  */
 export interface PageChangeEvent {
     /**
-     * The number of records to skip.
+     * Specifies the number of records to skip.
      */
     skip: number;
     /**
-     * The number of records to take.
+     * Specifies the number of records to take.
      */
     take: number;
 }
 /**
- * Arguments for the [`dataStateChange`](slug:api_treelist_treelistcomponent#toc-datastatechange) event
- * ([more information and examples]({% slug databinding_treelist %})).
+ * Provides arguments for the [`dataStateChange`](slug:api_treelist_treelistcomponent#toc-datastatechange) event ([more information and examples]({% slug databinding_treelist %})).
  */
 export interface DataStateChangeEvent {
     /**
-     * The sort descriptors by which the data is sorted.
+     * Specifies the sort descriptors by which the data is sorted.
      */
     sort?: Array<SortDescriptor>;
     /**
-     * The filter descriptor by which the data is filtered.
+     * Specifies the filter descriptor by which the data is filtered.
      */
     filter?: CompositeFilterDescriptor;
 }

package/data/data-item.interface.d.ts

@@ -3,23 +3,23 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Represents a treelist item for a data row.
+ * Represents a TreeList item for a data row. Use this interface to access information about a data row in the TreeList.
  */
 export interface DataItem {
     /**
-     * The type of the treelist item.
+     * Specifies the type of the TreeList item.
      */
     type: 'data';
     /**
-     * A reference to the data item.
+     * Provides a reference to the data item.
      */
     data: Object;
     /**
-     * The index of the treelist item. Note that this could be different than the index of the data item in the source data set.
+     * Specifies the index of the TreeList item. This value may differ from the index of the data item in the source data set.
      */
     index: number;
     /**
-     * A flag indicating if the item is currently being edited
+     * Indicates if the item is currently being edited.
      */
     isEditing: boolean;
 }

package/data/data.collection.d.ts

@@ -5,15 +5,16 @@
 import { Observable } from 'rxjs';
 import { EventEmitter } from '@angular/core';
 /**
- * The data type that is expected by the TreeList.
+ * Represents the data type expected by the TreeList. Use this interface to provide the data and aggregates for the TreeList.
+ *
  */
 export interface TreeListDataResult {
     /**
-     * The data that will be rendered by the TreeList as an array.
+     * Represents the data rendered by the TreeList as an array.
      */
     data: any[];
     /**
-     * The aggregated values for the group. An [`AggregateResult`](slug:treelist_with_aggregates) instance.
+     * Represents the aggregated values for the group. An [`AggregateResult`](slug:treelist_with_aggregates) instance.
      */
     aggregates?: any;
 }

package/data/treelist-item.interface.d.ts

@@ -4,7 +4,7 @@
 *-------------------------------------------------------------------------------------------*/
 import { DataItem } from './data-item.interface';
 /**
- * Represents an item that will be rendered by the TreeList.
- * Can be a [`DataItem`]({% slug api_treelist_dataitem %}). ([See example]({% slug api_treelist_treelistcomponent %}#toc-trackby))
+ * Represents an item rendered by the TreeList. Use this type for items such as [`DataItem`]({% slug api_treelist_dataitem %}). ([See example]({% slug api_treelist_treelistcomponent %}#toc-trackby)).
+ *
  */
 export type TreeListItem = DataItem;