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

package/fesm2022/progress-kendo-angular-treeview.mjs

@@ -28,8 +28,8 @@ const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749804206,
-    version: '19.1.2-develop.1',
+    publishDate: 1750152519,
+    version: '19.1.2-develop.3',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };
 
@@ -830,57 +830,25 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }] });
 
 /**
- * Represents the template for the TreeView nodes ([more information and example]({% slug nodetemplate_treeview %})).
- * The template helps to customize the content of the nodes. To define the node template, nest an `<ng-template>`
- * tag with the `kendoTreeViewNodeTemplate` directive inside a `<kendo-treeview>` tag.
- *
+ * Represents the template for TreeView nodes ([more information and example](slug:nodetemplate_treeview)).
  *
- * The node data item and its hierarchical index are available as context variables:
+ * Use this template to customize the content of the nodes. To define the node template, nest an `<ng-template>`
+ * tag with the `kendoTreeViewNodeTemplate` directive inside a `<kendo-treeview>` tag.
  *
- * - `let-dataItem` (`any`) - available as implicit context variable
- * - `let-index="index"` (`string`)
+ * The template context provides the node data item and its hierarchical index as variables:
  *
+ * - `let-dataItem`&mdash;The data item for the current node.
+ * - `let-index="index"`&mdash;The hierarchical index of the current node.
  *
  * @example
- * ```ts
- *
- *  import { Component } from '@angular/core';
- *  @Component({
- *      selector: 'my-app',
- *      template: `
- *      <kendo-treeview
- *          [nodes]="data"
- *          kendoTreeViewExpandable
- *
- *          kendoTreeViewHierarchyBinding
- *          childrenField="items">
- *        <ng-template kendoTreeViewNodeTemplate let-dataItem let-index="index">
- *          <span [style.fontWeight]="dataItem.items ? 'bolder': 'normal' ">{{ index }}: {{ dataItem.text }}</span>
- *        </ng-template>
- *      </kendo-treeview>
- *    `
- *  })
- *  export class AppComponent {
- *      public data: any[] = [
- *          {
- *              text: "Inbox",
- *              items: [{ text: "Read Mail" }]
- *          },
- *          {
- *              text: "Drafts"
- *          },
- *          {
- *              text: "Search Folders",
- *              items: [
- *                  { text: "Categorized Mail" },
- *                  { text: "Large Mail" },
- *                  { text: "Unread Mail"}
- *              ]
- *          },
- *          { text: "Settings" }
- *      ];
- *  }
- *
+ * ```html
+ * <kendo-treeview>
+ *   <ng-template kendoTreeViewNodeTemplate let-dataItem let-index="index">
+ *      <span [style.fontWeight]="dataItem.items ? 'bolder': 'normal' ">
+ *        {{ index }}: {{ dataItem.text }}
+ *      </span>
+ *    </ng-template>
+ * </kendo-treeview>
  * ```
  */
 class NodeTemplateDirective {
@@ -902,14 +870,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
                 }] }]; } });
 
 /**
- * Represents the template for the TreeView load more buttons.
- * To define a button template, nest an `<ng-template>`
- * tag with the `kendoTreeViewLoadMoreButtonTemplate` directive inside a `<kendo-treeview>` tag
- * ([see example]({% slug loadmorebutton_treeview %}#toc-button-template)).
+ * Represents a directive for customizing the load more button in the TreeView.
+ *
+ * To define the template, nest an `<ng-template>` tag with the `kendoTreeViewLoadMoreButtonTemplate` directive inside a `<kendo-treeview>` tag
+ * ([see example](slug:loadmorebutton_treeview#button-template)).
  *
- * The hierarchical index of the load more button node is available as a context variable:
+ * The template context provides the following variable:
+ * - `let-index="index"`&mdash;The hierarchical index of the load more button node.
  *
- * - `let-index="index"` (`string`)
+ * @example
+ * ```html
+ * <kendo-treeview>
+ *   <ng-template kendoTreeViewLoadMoreButtonTemplate let-index="index">
+ *     Load more at {{ index }}
+ *   </ng-template>
+ * </kendo-treeview>
+ * ```
  */
 class LoadMoreButtonTemplateDirective {
     templateRef;
@@ -2139,7 +2115,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
  */
 class TreeViewMessages extends ComponentMessages {
     /**
-     * The text of the `Load More` button title.
+     * Sets the text for the `Load More` button title.
      */
     loadMore;
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: TreeViewMessages, deps: null, target: i0.ɵɵFactoryTarget.Directive });
@@ -2212,8 +2188,19 @@ const providers = [
     }
 ];
 /**
- * Represents the [Kendo UI TreeView component for Angular]({% slug overview_treeview %}).
+ * Represents the [Kendo UI TreeView component for Angular](slug:overview_treeview).
  *
+ * @example
+ * ```html
+ * <kendo-treeview
+ *    kendoTreeViewExpandable
+ *    [nodes]="data"
+ *    textField="text"
+ *    [children]="fetchChildren"
+ *    [hasChildren]="hasChildren"
+ * >
+ * </kendo-treeview>
+ * ```
  */
 class TreeViewComponent {
     element;
@@ -2245,16 +2232,17 @@ class TreeViewComponent {
      */
     searchbox;
     /**
-     * The hint which is displayed when the component is empty.
+     * Sets the placeholder text for the filter input when the component is empty.
      */
     filterInputPlaceholder = "";
     /**
-     * Determines whether to allow expanding disabled nodes.
+     * Allows expanding disabled nodes.
+     *
      * @default false
      */
     expandDisabledNodes;
     /**
-     * Determines whether the content animation is enabled.
+     * Enables or disables content animation.
      */
     set animate(value) {
         this._animate = value;
@@ -2269,79 +2257,73 @@ class TreeViewComponent {
      */
     childrenLoaded = new EventEmitter();
     /**
-     * Fires when the user blurs the component.
-     */
+      * Fires when the component loses focus.
+      */
     onBlur = new EventEmitter();
     /**
-     * Fires when the user focuses the component.
+     * Fires when the component receives focus.
      */
     onFocus = new EventEmitter();
     /**
-     * Fires when the user expands a TreeView node.
+     * Fires when a TreeView node expands.
      */
     expand = new EventEmitter();
     /**
-     * Fires when the user collapses a TreeView node.
+     * Fires when a TreeView node collapses.
      */
     collapse = new EventEmitter();
     /**
-     * Fires just before the dragging of the node starts ([see example]({% slug draganddrop_treeview %}#toc-setup)). This event is preventable.
-     * If you prevent the event default, no drag hint will be created and the subsequent drag-related events will not be fired.
+     * Fires just before node dragging starts ([see example](slug:draganddrop_treeview#setup)). This event is preventable.
+     * Prevent the default event to stop drag hint creation and further drag events.
      */
     nodeDragStart = new EventEmitter();
     /**
-     * Fires when an item is being dragged ([see example]({% slug draganddrop_treeview %}#toc-setup)).
+     * Fires when an item is being dragged ([see example](slug:draganddrop_treeview#setup)).
      */
     nodeDrag = new EventEmitter();
     /**
-     * Emits when the built-in filtering mechanism in the data-binding directives updates the node's visibility.
-     * Used for the built-in auto-expand functionalities of the component and available for custom implementations.
+     * Emits when the built-in filtering mechanism updates node visibility.
+     * Used for the built-in auto-expand functionalities. Handle this event for custom implementations.
      */
     filterStateChange = new EventEmitter();
     /**
-     * Fires on the target TreeView when a dragged item is dropped ([see example]({% slug draganddrop_treeview %}#toc-setup)).
-     * This event is preventable. If you prevent the event default (`event.preventDefualt()`) or invalidate its state (`event.setValid(false)`),
-     * the `addItem` and `removeItem` events will not be triggered.
+     * Fires on the target TreeView when a dragged item is dropped ([see example](slug:draganddrop_treeview#setup)).
+     *
+     * Prevent the default event (`event.preventDefault()`) or set the event as invalid (`event.setValid(false)`) to stop the `addItem` and `removeItem` events from triggering.
      *
-     * Both operations cancel the default drop operation, but the indication to the user is different. `event.setValid(false)` indicates that the operation was
-     * unsuccessful by animating the drag clue to its original position. `event.preventDefault()` simply removes the clue, as if it has been dropped successfully.
-     * As a general rule, use `preventDefault` to manually handle the add and remove operations, and `setValid(false)` to indicate the operation was unsuccessful.
+     * Use `preventDefault` to handle add/remove manually, or `setValid(false)` to indicate an unsuccessful operation. While `setValid(false)` animates the drag clue to its original position, `event.preventDefault()` simply removes the clue.
      */
     nodeDrop = new EventEmitter();
     /**
-     * Fires on the source TreeView after the dragged item has been dropped ([see example]({% slug draganddrop_treeview %}#toc-setup)).
+     * Fires on the source TreeView after the dragged item is dropped ([see example](slug:draganddrop_treeview#setup)).
      */
     nodeDragEnd = new EventEmitter();
     /**
-     * Fires after a dragged item is dropped ([see example]({% slug draganddrop_treeview %}#toc-setup)).
-     * Called on the TreeView where the item is dropped.
+     * Fires after a dragged item is dropped ([see example](slug:draganddrop_treeview#setup)). Called on the TreeView where the item is dropped.
      */
     addItem = new EventEmitter();
     /**
-     * Fires after a dragged item is dropped ([see example]({% slug draganddrop_treeview %}#toc-setup)).
-     * Called on the TreeView from where the item is dragged.
+     * Fires after a dragged item is dropped ([see example](slug:draganddrop_treeview#setup)). Called on the TreeView from where the item is dragged.
      */
     removeItem = new EventEmitter();
     /**
-     * Fires when the user selects a TreeView node checkbox
-     * ([see example]({% slug checkboxes_treeview %}#toc-modifying-the-checked-state)).
+     * Fires when a TreeView node checkbox is selected ([see example](slug:checkboxes_treeview#toc-modifying-the-checked-state)).
      */
     checkedChange = new EventEmitter();
     /**
-     * Fires when the user selects a TreeView node
-     * ([see example]({% slug selection_treeview %}#toc-modifying-the-selection)).
+     * Fires when a TreeView node is selected ([see example](slug:selection_treeview#toc-modifying-the-selection)).
      */
     selectionChange = new EventEmitter();
     /**
-     * Fires when the value of the built-in filter input element changes.
+     * Fires when the value of the built-in filter input changes.
      */
     filterChange = new EventEmitter();
     /**
-     * Fires when the user clicks a TreeView node.
+     * Fires when a TreeView node is clicked.
      */
     nodeClick = new EventEmitter();
     /**
-     * Fires when the user double clicks a TreeView node.
+     * Fires when a TreeView node is double-clicked.
      */
     nodeDblClick = new EventEmitter();
     /**
@@ -2385,36 +2367,10 @@ class TreeViewComponent {
     /**
      * A function that defines how to track node changes.
      * By default, the TreeView tracks the nodes by data item object reference.
-     *
-     * @example
-     * ```ts
-     *  @Component({
-     *      selector: 'my-app',
-     *      template: `
-     *          <kendo-treeview
-     *              [nodes]="data"
-     *              textField="text"
-     *              [trackBy]="trackBy"
-     *          >
-     *          </kendo-treeview>
-     *      `
-     *  })
-     *  export class AppComponent {
-     *      public data: any[] = [
-     *          { text: "Furniture" },
-     *          { text: "Decor" }
-     *      ];
-     *
-     *      public trackBy(index: number, item: any): any {
-     *          return item.text;
-     *      }
-     *  }
-     * ```
      */
     trackBy = trackBy;
     /**
-     * The nodes which will be displayed by the TreeView
-     * ([see example]({% slug databinding_treeview %})).
+     * The nodes displayed by the TreeView ([see example](slug:databinding_treeview)).
      */
     set nodes(value) {
         this.data.next(value || []);
@@ -2424,15 +2380,12 @@ class TreeViewComponent {
         return this.data.value;
     }
     /**
-     * The fields of the data item that provide the text content of the nodes
-     * ([see example]({% slug databinding_treeview %})). If the `textField` input is set
-     * to an array, each hierarchical level uses the field that corresponds to the same
-     * index in the array, or the last item in the array.
+     * The fields of the data item that provide the text content of the nodes ([see example](slug:databinding_treeview)).
+     * If set to an array, each level uses the field at the same index or the last item in the array.
      */
     textField;
     /**
-     * A function which determines if a specific node has child nodes
-     * ([see example]({% slug databinding_treeview %})).
+     * A function that determines if a node has child nodes ([see example](slug:databinding_treeview)).
      */
     get hasChildren() {
         return this._hasChildren || hasChildren;
@@ -2442,8 +2395,7 @@ class TreeViewComponent {
         this.expandIcons = Boolean(this._isExpanded && this._hasChildren);
     }
     /**
-     * A function which determines if a specific node is checked
-     * ([see example]({% slug checkboxes_treeview %}#toc-modifying-the-checked-state)).
+     * A function that determines if a node is checked ([see example](slug:checkboxes_treeview#toc-modifying-the-checked-state)).
      */
     get isChecked() {
         return this._isChecked || isChecked;
@@ -2453,17 +2405,15 @@ class TreeViewComponent {
         this.checkboxes = Boolean(this._isChecked);
     }
     /**
-     * A function which determines if a specific node is disabled.
+     * A function that determines if a node is disabled.
      */
     isDisabled = isDisabled;
     /**
-     * A function which determines if a specific node has a checkbox.
-     *
-     * > If there is no checkbox for a node, then this node is not checkable and is excluded from any built-in check functionality.
+     * A function that determines if a node has a checkbox. If there is no checkbox, the node is not checkable and is excluded from built-in check functionality.
      */
     hasCheckbox = hasCheckbox;
     /**
-     * A function which determines if a specific node is expanded.
+     * A function that determines if a node is expanded.
      */
     get isExpanded() {
         return this._isExpanded || isExpanded;
@@ -2473,8 +2423,7 @@ class TreeViewComponent {
         this.expandIcons = Boolean(this._isExpanded && this._hasChildren);
     }
     /**
-     * A function which determines if a specific node is selected
-     * ([see example]({% slug selection_treeview %}#toc-modifying-the-selection)).
+     * A function that determines if a node is selected ([see example](slug:selection_treeview#modifying-the-selection)).
      */
     get isSelected() {
         return this._isSelected || isSelected;
@@ -2484,42 +2433,41 @@ class TreeViewComponent {
         this.selectable = Boolean(this._isSelected);
     }
     /**
-     * A callback which determines whether a TreeView node should be rendered as hidden. The utility .k-hidden class is used to hide the nodes.
-     * Useful for custom filtering implementations.
+     * A callback that determines whether a TreeView node should be rendered as hidden. Uses the `.k-hidden` utility class. Useful for custom filtering.
+     *
      */
     isVisible = isVisible;
     /**
-     * Determines whether the TreeView keyboard navigable is enabled.
+     * Enables keyboard navigation for the TreeView.
+     *
+     * @default true
      */
     navigable = true;
     /**
-     * A function which provides the child nodes for a given parent node
-     * ([see example]({% slug databinding_treeview %})).
+     * A function that provides the child nodes for a given parent node ([see example](slug:databinding_treeview)).
      */
     children = () => of([]);
     /**
-     * Indicates whether the child nodes will be fetched on node expand or will be initially prefetched.
+     * Indicates whether child nodes are fetched on expand or initally prefetched.
+     *
      * @default true
      */
     loadOnDemand = true;
     /**
-     * Renders the built-in input element for filtering the TreeView.
-     * If set to `true`, the component emits the `filterChange` event, which can be used to [filter the TreeView manually]({% slug filtering_treeview %}#toc-manual-filtering).
-     * A built-in filtering implementation is available to use with the [`kendoTreeViewHierarchyBinding`]({% slug api_treeview_hierarchybindingdirective %}) and [`kendoTreeViewFlatDataBinding`]({% slug api_treeview_flatdatabindingdirective %}) directives.
+     * Renders the built-in input element for filtering. If `true`, emits the `filterChange` event that can be handled for [manual filtering](slug:filtering_treeview#toc-manual-filtering).
+     * Built-in filtering is available with [`kendoTreeViewHierarchyBinding`](slug:api_treeview_hierarchybindingdirective) and [`kendoTreeViewFlatDataBinding`](slug:api_treeview_flatdatabindingdirective) directives.
+     *
+     * @default false
      */
     filterable = false;
     /**
-     * Sets an initial value of the built-in input element used for filtering.
+     * Sets the initial value of the built-in filter input.
      */
     filter = '';
     /**
      * Sets the size of the component.
      *
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `none`
+     * @default 'medium'
      */
     set size(size) {
         const newSize = size ? size : 'medium';
@@ -2542,7 +2490,8 @@ class TreeViewComponent {
         return `treeview_${this._nextId}`;
     }
     /**
-     * Indicates whether only parent nodes should be disabled or their child nodes as well
+     * Indicates whether only parent nodes should be disabled or their child nodes as well.
+     *
      * @default false
      */
     disableParentNodesOnly = false;
@@ -2643,31 +2592,7 @@ class TreeViewComponent {
         }
     }
     /**
-     * Focuses the first focusable item in the TreeView component if no hierarchical index is provided.
-     *
-     * @example
-     * ```ts
-     * import { Component } from '@angular/core';
-     *
-     *  @Component({
-     *      selector: 'my-app',
-     *      template: `
-     *      <button (click)="treeview.focus('1')">Focuses the second node</button>
-     *      <kendo-treeview
-     *          #treeview
-     *          [nodes]="data"
-     *          textField="text"
-     *      >
-     *      </kendo-treeview>
-     *  `
-     *  })
-     *  export class AppComponent {
-     *      public data: any[] = [
-     *          { text: "Furniture" },
-     *          { text: "Decor" }
-     *      ];
-     *  }
-     * ```
+     * Focuses the first focusable item in the TreeView if no hierarchical index is provided.
      */
     focus(index) {
         const focusIndex = index || nodeIndex(this.navigationService.focusableItem);
@@ -2678,23 +2603,22 @@ class TreeViewComponent {
         }
     }
     /**
-     * Based on the specified index, returns the TreeItemLookup node.
+     * Returns the `TreeItemLookup` node for the specified index.
      *
      * @param index - The index of the node.
-     * @returns {TreeItemLookup} - The item that was searched (looked up).
+     * @returns {TreeItemLookup} - The looked up item.
      */
     itemLookup(index) {
         return this.treeViewLookupService.itemLookup(index);
     }
     /**
-     * Triggers the [`children`]({% slug api_treeview_treeviewcomponent %}#toc-children) function for every expanded node,
-     * causing all rendered child nodes to be fetched again.
+     * Calls the [`children`](slug:api_treeview_treeviewcomponent#children) function for every expanded node and fetches all rendered child nodes again.
      */
     rebindChildren() {
         this.dataChangeNotification.notify();
     }
     /**
-     * Triggers the `expand` event for the provided node and displays it's loading indicator.
+     * Triggers the `expand` event for the provided node and shows its loading indicator.
      */
     expandNode(item, index) {
         this.expandService.expand(index, item);
@@ -2706,23 +2630,19 @@ class TreeViewComponent {
         this.expandService.collapse(index, item);
     }
     /**
-     * Gets the current page size of the checked data item children collection
-     * ([see example]({% slug loadmorebutton_treeview %}#toc-managing-page-sizes)).
-     *
-     * > Since the root nodes collection is not associated with any parent data item, pass `null` as `dataItem` param to get its page size.
+     * Gets the current page size of the data item's children collection ([see example](slug:loadmorebutton_treeview#managing-page-sizes)).
+     * Pass `null` as `dataItem` to get the root collection's page size.
      *
      * @param dataItem {any} - The parent data item of the targeted collection.
-     * @returns {number} - The page size of the checked data item children collection.
+     * @returns {number} - The page size of the data item's children collection.
      */
     getNodePageSize(dataItem) {
         this.verifyLoadMoreService();
         return this.loadMoreService.getGroupSize(dataItem);
     }
     /**
-     * Sets the page size of the targeted data item children collection
-     * ([see example]({% slug loadmorebutton_treeview %}#toc-managing-page-sizes)).
-     *
-     * > Since the root nodes collection is not associated with any parent data item, pass `null` as `dataItem` param to target its page size.
+     * Sets the page size of the data item's children collection ([see example](slug:loadmorebutton_treeview#managing-page-sizes)).
+     * Pass `null` as `dataItem` to set the root collection's page size.
      *
      * @param dataItem {any} - The parent data item of the targeted collection.
      * @param pageSize {number} - The new page size.
@@ -3094,8 +3014,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
+ * ```
  */
 class CheckDirective {
     treeView;
@@ -3107,21 +3037,22 @@ 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();
@@ -3146,7 +3077,7 @@ class CheckDirective {
         'single': (e) => this.checkSingle(e)
     };
     /**
-     * Reflectes the internal `checkedKeys` state.
+     * Reflects the internal `checkedKeys` state.
      */
     state = new Set();
     clickSubscription;
@@ -3386,7 +3317,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * 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 %})).
  */
 class DisableDirective {
@@ -3447,19 +3378,31 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * 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.
+ *
+ * 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.
  *
- * 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.
+ * 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>
+ * ```
  */
 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;
@@ -3499,26 +3442,50 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * 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.
  */
 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 = {}));
 
 /**
- * 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.
  */
 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 = {}));
 
@@ -3554,31 +3521,31 @@ class PreventableEvent {
 }
 
 /**
- * Arguments for the TreeView [`nodeDrop`]({% slug api_treeview_treeviewcomponent %}#toc-nodedrop) event.
+ * Arguments for the TreeView [`nodeDrop`](slug:api_treeview_treeviewcomponent#nodedrop) event.
  */
 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;
     /**
@@ -3594,10 +3561,9 @@ 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;
@@ -3605,15 +3571,15 @@ class TreeItemDropEvent extends PreventableEvent {
 }
 
 /**
- * Arguments for the TreeView [`nodeDragStart`]({% slug api_treeview_treeviewcomponent %}#toc-nodedragstart) event.
+ * Arguments for the TreeView [`nodeDragStart`](slug:api_treeview_treeviewcomponent#nodedragstart) event.
  */
 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;
     /**
@@ -3626,22 +3592,22 @@ class TreeItemDragStartEvent extends PreventableEvent {
 }
 
 /**
- * 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.
  */
 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;
 }
@@ -4312,18 +4278,25 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return []; } });
 
 /**
- * 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.
  *
- * The text, attempted drop action, source item and destination item are available as context variables in the template:
+ * 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 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>
+ * ```
  */
 class DragClueTemplateDirective {
     templateRef;
@@ -4344,15 +4317,24 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
                 }] }]; } });
 
 /**
- * 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.
+ *
+ * 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)).
  *
- * The attempted drop action, source item and destination item are available as context variables in the template:
+ * 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.
  *
- * - `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 kendoTreeViewDropHintTemplate let-action="action">
+ *     Drop action: {{ action }}
+ *   </ng-template>
+ * </kendo-treeview>
+ * ```
  */
 class DropHintTemplateDirective {
     templateRef;
@@ -4378,16 +4360,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#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.
  *
- * 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.
+ * @example
+ * ```html
+ * <kendo-treeview
+ *    kendoTreeViewDragAndDrop
+ *    [dropZoneTreeViews]="treeView"
+ * >
+ * </kendo-treeview>
+ * ```
  */
 class DragAndDropDirective {
     element;
@@ -4396,31 +4387,31 @@ 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
      */
@@ -4696,8 +4687,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>
+ * ```
  */
 class ExpandDirective {
     component;
@@ -4708,12 +4710,12 @@ 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;
@@ -4722,16 +4724,16 @@ 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();
@@ -5171,12 +5173,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>
+ * ```
  */
 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)
@@ -5187,11 +5204,11 @@ 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;
     /**
@@ -5382,13 +5399,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>
+ * ```
  */
 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) {
@@ -5397,13 +5428,13 @@ 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)
@@ -5496,15 +5527,27 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 
 const LOAD_MORE_DOC_LINK = 'https://www.telerik.com/kendo-angular-ui/components/treeview/load-more-button/';
 /**
- * A directive that enables the display of only a limited amount of nodes per level
- * ([see example]({% slug loadmorebutton_treeview %})).
+ * Represents the directive that enables you to display only a limited number of nodes per level
+ * ([see example](slug:loadmorebutton_treeview)).
+ *
+ * @example
+ * ```html
+ * <kendo-treeview
+ *    ...
+ *    kendoTreeViewLoadMore
+ *    [pageSize]="10"
+ *    [totalRootNodes]="100"
+ *    totalField="totalChildren">
+ * </kendo-treeview>
+ * ```
  */
 class LoadMoreDirective {
     treeview;
     /**
-     * Specifies the callback that will be called when the load more button is clicked.
-     * Providing a function is only required when additional nodes are fetched on demand
-     * ([see example]({% slug loadmorebutton_treeview %}#toc-remote-data)).
+     * Sets the callback function that runs when the load more button is clicked.
+     * Provide a function when you fetch additional nodes on demand
+     * ([see example](slug:loadmorebutton_treeview#remote-data)).
+     *
      */
     set loadMoreNodes(loadMoreNodes) {
         if (typeof loadMoreNodes === 'string') {
@@ -5513,20 +5556,20 @@ class LoadMoreDirective {
         this.treeview.loadMoreService.loadMoreNodes = loadMoreNodes;
     }
     /**
-     * Specifies the initial number of nodes that will be rendered on each level.
-     * Every time the load more button is clicked, the data item page size will be incremented with this number.
+     * Sets the initial number of nodes to render on each level.
+     * Each time the load more button is clicked, the page size increases by this number.
      */
     pageSize;
     /**
-     * Specifies the total number of root nodes.
-     * Used when additional nodes are fetched on demand
-     * ([see example]({% slug loadmorebutton_treeview %}#toc-remote-data)).
+     * Sets the total number of root nodes.
+     * Use this property when you fetch additional nodes on demand
+     * ([see example](slug:loadmorebutton_treeview#remote-data)).
      */
     totalRootNodes;
     /**
-     * Specifies which field holds information about the total number of child nodes of the data item.
-     * Used when additional nodes are fetched on demand
-     * ([see example]({% slug loadmorebutton_treeview %}#toc-remote-data)).
+     * Sets the field that contains the total number of child nodes for the data item.
+     * Use this property when you fetch additional nodes on demand
+     * ([see example](slug:loadmorebutton_treeview#remote-data)).
      */
     totalField;
     /**
@@ -5608,7 +5651,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * Custom component messages override default component messages
+ * Represents the custom messages component of the TreeView.
+ *
+ * Use this component to override default messages for the TreeView.
+ *
+ * @example
+ * ```html
+ * <kendo-treeview-messages
+ *     loadMore="Load more items">
+ * </kendo-treeview-messages>
+ * ```
  */
 class CustomMessagesComponent extends TreeViewMessages {
     service;
@@ -5643,8 +5695,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1.LocalizationService }]; } });
 
 /**
- * A directive which manages the in-memory selection state of the TreeView node
- * ([see example]({% slug selection_treeview %})).
+ * Manages the in-memory selection state of TreeView nodes
+ * ([see example](slug:selection_treeview)).
+ *
+ * @example
+ * ```html
+ * <kendo-treeview
+ *    ...
+ *    kendoTreeViewSelectable
+ *    selectBy="id"
+ *    [(selectedKeys)]="selectedKeys"
+ * >
+ * </kendo-treeview>
+ * ```
  */
 class SelectDirective {
     treeView;
@@ -5656,21 +5719,21 @@ class SelectDirective {
         this.treeView.isSelected = value;
     }
     /**
-     * Defines the item key that will be stored in the `selectedKeys` collection.
+     * Sets the item key stored in the `selectedKeys` collection.
      */
     selectKey;
     /**
-     * Defines the current selection mode
-     * ([see example](slug:selection_treeview#toc-modes)).
+     * Sets the current selection mode
+     * ([see example](slug:selection_treeview#modes)).
      */
     selection;
     /**
-     * Defines the collection that will store the selected keys
+     * Defines the collection that stores the selected keys
      * ([see example](slug:selection_treeview#toc-modes)).
      */
     selectedKeys;
     /**
-     * Fires when the `selectedKeys` collection was updated.
+     * Emits when the `selectedKeys` collection updates.
      */
     selectedKeysChange = new EventEmitter();
     get getAriaMultiselectable() {
@@ -5693,7 +5756,7 @@ class SelectDirective {
         'single': (e) => this.selectSingle(e)
     };
     /**
-     * Reflectes the internal `selectedKeys` state.
+     * Reflects the internal `selectedKeys` state.
      */
     state = new Set();
     /**
@@ -5791,7 +5854,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * 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 {}
+ * ```
  */
 const KENDO_TREEVIEW = [
     TreeViewComponent,
@@ -5814,6 +5891,21 @@ const KENDO_TREEVIEW = [
 //IMPORTANT: NgModule export kept for backwards compatibility
 /**
  * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi']) definition for the TreeView component.
+ *
+ * @example
+ * ```ts
+ * import { NgModule } from '@angular/core';
+ * import { BrowserModule } from '@angular/platform-browser';
+ * import { TreeViewModule } from '@progress/kendo-angular-treeview';
+ * import { AppComponent } from './app.component';
+ *
+ * @NgModule({
+ *   imports: [BrowserModule, TreeViewModule],
+ *   declarations: [AppComponent],
+ *   bootstrap: [AppComponent]
+ * })
+ * export class AppModule {}
+ * ```
  */
 class TreeViewModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: TreeViewModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });