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

package/check-mode.d.ts

@@ -3,9 +3,10 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Represents the available check modes of the TreeView
- * ([see example]({% slug checkboxes_treeview %})).
+ * Represents the available check modes for the TreeView component ([see example](slug:checkboxes_treeview)).
  *
- * <demo metaUrl="treeview/checkable/check-mode/" height="300"></demo>
+ * The possible values are:
+ * * `"single"`&mdash;Only one item can be checked at a time.
+ * * `"multiple"`&mdash;Multiple items can be checked.
  */
 export type CheckMode = "single" | "multiple";

package/check.directive.d.ts

@@ -11,8 +11,18 @@ import { TreeItem } from './treeitem.interface';
 import { TreeItemLookup } from './treeitem-lookup.interface';
 import * as i0 from "@angular/core";
 /**
- * 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 declare class CheckDirective implements OnChanges, OnDestroy {
     protected treeView: TreeViewComponent;
@@ -22,28 +32,29 @@ export declare class CheckDirective implements OnChanges, OnDestroy {
      */
     set isChecked(value: (item: object, index: string) => CheckedState);
     /**
-     * Defines the item key that will be stored in the `checkedKeys` collection.
+     * Defines the item key stored in the `checkedKeys` collection.
      */
     checkKey: string | ((context: TreeItem) => any);
     /**
-     * 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: any[];
     /**
-     * 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: boolean | CheckableSettings | string;
     /**
-     * Fires when the `checkedKeys` collection was updated.
+     * Fires when the `checkedKeys` collection updates.
      */
     checkedKeysChange: EventEmitter<any[]>;
     protected subscriptions: Subscription;
     private get options();
     private checkActions;
     /**
-     * Reflectes the internal `checkedKeys` state.
+     * Reflects the internal `checkedKeys` state.
      */
     private state;
     private clickSubscription;

package/checkable-settings.d.ts

@@ -4,52 +4,47 @@
 *-------------------------------------------------------------------------------------------*/
 import { CheckMode } from './check-mode';
 /**
- * The checkable settings of the TreeView
- * ([see example]({% slug checkboxes_treeview %})).
+ * Configures the checkbox selection behavior of the TreeView component ([see example](slug:checkboxes_treeview)).
  *
- * <demo metaUrl="treeview/checkable/basic/" height="610"></demo>
  */
 export interface CheckableSettings {
     /**
-     * Determines if a checkbox selection is allowed.
+     * Determines if checkbox selection is enabled.
      * @default true
      */
     enabled?: boolean;
     /**
-     * The available values are:
-     * * `"single"`
-     * * `"multiple"`
-     *
+     * Specifies the selection mode.
      * @default 'multiple'
      */
     mode?: CheckMode;
     /**
-     * Determines whether to automatically check the children nodes.
-     * > The option works only together with the multiple selection mode.
+     * Determines whether checking a parent node automatically checks its children.
+     * Only applicable in multiple selection mode.
      * @default true
      */
     checkChildren?: boolean;
     /**
-     * Determines whether to display the indeterminate state for the parent nodes.
-     * > The option works only together with the multiple selection mode.
+     * Determines whether parent nodes display an indeterminate state when only some children are checked.
+     * Only applicable in multiple selection mode.
      * @default true
      */
     checkParents?: boolean;
     /**
-     * Specifies if on clicking the node, the item will be checked or unchecked.
+     * Determines whether clicking a node toggles its checked state.
      * @default false
      */
     checkOnClick?: boolean;
     /**
-     * Determines whether disabled children will be checked if their parent is checked.
-     * > The option works only together with the multiple selection mode and `checkChildren: true`.
+     * Determines whether disabled children are checked when their parent is checked.
+     * Only applicable in multiple selection mode and when `checkChildren` is `true`.
      * @default false
-    */
+     */
     checkDisabledChildren?: boolean;
     /**
-     * Determines whether collapsed children should be unchecked when unchecking their parent.
-     * > The option works only together with the multiple selection mode and when [`loadOnDemand`]({% slug api_treeview_treeviewcomponent %}#toc-loadondemand) is `true`.
+     * Determines whether collapsed children are unchecked when their parent is unchecked.
+     * Only applicable in multiple selection mode and when [`loadOnDemand`](slug:api_treeview_treeviewcomponent#loadondemand) is `true`.
      * @default false
-    */
+     */
     uncheckCollapsedChildren?: boolean;
 }

package/checkbox/checked-state.d.ts

@@ -3,6 +3,6 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * The checked state of the CheckBox component.
+ * Represents the checked state of the CheckBox component.
  */
 export type CheckedState = 'none' | 'indeterminate' | 'checked';

package/directives.d.ts

@@ -18,6 +18,20 @@ 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 declare const KENDO_TREEVIEW: readonly [typeof TreeViewComponent, typeof NodeTemplateDirective, typeof CheckDirective, typeof DisableDirective, typeof ExpandDirective, typeof SelectDirective, typeof HierarchyBindingDirective, typeof FlatDataBindingDirective, typeof DragAndDropDirective, typeof DragClueTemplateDirective, typeof DropHintTemplateDirective, typeof DragAndDropEditingDirective, typeof LoadMoreDirective, typeof LoadMoreButtonTemplateDirective, typeof CustomMessagesComponent];

package/disable.directive.d.ts

@@ -7,7 +7,7 @@ import { TreeViewComponent } from './treeview.component';
 import { TreeItem } from './treeitem.interface';
 import * as i0 from "@angular/core";
 /**
- * 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 declare class DisableDirective implements OnChanges {

package/drag-and-drop/drag-and-drop-editing.directive.d.ts

@@ -7,19 +7,31 @@ import { TreeViewComponent } from '../treeview.component';
 import { EditService } from './models';
 import * as i0 from "@angular/core";
 /**
- * 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 declare class DragAndDropEditingDirective implements OnDestroy {
     private 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: EditService);
     private subscriptions;

package/drag-and-drop/drag-and-drop.directive.d.ts

@@ -12,16 +12,25 @@ import { TreeViewComponent } from '../treeview.component';
 import { DragAndDropScrollSettings } from './models';
 import * as i0 from "@angular/core";
 /**
- * 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 declare class DragAndDropDirective implements AfterContentInit, OnDestroy {
     private element;
@@ -30,31 +39,31 @@ export declare class DragAndDropDirective implements AfterContentInit, OnDestroy
     private dragClueService;
     private 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: boolean;
     /**
-     * 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: TreeViewComponent[];
     /**
-     * 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: number;
     /**
-     * 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/drag-and-drop/drag-clue/drag-clue-template.directive.d.ts

@@ -5,18 +5,25 @@
 import { 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 declare class DragClueTemplateDirective {
     templateRef: TemplateRef<any>;

package/drag-and-drop/drop-hint/drop-hint-template.directive.d.ts

@@ -5,15 +5,24 @@
 import { 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 declare class DropHintTemplateDirective {
     templateRef: TemplateRef<any>;

package/drag-and-drop/models/drop-action.d.ts

@@ -3,14 +3,29 @@
 * 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 declare enum DropAction {
+    /**
+     * The dragged item is added as a child to the target node.
+     */
     Add = 0,
+    /**
+     * The dragged item is inserted above the target node at the same level.
+     */
     InsertTop = 1,
+    /**
+     * The dragged item is inserted below the target node at the same level.
+     */
     InsertBottom = 2,
+    /**
+     * The dragged item is inserted in the middle position relative to the target node.
+     */
     InsertMiddle = 3,
+    /**
+     * The drop action is not valid for the current target location.
+     */
     Invalid = 4
 }

package/drag-and-drop/models/drop-position.d.ts

@@ -3,10 +3,19 @@
 * 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 declare enum DropPosition {
+    /**
+     * The item is dropped over the target item.
+     */
     Over = 0,
+    /**
+     * The item is dropped before the target item.
+     */
     Before = 1,
+    /**
+     * The item is dropped after the target item.
+     */
     After = 2
 }

package/drag-and-drop/models/editing-service.d.ts

@@ -4,18 +4,18 @@
 *-------------------------------------------------------------------------------------------*/
 import { TreeItemAddRemoveArgs } from './treeitem-add-remove-args';
 /**
- * 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.
+ *
+ * Implement this interface to handle the addition and removal of items during drag-and-drop operations in the TreeView.
  */
 export interface EditService {
     /**
-     * The event handler called when the drag-and-drop
-     * [`addItem`]({% slug api_treeview_treeviewcomponent %}#toc-additem) event is fired.
+     * Called when an item is added via drag-and-drop. Represents the event handler of the [`addItem`](slug:api_treeview_treeviewcomponent#additem) event.
      */
     add: (args: TreeItemAddRemoveArgs) => void;
     /**
-     * The event handler called when the drag-and-drop
-     * [`removeItem`]({% slug api_treeview_treeviewcomponent %}#toc-removeitem) event is fired.
+     * Called when an item is removed via drag-and-drop. Represents the event handler of the [`removeItem`](slug:api_treeview_treeviewcomponent#removeitem) event.
      */
     remove: (args: TreeItemAddRemoveArgs) => void;
 }

package/drag-and-drop/models/scroll-settings.d.ts

@@ -3,25 +3,25 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Defines the auto-scrolling behavior during drag-and-drop.
- * When enbaled, the first scrollable container going from the TreeView and up will be scrolled
- * when the dragged item reaches the top of that container or its bottom.
+ * Defines the auto-scrolling behavior during drag-and-drop operations in the TreeView.
+ * When enabled, the first scrollable container above the TreeView will scroll automatically
+ * when the dragged item reaches the top or bottom edge of that container.
  */
 export interface DragAndDropScrollSettings {
     /**
-     * Controlls whether scrolling is enabled.
+     * Determines whether auto-scrolling is enabled during drag-and-drop.
      *
      * @default true
      */
     enabled?: boolean;
     /**
-     * Specifies the step (in pixels) by which the scrolling will be performed.
+     * The number of pixels to scroll per step.
      *
      * @default 1
      */
     step?: number;
     /**
-     * Specifies the interval (in milliseconds) in which the scrolling will be performed.
+     * The interval in milliseconds between scroll steps.
      *
      * @default 1
      */

package/drag-and-drop/models/tree-item-filter-state.d.ts

@@ -3,12 +3,13 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * These objects wrap each hierarchical node of the component.
- * Represents a lookup structure which persists information about the current node, its filter state, parent and child nodes. Used in the [`filterStateChange`]({% slug api_treeview_treeviewcomponent %}#toc-filterstatechange).
+ * Represents a hierarchical node in the TreeView filter state.
+ * Used as a lookup structure to persist information about the current node, its filter state, parent, and child nodes.
+ * Utilized in the [`filterStateChange`](slug:api_treeview_treeviewcomponent#filterstatechange) event.
  */
 export interface TreeItemFilterState {
     /**
-     * The dataItem of the node.
+     * The data item associated with the node.
      */
     dataItem: any;
     /**
@@ -16,25 +17,25 @@ export interface TreeItemFilterState {
      */
     index: string;
     /**
-     * The node's parent node.
+     * The parent of the current node.
      */
     parent: TreeItemFilterState;
     /**
-     * The node's child nodes.
+     * The child nodes of the current node.
      */
     children?: TreeItemFilterState[];
     /**
-     * Whether the node is a filter match.
+     * Indicates whether the node matches the current filter.
      */
     isMatch?: boolean;
     /**
-     * Whether the node is visible or filtered out.
-     * Sometimes a node is visible but is not a match.
-     * For example, it's part of the parent chain of a match, or a child of a matching node in lenient filter mode.
+     * Determines whether the node is visible or hidden by the filter.
+     * A node can be visible even if it does not directly match the filter.
+     * For example, the node is visible if it is a parent of a matching node or a child of a matching node in `"lenient"` filter mode.
      */
     visible: boolean;
     /**
-     * Whether one of the node's children is a match or contains matches.
+     * Determines whether any child node matches the filter or contains matching nodes.
      */
     containsMatches?: boolean;
 }

package/drag-and-drop/models/treeitem-add-remove-args.d.ts

@@ -6,28 +6,28 @@ import { TreeViewComponent } from '../../treeview.component';
 import { TreeItemLookup } from '../../treeitem-lookup.interface';
 import { DropPosition } from './drop-position';
 /**
- * Describes the information emitted on [`addItem`]({% slug api_treeview_treeviewcomponent %}#toc-additem)
- * and [`removeItem`]({% slug api_treeview_treeviewcomponent %}#toc-removeitem) events during drag-and-drop.
+ * Provides information for TreeView drag-and-drop [`addItem`](slug:api_treeview_treeviewcomponent#additem)
+ * and [`removeItem`](slug:api_treeview_treeviewcomponent#removeitem) events.
  */
 export interface 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;
 }

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

@@ -4,22 +4,22 @@
 *-------------------------------------------------------------------------------------------*/
 import { TreeItemLookup } from '../../treeitem-lookup.interface';
 /**
- * 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 declare class TreeItemDragEvent {
     /** @hidden */
     constructor();
     /**
-     * The look-up info for the dragged item.
+     * Lookup information for the dragged item.
      */
     sourceItem: TreeItemLookup;
     /**
-     * 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: TreeItemLookup;
     /**
-     * The original pointer event holding details about the current pointer position.
+     * The original pointer event containing details about the pointer position.
      */
     originalEvent: PointerEvent;
 }

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

@@ -5,15 +5,15 @@
 import { TreeItemLookup } from '../../treeitem-lookup.interface';
 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 declare class TreeItemDragStartEvent extends PreventableEvent {
     /**
-     * The look-up info for the dragged item.
+     * Lookup information for the dragged item.
      */
     sourceItem: TreeItemLookup;
     /**
-     * The original pointer event holding details about the current pointer position.
+     * The original pointer event containing details about the pointer position.
      */
     originalEvent: PointerEvent;
     /**