@progress/kendo-angular-treeview 19.1.2-develop.1 → 19.1.2-develop.3

package/drag-and-drop/models/treeitem-drop-event.d.ts

@@ -8,31 +8,31 @@ import { DropPosition } from './drop-position';
 import { PreventableEvent } from './preventable-event';
 import { TreeItemAddRemoveArgs } from './treeitem-add-remove-args';
 /**
- * Arguments for the TreeView [`nodeDrop`]({% slug api_treeview_treeviewcomponent %}#toc-nodedrop) event.
+ * Arguments for the TreeView [`nodeDrop`](slug:api_treeview_treeviewcomponent#nodedrop) event.
  */
 export declare class TreeItemDropEvent extends PreventableEvent implements TreeItemAddRemoveArgs {
     /**
-     * A reference of the TreeView from which the dragged item originates.
+     * Reference to the TreeView from which the dragged item originates.
      */
     sourceTree: TreeViewComponent;
     /**
-     * A reference of the TreeView onto which the dragged item is dropped.
+     * Reference to the TreeView onto which the dragged item is dropped.
      */
     destinationTree: TreeViewComponent;
     /**
-     * The look-up info for the dragged item.
+     * Lookup information for the dragged item.
      */
     sourceItem: TreeItemLookup;
     /**
-     * The look-up info for the item onto which the dragged item is dropped.
+     * Lookup information for the item onto which the dragged item is dropped.
      */
     destinationItem: TreeItemLookup;
     /**
-     * Describes where the dragged item is dropped relative to the drop target item.
+     * Represents the drop position relative to the target item.
      */
     dropPosition: DropPosition;
     /**
-     * The original pointer event holding details about the current pointer position.
+     * The original pointer event containing details about the pointer position.
      */
     originalEvent: PointerEvent;
     /**
@@ -44,10 +44,9 @@ export declare class TreeItemDropEvent extends PreventableEvent implements TreeI
      */
     constructor(initializer: TreeItemAddRemoveArgs, originalEvent: PointerEvent);
     /**
-     * Specifies if the drop action should be marked as valid.
-     * If set to `false`, the [`addItem`]({% slug api_treeview_treeviewcomponent %}#toc-additem) and
-     * [`removeItem`]({% slug api_treeview_treeviewcomponent %}#toc-removeitem) events will not be fired and the drag clue
-     * will be animated back to the source item to indicate the action is marked as invalid.
+     * Sets whether the drop action is valid.
+     * If set to `false`, the `addItem` and `removeItem` events will not be fired and the drag clue
+     * will animate back to the source item to indicate the action is invalid.
      */
     setValid(isValid: boolean): void;
 }

package/esm2022/check.directive.mjs

@@ -28,8 +28,18 @@ const matchKey = index => k => {
     }, { key: "", result: false }).result;
 };
 /**
- * A directive which manages the in-memory checked state of the TreeView node
- * ([see example]({% slug checkboxes_treeview %})).
+ * Represents a directive that manages the in-memory checked state of the TreeView node
+ * ([see example](slug:checkboxes_treeview)).
+ *
+ * @example
+ * ```html
+ * <kendo-treeview
+ *      kendoTreeViewCheckable
+ *      checkBy="id"
+ *      [(checkedKeys)]="checkedKeys"
+ *      [nodes]="data">
+ *  </kendo-treeview
+ * ```
  */
 export class CheckDirective {
     treeView;
@@ -41,21 +51,22 @@ export class CheckDirective {
         this.treeView.isChecked = value;
     }
     /**
-     * Defines the item key that will be stored in the `checkedKeys` collection.
+     * Defines the item key stored in the `checkedKeys` collection.
      */
     checkKey;
     /**
-     * Defines the collection that will store the checked keys
-     * ([see example]({% slug checkboxes_treeview %})).
+     * Defines the collection that stores the checked keys
+     * ([see example](slug:checkboxes_treeview)).
      */
     checkedKeys;
     /**
-     * Defines the checkable settings ([see example]({% slug checkboxes_treeview %}#toc-setup)).
-     * If no value is provided, the default [`CheckableSettings`]({% slug api_treeview_checkablesettings %}) are applied.
+     * Defines the checkable settings
+     * ([see example](slug:checkboxes_treeview#setup)).
+     * If you do not provide a value, the default [`CheckableSettings`](slug:api_treeview_checkablesettings) apply.
      */
     checkable;
     /**
-     * Fires when the `checkedKeys` collection was updated.
+     * Fires when the `checkedKeys` collection updates.
      */
     checkedKeysChange = new EventEmitter();
     subscriptions = new Subscription();
@@ -80,7 +91,7 @@ export class CheckDirective {
         'single': (e) => this.checkSingle(e)
     };
     /**
-     * Reflectes the internal `checkedKeys` state.
+     * Reflects the internal `checkedKeys` state.
      */
     state = new Set();
     clickSubscription;

package/esm2022/directives.mjs

@@ -18,7 +18,21 @@ import { NodeTemplateDirective } from "./node-template.directive";
 import { SelectDirective } from "./selection/select.directive";
 import { TreeViewComponent } from "./treeview.component";
 /**
- * Utility array that contains all `@progress/kendo-angular-treeview` related components and directives
+ * Use the `KENDO_TREEVIEW ` utility array to add all `@progress/kendo-angular-treeview` related components and directives to a standalone Angular component.
+ *
+ * @example
+ * ```typescript
+ * import { Component } from '@angular/core';
+ * import { KENDO_TREEVIEW } from '@progress/kendo-angular-treeview';
+ *
+ * @Component({
+ *   selector: 'my-app',
+ *   standalone: true,
+ *   imports: [KENDO_TREEVIEW],
+ *   template: `<kendo-treeview></kendo-treeview>`
+ * })
+ * export class AppComponent {}
+ * ```
  */
 export const KENDO_TREEVIEW = [
     TreeViewComponent,

package/esm2022/disable.directive.mjs

@@ -7,7 +7,7 @@ import { TreeViewComponent } from './treeview.component';
 import * as i0 from "@angular/core";
 import * as i1 from "./treeview.component";
 /**
- * A directive which manages the disabled in-memory state of the TreeView node
+ * Represents a directive which manages the disabled in-memory state of the TreeView node
  * ([see example]({% slug disabledstate_treeview %})).
  */
 export class DisableDirective {

package/esm2022/drag-and-drop/drag-and-drop-editing.directive.mjs

@@ -9,19 +9,31 @@ import { isPresent } from '../utils';
 import * as i0 from "@angular/core";
 import * as i1 from "../treeview.component";
 /**
- * A directive which enables the update of the initially provided data array during drag-and-drop.
+ * Represents the directive that enables you to update the initially provided data array during drag-and-drop.
  *
- * Either use this directive in combination with one of the data binding directives ([`kendoTreeViewHierarchyBinding`]({% slug api_treeview_hierarchybindingdirective %})
- * or [`kendoTreeViewFlatDataBinding`]({% slug api_treeview_flatdatabindingdirective %})) which set their own edit handlers, or provide
- * your own [`editService`]({% slug api_treeview_editservice %}) to this directive. The latter subscribes to and calls the
- * [`addItem`]({% slug api_treeview_treeviewcomponent %}#toc-additem) and [`removeItem`]({% slug api_treeview_treeviewcomponent %}#toc-removeitem)
- * handlers when the corresponding events are triggered by the TreeView component.
+ * Use this directive with one of the data-binding directives ([`kendoTreeViewHierarchyBinding`](slug:api_treeview_hierarchybindingdirective)
+ * or [`kendoTreeViewFlatDataBinding`](slug:api_treeview_flatdatabindingdirective)), which set their own edit handlers, or provide
+ * your own [`editService`](slug:api_treeview_editservice) to this directive.
+ *
+ * Providing a custom `editService` allows you to handle the
+ * [`addItem`](slug:api_treeview_treeviewcomponent#additem) and [`removeItem`](slug:api_treeview_treeviewcomponent#removeitem)
+ * events when they are triggered by the TreeView component.
+ *
+ * @example
+ * ```html
+ * <kendo-treeview
+ *   kendoTreeViewDragAndDrop
+ *   kendoTreeViewDragAndDropEditing
+ *   [nodes]="nodes"
+ *   textField="text">
+ * </kendo-treeview>
+ * ```
  */
 export class DragAndDropEditingDirective {
     treeview;
     /**
-     * Specifies the handlers called on drag-and-drop [`addItem`]({% slug api_treeview_treeviewcomponent %}#toc-additem)
-     * and [`removeItem`]({% slug api_treeview_treeviewcomponent %}#toc-removeitem) events.
+     * Specifies the handlers called on drag-and-drop [`addItem`](slug:api_treeview_treeviewcomponent#additem)
+     * and [`removeItem`](slug:api_treeview_treeviewcomponent#removeitem) events.
      */
     set editService(service) {
         this.treeview.editService = service;

package/esm2022/drag-and-drop/drag-and-drop.directive.mjs

@@ -23,16 +23,25 @@ const DEFAULT_SCROLL_SETTINGS = {
     interval: 1
 };
 /**
- * A directive which enables the dragging and dropping items inside the current TreeView or between multiple linked TreeView component instances
- * ([see example]({% slug draganddrop_treeview %})).
+ * Represents the directive that enables you to drag and drop items inside the current TreeView or between multiple linked TreeView component instances
+ * ([see example](slug:draganddrop_treeview)).
  *
- * Triggers the [`nodeDragStart`]({% slug api_treeview_treeviewcomponent %}#toc-nodedragstart),
- * [`nodeDrag`]({% slug api_treeview_treeviewcomponent %}#toc-nodedrag),
- * [`nodeDrop`]({% slug api_treeview_treeviewcomponent %}#toc-nodedrop),
- * [`nodeDragEnd`]({% slug api_treeview_treeviewcomponent %}#toc-nodedragend),
- * [`addItem`]({% slug api_treeview_treeviewcomponent %}#toc-additem) and
- * [`removeItem`]({% slug api_treeview_treeviewcomponent %}#toc-removeitem)
- * events when the corresponding actions occur on the respective TreeView instance.
+ * Triggers the [`nodeDragStart`](slug:api_treeview_treeviewcomponent#nodedragstart),
+ * [`nodeDrag`](slug:api_treeview_treeviewcomponent#nodedrag),
+ * [`nodeDrop`](slug:api_treeview_treeviewcomponent#nodedrop),
+ * [`nodeDragEnd`](slug:api_treeview_treeviewcomponent#nodedragend),
+ * [`addItem`](slug:api_treeview_treeviewcomponent#additem) and
+ * [`removeItem`](slug:api_treeview_treeviewcomponent#removeitem)
+ * events when you perform the corresponding actions.
+ *
+ * @example
+ * ```html
+ * <kendo-treeview
+ *    kendoTreeViewDragAndDrop
+ *    [dropZoneTreeViews]="treeView"
+ * >
+ * </kendo-treeview>
+ * ```
  */
 export class DragAndDropDirective {
     element;
@@ -41,31 +50,31 @@ export class DragAndDropDirective {
     dragClueService;
     dropHintService;
     /**
-     * Specifies whether the `removeItem` event will be fired after an item is dropped when the `ctrl` key is pressed.
-     * If enabled, the `removeItem` event will not be fired on the source TreeView
-     * ([see example]({% slug draganddrop_treeview %}#toc-multiple-treeviews)).
+     * Specifies whether the `removeItem` event fires after the user drops an item while pressing the `ctrl` key.
+     * If enabled, the `removeItem` event does not fire on the source TreeView
+     * ([see example](slug:draganddrop_treeview#multiple-treeviews)).
      *
      * @default false
      */
     allowCopy = false;
     /**
-     * Specifes the TreeViewComponent instances into which dragged items from the current TreeViewComponent can be dropped
-     * ([see example]({% slug draganddrop_treeview %}#toc-multiple-treeviews)).
+     * Specifies the `TreeViewComponent` instances into which the user can drop dragged items from the current `TreeViewComponent`
+     * ([see example](slug:draganddrop_treeview#multiple-treeviews)).
      */
     dropZoneTreeViews = [];
     /**
-     * Specifies the distance in pixels from the initial item pointerdown event, before the dragging is initiated.
-     * The `nodeDragStart` and all consequent TreeView drag events will not be fired until the actual dragging begins.
+     * Specifies the distance in pixels from the initial item `pointerdown` event before dragging starts.
+     * The `nodeDragStart` and all subsequent TreeView drag events do not fire until dragging begins.
      *
      * @default 5
      */
     startDragAfter = 5;
     /**
-     * Controlls the auto-scrolling behavior during drag-and-drop ([see example]({% slug draganddrop_treeview %}#toc-auto-scrolling)).
-     * Enbaled by default. To turn the auto-scrolling off, set this prop to `false`.
+     * Controls the auto-scrolling behavior during drag-and-drop ([see example](slug:draganddrop_treeview#auto-scrolling)).
+     * Enabled by default. To turn off auto-scrolling, set this property to `false`.
      *
-     * By default, the scrolling will be performed by 1 pixel at every 1 millisecond, when the dragged item reaches the top or the bottom of the scrollable container.
-     * The `step` and `interval` can be overridden by providing a `DragAndDropScrollSettings` object to this prop.
+     * By default, scrolling occurs by 1 pixel every 1 millisecond when the dragged item reaches the top or bottom of the scrollable container.
+     * You can override the `step` and `interval` by providing a `DragAndDropScrollSettings` object.
      *
      * @default true
      */

package/esm2022/drag-and-drop/drag-clue/drag-clue-template.directive.mjs

@@ -5,18 +5,25 @@
 import { Directive, Optional, TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template for the TreeView drag clue when an item is dragged. To define the clue template,
- * nest an `<ng-template>` tag with the `kendoTreeViewDragClueTemplate` directive inside a `<kendo-treeview>` tag
- * ([see example]({% slug draganddrop_treeview %}#toc-templates)).
+ * Represents the template for the TreeView drag clue when you drag an item.
  *
+ * To define the drag clue template, nest an `<ng-template>` tag with the `kendoTreeViewDragClueTemplate` directive inside a `<kendo-treeview>` tag
+ * ([see example](slug:draganddrop_treeview#toc-templates)).
  *
- * The text, attempted drop action, source item and destination item are available as context variables in the template:
+ * The template context provides the following variables:
+ * - `let-text="text"` (`string`)&mdash;The display text of the item being dragged.
+ * - `let-action="action"` ([`DropAction`](slug:api_treeview_dropaction))&mdash;The type of drop action that will occur.
+ * - `let-sourceItem="sourceItem"` ([`TreeItemLookup`](slug:api_treeview_treeitemlookup))&mdash;The TreeView item that is being dragged from its original position.
+ * - `let-destinationItem="destinationItem"` ([`TreeItemLookup`](slug:api_treeview_treeitemlookup))&mdash;The TreeView item that serves as the target for the drop operation.
  *
- *
- * - `let-text="text"` (`string`)
- * - `let-action="action"` ([`DropAction`]({% slug api_treeview_dropaction %}))
- * - `let-sourceItem="sourceItem"` ([`TreeItemLookup`]({% slug api_treeview_treeitemlookup %}))
- * - `let-destinationItem="destinationItem"` ([`TreeItemLookup`]({% slug api_treeview_treeitemlookup %}))
+ * @example
+ * ```html
+ * <kendo-treeview>
+ *   <ng-template kendoTreeViewDragClueTemplate let-text="text">
+ *     Dragging: {{ text }}
+ *   </ng-template>
+ * </kendo-treeview>
+ * ```
  */
 export class DragClueTemplateDirective {
     templateRef;

package/esm2022/drag-and-drop/drop-hint/drop-hint-template.directive.mjs

@@ -5,15 +5,24 @@
 import { Directive, Optional, TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template for the TreeView drop hint when an item is dragged. To define the hint template,
- * nest an `<ng-template>` tag with the `kendoTreeViewDropHintTemplate` directive inside a `<kendo-treeview>` tag
- * ([see example]({% slug draganddrop_treeview %}#toc-templates)).
+ * Represents the template for the TreeView drop hint when you drag an item.
  *
- * The attempted drop action, source item and destination item are available as context variables in the template:
+ * To define the hint template, nest an `<ng-template>` tag with the `kendoTreeViewDropHintTemplate` directive inside a `<kendo-treeview>` tag
+ * ([see example](slug:draganddrop_treeview#toc-templates)).
  *
- * - `let-action="action"` ([`DropAction`]({% slug api_treeview_dropaction %}))
- * - `let-sourceItem="sourceItem"` ([`TreeItemLookup`]({% slug api_treeview_treeitemlookup %}))
- * - `let-destinationItem="destinationItem"` ([`TreeItemLookup`]({% slug api_treeview_treeitemlookup %}))
+ * The template context provides the following variables:
+ * - `let-action="action"` ([`DropAction`](slug:api_treeview_dropaction))&mdash;The drop action being performed.
+ * - `let-sourceItem="sourceItem"` ([`TreeItemLookup`](slug:api_treeview_treeitemlookup))&mdash;The item being dragged.
+ * - `let-destinationItem="destinationItem"` ([`TreeItemLookup`](slug:api_treeview_treeitemlookup))&mdash;The target item for the drop operation.
+ *
+ * @example
+ * ```html
+ * <kendo-treeview>
+ *   <ng-template kendoTreeViewDropHintTemplate let-action="action">
+ *     Drop action: {{ action }}
+ *   </ng-template>
+ * </kendo-treeview>
+ * ```
  */
 export class DropHintTemplateDirective {
     templateRef;

package/esm2022/drag-and-drop/models/drop-action.mjs

@@ -3,15 +3,30 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Describes the attempted drop action during dragging.
- * Passed as `action` value to the [`kendoTreeViewDragClueTemplate`]({% slug api_treeview_dragcluetemplatedirective %}) directive.
+ * Represents the attempted drop action during dragging.
+ * Passed as `action` value to the [`kendoTreeViewDragClueTemplate`](slug:api_treeview_dragcluetemplatedirective) directive.
  * By default, this value defines the rendered icon in the drag clue.
  */
 export var DropAction;
 (function (DropAction) {
+    /**
+     * The dragged item is added as a child to the target node.
+     */
     DropAction[DropAction["Add"] = 0] = "Add";
+    /**
+     * The dragged item is inserted above the target node at the same level.
+     */
     DropAction[DropAction["InsertTop"] = 1] = "InsertTop";
+    /**
+     * The dragged item is inserted below the target node at the same level.
+     */
     DropAction[DropAction["InsertBottom"] = 2] = "InsertBottom";
+    /**
+     * The dragged item is inserted in the middle position relative to the target node.
+     */
     DropAction[DropAction["InsertMiddle"] = 3] = "InsertMiddle";
+    /**
+     * The drop action is not valid for the current target location.
+     */
     DropAction[DropAction["Invalid"] = 4] = "Invalid";
 })(DropAction || (DropAction = {}));

package/esm2022/drag-and-drop/models/drop-position.mjs

@@ -3,11 +3,20 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Describes where the dragged item is dropped relative to the drop target item.
+ * Specifies where a dragged item is dropped relative to the target item.
  */
 export var DropPosition;
 (function (DropPosition) {
+    /**
+     * The item is dropped over the target item.
+     */
     DropPosition[DropPosition["Over"] = 0] = "Over";
+    /**
+     * The item is dropped before the target item.
+     */
     DropPosition[DropPosition["Before"] = 1] = "Before";
+    /**
+     * The item is dropped after the target item.
+     */
     DropPosition[DropPosition["After"] = 2] = "After";
 })(DropPosition || (DropPosition = {}));

package/esm2022/drag-and-drop/models/treeitem-drag-event.mjs

@@ -3,22 +3,22 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Arguments for the TreeView [`nodeDrag`]({% slug api_treeview_treeviewcomponent %}#toc-nodedrag) and
- * [`nodeDragEnd`]({% slug api_treeview_treeviewcomponent %}#toc-nodedragend) events.
+ * Arguments for the TreeView [`nodeDrag`](slug:api_treeview_treeviewcomponent#nodedrag) and
+ * [`nodeDragEnd`](slug:api_treeview_treeviewcomponent#nodedragend) events.
  */
 export class TreeItemDragEvent {
     /** @hidden */
     constructor() { }
     /**
-     * The look-up info for the dragged item.
+     * Lookup information for the dragged item.
      */
     sourceItem;
     /**
-     * The look-up info for the item that the dragged node is placed over if there is such.
+     * Lookup information for the item currently under the dragged node, if any.
      */
     destinationItem;
     /**
-     * The original pointer event holding details about the current pointer position.
+     * The original pointer event containing details about the pointer position.
      */
     originalEvent;
 }

package/esm2022/drag-and-drop/models/treeitem-drag-start-event.mjs

@@ -4,15 +4,15 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from './preventable-event';
 /**
- * Arguments for the TreeView [`nodeDragStart`]({% slug api_treeview_treeviewcomponent %}#toc-nodedragstart) event.
+ * Arguments for the TreeView [`nodeDragStart`](slug:api_treeview_treeviewcomponent#nodedragstart) event.
  */
 export class TreeItemDragStartEvent extends PreventableEvent {
     /**
-     * The look-up info for the dragged item.
+     * Lookup information for the dragged item.
      */
     sourceItem;
     /**
-     * The original pointer event holding details about the current pointer position.
+     * The original pointer event containing details about the pointer position.
      */
     originalEvent;
     /**

package/esm2022/drag-and-drop/models/treeitem-drop-event.mjs

@@ -4,31 +4,31 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from './preventable-event';
 /**
- * Arguments for the TreeView [`nodeDrop`]({% slug api_treeview_treeviewcomponent %}#toc-nodedrop) event.
+ * Arguments for the TreeView [`nodeDrop`](slug:api_treeview_treeviewcomponent#nodedrop) event.
  */
 export class TreeItemDropEvent extends PreventableEvent {
     /**
-     * A reference of the TreeView from which the dragged item originates.
+     * Reference to the TreeView from which the dragged item originates.
      */
     sourceTree;
     /**
-     * A reference of the TreeView onto which the dragged item is dropped.
+     * Reference to the TreeView onto which the dragged item is dropped.
      */
     destinationTree;
     /**
-     * The look-up info for the dragged item.
+     * Lookup information for the dragged item.
      */
     sourceItem;
     /**
-     * The look-up info for the item onto which the dragged item is dropped.
+     * Lookup information for the item onto which the dragged item is dropped.
      */
     destinationItem;
     /**
-     * Describes where the dragged item is dropped relative to the drop target item.
+     * Represents the drop position relative to the target item.
      */
     dropPosition;
     /**
-     * The original pointer event holding details about the current pointer position.
+     * The original pointer event containing details about the pointer position.
      */
     originalEvent;
     /**
@@ -44,10 +44,9 @@ export class TreeItemDropEvent extends PreventableEvent {
         this.originalEvent = originalEvent;
     }
     /**
-     * Specifies if the drop action should be marked as valid.
-     * If set to `false`, the [`addItem`]({% slug api_treeview_treeviewcomponent %}#toc-additem) and
-     * [`removeItem`]({% slug api_treeview_treeviewcomponent %}#toc-removeitem) events will not be fired and the drag clue
-     * will be animated back to the source item to indicate the action is marked as invalid.
+     * Sets whether the drop action is valid.
+     * If set to `false`, the `addItem` and `removeItem` events will not be fired and the drag clue
+     * will animate back to the source item to indicate the action is invalid.
      */
     setValid(isValid) {
         this.isValid = isValid;

package/esm2022/expand.directive.mjs

@@ -16,8 +16,19 @@ const DEFAULT_FILTER_EXPAND_SETTINGS = {
     expandedOnClear: "none"
 };
 /**
- * A directive which manages the expanded state of the TreeView.
- * ([see example]({% slug expandedstate_treeview %})).
+ * Represents a directive that manages the expanded state of the TreeView
+ * ([see example](slug:expandedstate_treeview)).
+ *
+ * @example
+ * ```html
+ * <kendo-treeview
+ *     kendoTreeViewExpandable
+ *     expandBy="id"
+ *     [(expandedKeys)]="expandedKeys"
+ *     [expandOnFilter]="true"
+ *     [nodes]="data">
+ * </kendo-treeview>
+ * ```
  */
 export class ExpandDirective {
     component;
@@ -28,12 +39,12 @@ export class ExpandDirective {
         this.component.isExpanded = value;
     }
     /**
-     * Defines the item key that will be stored in the `expandedKeys` collection.
+     * Defines the item key stored in the `expandedKeys` collection.
      */
     expandKey;
     /**
-     * Whether or not to auto-expand the nodes leading from the root node to each filter result.
-     * To fine-tune this behavior, pass a [`FilterExpandSettings`]({% slug api_treeview_filterexpandsettings %}) object to this input.
+     * Specifies whether to auto-expand the nodes leading from the root node to each filter result.
+     * To fine-tune this behavior, pass a [`FilterExpandSettings`](slug:api_treeview_filterexpandsettings) object to this input.
      * @default false
      */
     expandOnFilter = false;
@@ -42,16 +53,16 @@ export class ExpandDirective {
         return Object.assign({}, DEFAULT_FILTER_EXPAND_SETTINGS, settings);
     }
     /**
-     * Fires when the `expandedKeys` collection was updated.
+     * Fires when the `expandedKeys` collection updates.
      */
     expandedKeysChange = new EventEmitter();
     /**
-     * Defines the collection that will store the expanded keys.
+     * Defines the collection that stores the expanded keys.
      */
     expandedKeys;
     subscriptions = new Subscription();
     /**
-     * Reflectes the internal `expandedKeys` state.
+     * Reflects the internal `expandedKeys` state.
      */
     state = new Set();
     originalExpandedKeys = new Set();

package/esm2022/flat-binding.directive.mjs

@@ -33,12 +33,27 @@ const mapToTree = (currentLevelNodes, allNodes, parentIdField, idField, parent =
     });
 };
 /**
- * A directive which encapsulates the retrieval of the child nodes.
+ * Represents a directive that handles flat data binding and provides built-in filtering functionality for the TreeView.
+ *
+ * Use this directive to bind flat data where parent-child relationships are defined by ID fields.
+ * The directive also enables the built-in filter input and automatic filter handling when used with the `filterable` property.
+ *
+ * @example
+ * ```html
+ * <kendo-treeview
+ *     kendoTreeViewFlatDataBinding
+ *     idField="id"
+ *     parentIdField="parentId"
+ *     textField="text"
+ *     [nodes]="data"
+ *     [filterable]="true">
+ *  </kendo-treeview>
+ * ```
  */
 export class FlatDataBindingDirective extends FilteringBase {
     component;
     /**
-     * The nodes which will be displayed by the TreeView.
+     * Specifies the flat data collection that renders as nodes in the TreeView.
      */
     set nodes(nodes) {
         // Needs to be a setter so that it can be accessed via `super` call (typescript v5)
@@ -49,11 +64,11 @@ export class FlatDataBindingDirective extends FilteringBase {
     }
     _nodes;
     /**
-     * Represents the parent field whose value will be matched with the parent node.
+     * Specifies the field name that contains the parent node identifier.
      */
     parentIdField;
     /**
-     * Represents the unique field which identifies a node.
+     * Specifies the field name that contains the unique node identifier.
      */
     idField;
     /**

package/esm2022/hierarchy-binding.directive.mjs

@@ -34,13 +34,27 @@ const mapToWrappers = (currentLevelNodes, childrenField, parent = null, parentIn
     });
 };
 /**
- * A directive which encapsulates the retrieval of child nodes.
+ * Represents a directive that handles hierarchical data binding and provides built-in filtering functionality for the TreeView.
+ *
+ * Use this directive to bind hierarchical data where child nodes are nested within parent nodes.
+ * The directive also enables the built-in filter input and automatic filter handling when used with the `filterable` property.
+ *
+ * @example
+ * ```html
+ * <kendo-treeview
+ *     kendoTreeViewHierarchyBinding
+ *     childrenField="items"
+ *     textField="text"
+ *     [nodes]="data"
+ *     [filterable]="true">
+ *  </kendo-treeview>
+ * ```
  */
 export class HierarchyBindingDirective extends FilteringBase {
     component;
     dragAndDropDirective;
     /**
-     * The field name which holds the data items of the child component.
+     * Specifies the field name of the parent node that holds the child data items.
      */
     set childrenField(value) {
         if (!value) {
@@ -49,13 +63,13 @@ export class HierarchyBindingDirective extends FilteringBase {
         this._childrenField = value;
     }
     /**
-     * The field name which holds the data items of the child component.
+     * Specifies the field name of the parent node that holds the child data items.
      */
     get childrenField() {
         return this._childrenField;
     }
     /**
-     * The nodes which will be displayed by the TreeView.
+     * Specifies the hierarchical data displayed by the TreeView.
      */
     set nodes(nodes) {
         // Needs to be a setter so that it can be accessed via `super` call (typescript v5)