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

package/esm2022/load-more/load-more-button-template.directive.mjs

@@ -5,14 +5,22 @@
 import { Optional, Directive, TemplateRef } from "@angular/core";
 import * as i0 from "@angular/core";
 /**
- * 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.
  *
- * The hierarchical index of the load more button node is available as a context variable:
+ * 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)).
  *
- * - `let-index="index"` (`string`)
+ * The template context provides the following variable:
+ * - `let-index="index"`&mdash;The hierarchical index of the load more button node.
+ *
+ * @example
+ * ```html
+ * <kendo-treeview>
+ *   <ng-template kendoTreeViewLoadMoreButtonTemplate let-index="index">
+ *     Load more at {{ index }}
+ *   </ng-template>
+ * </kendo-treeview>
+ * ```
  */
 export class LoadMoreButtonTemplateDirective {
     templateRef;

package/esm2022/load-more/load-more.directive.mjs

@@ -10,15 +10,27 @@ import * as i0 from "@angular/core";
 import * as i1 from "../treeview.component";
 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>
+ * ```
  */
 export 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') {
@@ -27,20 +39,20 @@ export 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;
     /**

package/esm2022/localization/custom-messages.component.mjs

@@ -8,7 +8,16 @@ import { LocalizationService } from "@progress/kendo-angular-l10n";
 import * as i0 from "@angular/core";
 import * as i1 from "@progress/kendo-angular-l10n";
 /**
- * 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>
+ * ```
  */
 export class CustomMessagesComponent extends TreeViewMessages {
     service;

package/esm2022/localization/messages.mjs

@@ -10,7 +10,7 @@ import * as i0 from "@angular/core";
  */
 export 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 });

package/esm2022/node-template.directive.mjs

@@ -5,57 +5,25 @@
 import { Optional, Directive, TemplateRef } from "@angular/core";
 import * as i0 from "@angular/core";
 /**
- * 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>
  * ```
  */
 export class NodeTemplateDirective {

package/esm2022/package-metadata.mjs

@@ -10,7 +10,7 @@ export const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749820447,
-    version: '19.1.2-develop.2',
+    publishDate: 1750152519,
+    version: '19.1.2-develop.3',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };

package/esm2022/selection/select.directive.mjs

@@ -12,8 +12,19 @@ import * as i0 from "@angular/core";
 import * as i1 from "../treeview.component";
 import * as i2 from "../navigation/navigation.service";
 /**
- * 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>
+ * ```
  */
 export class SelectDirective {
     treeView;
@@ -25,21 +36,21 @@ export 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() {
@@ -62,7 +73,7 @@ export class SelectDirective {
         'single': (e) => this.selectSingle(e)
     };
     /**
-     * Reflectes the internal `selectedKeys` state.
+     * Reflects the internal `selectedKeys` state.
      */
     state = new Set();
     /**

package/esm2022/treeview.component.mjs

@@ -62,8 +62,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>
+ * ```
  */
 export class TreeViewComponent {
     element;
@@ -95,16 +106,17 @@ export 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;
@@ -119,79 +131,73 @@ export 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();
     /**
@@ -235,36 +241,10 @@ export 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 || []);
@@ -274,15 +254,12 @@ export 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;
@@ -292,8 +269,7 @@ export 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;
@@ -303,17 +279,15 @@ export 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;
@@ -323,8 +297,7 @@ export 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;
@@ -334,42 +307,41 @@ export 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';
@@ -392,7 +364,8 @@ export 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;
@@ -493,31 +466,7 @@ export 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);
@@ -528,23 +477,22 @@ export 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);
@@ -556,23 +504,19 @@ export 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.