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

package/esm2022/columns/column-base.mjs

@@ -23,7 +23,7 @@ export const isCheckboxColumn = column => column.isCheckboxColumn;
 export const isRowReorderColumn = column => column.isRowReorderColumn;
 const isColumnContainer = column => column.isColumnGroup || isSpanColumn(column);
 /**
- * The base class for the column components of the TreeList.
+ * Serves as the base class for column components in the TreeList.
  */
 export class ColumnBase {
     parent;
@@ -70,28 +70,27 @@ export class ColumnBase {
      */
     reorderable = true;
     /**
-     * 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 = 10;
     /**
-     * The title of the column.
+     * Sets the title of the column.
      */
     title;
     /**
-     * The width of the column (in pixels).
+     * Sets the width of the column (in pixels).
      */
     set width(value) {
         this._width = parseInt(value, 10);
     }
     get width() { return this._width; }
     /**
-     * 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;
     /**
      * Toggles the locked (frozen) state of the columns ([more information and example](slug:locked_columns_treelist)).
-     *
      * @default false
      */
     set locked(value) {
@@ -103,12 +102,11 @@ export class ColumnBase {
     _locked = false;
     /**
      * Sets the visibility of the column ([see example](slug:hidden_columns_treelist#toc-using-the-built-in-options)).
-     *
      * @default false
      */
     hidden;
     /**
-     * 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;
@@ -118,55 +116,44 @@ export class ColumnBase {
      */
     lockable = true;
     /**
-     * Specifies if the column menu will be shown for the column.
+     * Specifies if the column menu is shown for the column.
      * @default true
      */
     columnMenu = true;
     /**
-     * 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 = true;
     /**
-     * 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 = 'gridcell';
     /**
-     * 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;
     /**
-     * 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;
     /**
-     * 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;
     /**
-     * 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;
     /**
-     * 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;
     /**
      * 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;
     /**

package/esm2022/columns/column-group.component.mjs

@@ -16,8 +16,7 @@ export function isColumnGroupComponent(column) {
     return column.isColumnGroup;
 }
 /**
- * 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/esm2022/columns/column.component.mjs

@@ -20,58 +20,62 @@ export function isColumnComponent(column) {
     return isPresent(column.field);
 }
 /**
- * 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 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;
     /**
-     * The field to which the column is bound.
+     * Sets the field to which the column is bound.
      */
     field;
     /**
-     * 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;
     /**
-     * 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 = true;
     /**
-     * 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';
     /**
-     * Defines the filter type that is displayed inside the filter row.
-     *
+     * Sets the filter type displayed inside the filter row.
      * @default 'text'
      */
     filter = 'text';
     /**
-     * Defines if a filter UI will be displayed for this column.
-     *
+     * Specifies if a filter UI appears for this column.
      * @default true
      */
     filterable = true;
     /**
-     * Defines whether the column is editable.
-     *
+     * Specifies if the column is editable.
      * @default true
      */
     editable = true;

package/esm2022/columns/command-column.component.mjs

@@ -10,9 +10,8 @@ import * as i0 from "@angular/core";
 import * as i1 from "./column-base";
 import * as i2 from "../common/option-changes.service";
 /**
- * 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:
@@ -25,7 +24,7 @@ import * as i2 from "../common/option-changes.service";
  * ```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/esm2022/columns/rowreorder-column.component.mjs

@@ -7,7 +7,15 @@ import { ColumnBase } from './column-base';
 import * as i0 from "@angular/core";
 import * as i1 from "./column-base";
 /**
- * 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 class RowReorderColumnComponent extends ColumnBase {
     parent;

package/esm2022/columns/span-column.component.mjs

@@ -19,16 +19,15 @@ export function isSpanColumnComponent(column) {
     return column.isSpanColumn;
 }
 /**
- * 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>
@@ -38,8 +37,7 @@ export function isSpanColumnComponent(column) {
  */
 export 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;
     /*
@@ -77,10 +75,9 @@ export class SpanColumnComponent extends ColumnBase {
      */
     includeInChooser = false;
     /**
-     * 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) {
         this._editable = value;
@@ -131,9 +128,7 @@ export class SpanColumnComponent extends ColumnBase {
         return this.childColumns.filter(c => c.isVisible).length;
     }
     /**
-     * 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) {

package/esm2022/common/single-popup.service.mjs

@@ -25,11 +25,11 @@ const contains = (node, predicate) => {
     return false;
 };
 /**
- * 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 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;
     /**
@@ -42,8 +42,9 @@ export class PopupCloseEvent extends PreventableEvent {
 }
 const DEFAULT_POPUP_CLASS = 'k-grid-filter-popup';
 /**
- * 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 class SinglePopupService {
     popupService;
@@ -51,8 +52,8 @@ export class SinglePopupService {
     ngZone;
     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.
      */
     onClose = new Subject();
     removeClick;

package/esm2022/directives.mjs

@@ -108,7 +108,7 @@ import { PDFCommandToolbarDirective } from './pdf/pdf-command-tool.directive';
 import { ColumnMenuItemDirective } from './column-menu/column-menu-item.directive';
 /**
  * @hidden
- * Utility array that contains the former Shared module exports
+ * Utility array that contains the former Shared module exports.
  */
 export const SHARED_EXPORTS = [
     ColumnComponent,
@@ -128,7 +128,7 @@ export const SHARED_EXPORTS = [
 ];
 /**
  * @hidden
- * Utility array that contains the Body module exports
+ * Utility array that contains the Body module exports.
  */
 export const BODY_EXPORTS = [
     CommandColumnComponent,
@@ -146,7 +146,7 @@ export const BODY_EXPORTS = [
 ];
 /**
  * @hidden
- * Utility array that contains the Header module exports
+ * Utility array that contains the Header module exports.
  */
 export const HEADER_EXPORTS = [
     HeaderComponent,
@@ -155,7 +155,7 @@ export const HEADER_EXPORTS = [
 ];
 /**
  * @hidden
- * Utility array that contains the former SharedFilter module exports
+ * Utility array that contains the former SharedFilter module exports.
  */
 export const SHARED_FILTER_EXPORTS = [
     FilterCellOperatorsComponent,
@@ -182,7 +182,7 @@ export const SHARED_FILTER_EXPORTS = [
 ];
 /**
  * @hidden
- * Utility array that contains the former ColumnMenu module exports
+ * Utility array that contains the former ColumnMenu module exports.
  */
 export const ROW_FILTER_EXPORTS = [
     FilterRowComponent,
@@ -218,7 +218,7 @@ export const FILTER_MENU_EXPORTS = [
 ];
 /**
  * @hidden
- * Utility array that contains the former ColumnMenu module exports
+ * Utility array that contains the former ColumnMenu module exports.
  */
 export const COLUMN_MENU_EXPORTS = [
     ColumnChooserComponent,
@@ -234,7 +234,7 @@ export const COLUMN_MENU_EXPORTS = [
 ];
 /**
  * @hidden
- * Utility array that contains the Excel module exports
+ * Utility array that contains the Excel module exports.
  */
 export const KENDO_TREELIST_EXCEL_EXPORT = [
     ExcelComponent,
@@ -249,7 +249,7 @@ export const KENDO_TREELIST_EXCEL_EXPORT = [
 ];
 /**
  * @hidden
- * Utility array that contains the PDF module exports
+ * Utility array that contains the PDF module exports.
  */
 export const KENDO_TREELIST_PDF_EXPORT = [
     PDFComponent,
@@ -259,7 +259,8 @@ export const KENDO_TREELIST_PDF_EXPORT = [
     PDFCommandToolbarDirective
 ];
 /**
- * Utility array that contains all `@progress/kendo-angular-treelist` related components and directives
+ * Utility array that contains all `@progress/kendo-angular-treelist`-related components and directives.
+ * Use it to import all TreeList components and directives into a standalone Angular application.
  */
 export const KENDO_TREELIST = [
     TreeListComponent,

package/esm2022/dragdrop/column-reorder-event.mjs

@@ -4,21 +4,19 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from '../common/preventable-event';
 /**
- * Arguments for the `columnReorder` event.
+ * Provides arguments for the `columnReorder` event. Use this event to access the reordered column and its new and old indexes.
  */
 export class ColumnReorderEvent extends PreventableEvent {
     /**
-     * The reordered column.
+     * Specifies the reordered column.
      */
     column;
     /**
-     * The new index of the column.
-     * Relative to the collection of columns.
+     * The new index of the column, relative to the collection of columns.
      */
     newIndex;
     /**
-     * The original index of the column before reordering.
-     * Relative to the collection of columns.
+     * The original index of the column before reordering, relative to the collection of columns.
      */
     oldIndex;
     /**

package/esm2022/editing/add-command-tool.directive.mjs

@@ -11,21 +11,18 @@ import * as i0 from "@angular/core";
 import * as i1 from "./edit.service";
 import * as i2 from "@progress/kendo-angular-toolbar";
 /**
- * Represents the command for adding a new item to the TreeList.
- * You can apply this directive to any `kendo-toolbar-button` element inside a
- * ToolbarComponent used in the TreeList.
- *
- * When the user clicks the toolbar button that is associated with the directive, the
- * [add]({% slug api_treelist_treelistcomponent %}#toc-add) event is triggered.
+ * Represents the command for adding a new item to the TreeList. Apply this directive to any `kendo-toolbar-button` element inside a ToolbarComponent. When the user clicks the toolbar button associated with the directive, the [`add`]({% slug api_treelist_treelistcomponent %}#toc-add) event is triggered.
  *
  * @example
- * ```html-no-run
- * <kendo-grid>
- *      <kendo-toolbar>
- *         <kendo-toolbar-button text="Add new" kendoTreeListAddTool></kendo-toolbar-button>
- *      </kendo-toolbar>
- * </kendo-grid>
+ * ```html
+ * <kendo-treelist>
+ *   <kendo-toolbar>
+ *     <kendo-toolbar-button text="Add new" kendoTreeListAddTool></kendo-toolbar-button>
+ *   </kendo-toolbar>
+ * </kendo-treelist>
  * ```
+ * @remarks
+ * Applied to: {@link ToolBarButtonComponent}
  */
 export class AddCommandToolbarDirective {
     editService;

package/esm2022/editing/add-command.directive.mjs

@@ -12,17 +12,13 @@ import * as i0 from "@angular/core";
 import * as i1 from "./edit.service";
 import * as i2 from "@progress/kendo-angular-l10n";
 /**
- * Represents the command for adding a new item to the TreeList. You can apply this directive to any
- * `button` element inside a [`ToolbarTemplate`](slug:toolbartemplate_treelist) or
- * inside a [`CommandColumnComponent`]({% slug api_treelist_commandcolumncomponent %}).
+ * Represents the command for adding a new item to the TreeList. Apply this directive to any `button` element inside a [`ToolbarTemplate`](slug:toolbartemplate_treelist) or inside a [`CommandColumnComponent`]({% slug api_treelist_commandcolumncomponent %}).
  *
- * When an associated button with the directive is clicked, the
- * [`add`]({% slug api_treelist_treelistcomponent %}#toc-add) event is triggered
- * ([see example](slug:custom_editors_editing_treelist)).
+ * When the user clicks a button with this directive, the [`add`]({% slug api_treelist_treelistcomponent %}#toc-add) event is triggered ([see example](slug:custom_editors_editing_treelist)).
  *
- * When the row is in the `edit mode`, the button with `kendoTreeListAddCommand` is automatically hidden.
+ * The button with `kendoTreeListAddCommand` is automatically hidden when the row is in edit mode.
  *
- * When added to the command column, the directive takes as input the `cellContext` from the cell template.
+ * When used in the command column, the directive takes the `cellContext` from the cell template as input.
  *
  * @example
  * ```html
@@ -37,7 +33,7 @@ import * as i2 from "@progress/kendo-angular-l10n";
  */
 export class AddCommandDirective extends BaseCommandDirective {
     /**
-     * The `cellContext` provided to the template.
+     * Provides the `cellContext` to the template.
      */
     cellContext;
     commandClass = true;

package/esm2022/editing/cancel-command.directive.mjs

@@ -12,14 +12,11 @@ import * as i0 from "@angular/core";
 import * as i1 from "./edit.service";
 import * as i2 from "@progress/kendo-angular-l10n";
 /**
- * Represents the `cancel` command of the TreeList. You can apply this directive to any `button`
- * element inside a [`CommandColumnComponent`]({% slug api_treelist_commandcolumncomponent %}).
- * When an associated button with the directive is clicked, the
- * [`cancel`]({% slug api_treelist_treelistcomponent %}#toc-cancel) event
- * is triggered ([see example](slug:custom_editors_editing_treelist)).
+ * Represents the `cancel` command of the TreeList. Apply this directive to any `button` element inside a [`CommandColumnComponent`]({% slug api_treelist_commandcolumncomponent %}).
  *
- * When the row is not in the `edit` mode, the button with the `kendoTreeListCancelCommand` is automatically hidden.
- * The directive takes as input the `cellContext` from the cell template.
+ * When the user clicks a button with this directive, the [`cancel`]({% slug api_treelist_treelistcomponent %}#toc-cancel) event is triggered ([see example](slug:custom_editors_editing_treelist)).
+ *
+ * The button with `kendoTreeListCancelCommand` is automatically hidden when the row is not in edit mode. The directive takes the `cellContext` from the cell template as input.
  *
  * @example
  * ```html
@@ -34,7 +31,7 @@ import * as i2 from "@progress/kendo-angular-l10n";
  */
 export class CancelCommandDirective extends BaseCommandDirective {
     /**
-     * The `cellContext` provided to the template.
+     * Provides the `cellContext` to the template.
      */
     cellContext;
     commandClass = true;

package/esm2022/editing/cell-close-event.mjs

@@ -4,7 +4,8 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from '../common/preventable-event';
 /**
- * Arguments for the `cellClose` event.
+ * Provides arguments for the `cellClose` event.
+ *
  */
 export class CellCloseEvent extends PreventableEvent {
     isNew;
@@ -15,16 +16,15 @@ export class CellCloseEvent extends PreventableEvent {
      */
     action = 'cellClose';
     /**
-     * The TreeList column that will be closed.
+     * Specifies the TreeList column that will be closed.
      */
     column;
     /**
-     * The [`FormGroup`](link:site.data.urls.angular['formgroupapi']) that is used to edit the cell which will be closed.
+     * Provides the [`FormGroup`](link:site.data.urls.angular['formgroupapi']) used to edit the cell that will be closed.
      */
     formGroup;
     /**
-     * The DOM event that caused the `cellClose` event.
-     * May not be present if `cellClose` was caused by an API call.
+     * Provides the DOM event that caused the `cellClose` event. May not be present if `cellClose` was caused by an API call.
      */
     originalEvent;
     constructor(options) {

package/esm2022/editing/edit-command.directive.mjs

@@ -12,14 +12,11 @@ import * as i0 from "@angular/core";
 import * as i1 from "./edit.service";
 import * as i2 from "@progress/kendo-angular-l10n";
 /**
- * Represents the `edit` command of the TreeList. You can apply this directive to any `button`
- * element inside a [`CommandColumnComponent`]({% slug api_treelist_commandcolumncomponent %}).
- * When an associated button with the directive is clicked, the
- * [`edit`]({% slug api_treelist_treelistcomponent %}#toc-edit) event
- * is triggered ([see example](slug:custom_editors_editing_treelist)).
+ * Represents the `edit` command of the TreeList. Apply this directive to any `button` element inside a [`CommandColumnComponent`]({% slug api_treelist_commandcolumncomponent %}).
  *
- * When the row is in the `edit` mode, the button with `kendoTreeListEditCommand` is automatically hidden.
- * The directive takes as input the `cellContext` from the cell template.
+ * When the user clicks a button with this directive, the [`edit`]({% slug api_treelist_treelistcomponent %}#toc-edit) event is triggered ([see example](slug:custom_editors_editing_treelist)).
+ *
+ * The button with `kendoTreeListEditCommand` is automatically hidden when the row is in edit mode. The directive takes the `cellContext` from the cell template as input.
  *
  * @example
  * ```html
@@ -31,11 +28,10 @@ import * as i2 from "@progress/kendo-angular-l10n";
  *   </kendo-treelist-command-column>
  * </kendo-treelist>
  * ```
- *
  */
 export class EditCommandDirective extends BaseCommandDirective {
     /**
-     * The `cellContext` provided to the template.
+     * Provides the `cellContext` to the template.
      */
     cellContext;
     commandClass = true;

package/esm2022/editing/edit-template.directive.mjs

@@ -5,15 +5,13 @@
 import { Directive, TemplateRef, Optional } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the column edit-cell template of the TreeList ([see example]({% slug editing_template_forms_treelist %})).
- * Helps to customize the content of the edited cells. To define the cell template, nest an `<ng-template>`
- * tag with the `kendoTreeListEditTemplate` directive inside a `<kendo-treelist-column>` tag.
+ * Represents the column edit-cell template of the TreeList ([see example](slug:editing_template_forms_treelist)). Use this directive to customize the content of edited cells. To define the cell template, nest an `<ng-template>` tag with the `kendoTreeListEditTemplate` directive inside a `<kendo-treelist-column>` tag.
  *
  * The template context contains the following fields:
  * - `column`&mdash;The current column instance.
  * - `dataItem`&mdash;The current data item.
  * - `cellContext`&mdash;An object used to pass context information to built-in directives.
- * - `formGroup`&mdash;The current [`FormGroup`](link:site.data.urls.angular['formgroupapi']). If you use the TreeList inside [Template-Driven Forms](link:site.data.urls.angular['forms']), `formGroup` will be `undefined`.
+ * - `formGroup`&mdash;The current [`FormGroup`](link:site.data.urls.angular['formgroupapi']). If you use the TreeList inside [Template-Driven Forms](link:site.data.urls.angular['forms']), `formGroup` is `undefined`.
  * - `isNew`&mdash;The state of the current item.
  * - `rowIndex`&mdash;The current row index. If inside a new item row, `rowIndex` is `-1`.
  *