@progress/kendo-angular-utils 19.1.2-develop.4 → 19.1.2-develop.5

package/drag-and-drop/events/drag-target/start-event.d.ts

@@ -5,15 +5,16 @@
 import { NormalizedDragEvent } from '@progress/kendo-draggable-common';
 import { PreventableEvent } from '@progress/kendo-angular-common';
 /**
- * Arguments for the dragStart event of the DragTarget and DragTargetContainer.
+ * Arguments for the `dragStart` event of the `DragTarget` and `DragTargetContainer`.
  */
 export declare class DragTargetDragStartEvent extends PreventableEvent {
     /**
-     * The normalized drag event.
+     * The information related to the current drag event.
+     * This is the normalized drag event that contains details about the drag operation.
      */
     dragEvent: NormalizedDragEvent;
     /**
-     * The DOM element that is being dragged.
+     * The DOM element being dragged.
      */
     dragTarget: HTMLElement;
     /**
@@ -21,7 +22,7 @@ export declare class DragTargetDragStartEvent extends PreventableEvent {
      */
     dragTargetId?: any;
     /**
-     * The index of the current drag target in the collection of drag targets (applicable for the `DragTargetContainer` directive).
+     * The index of the current drag target in the collection of drag targets. Applies to `DragTargetContainer` directive.
      */
     dragTargetIndex?: number;
     /**

package/drag-and-drop/events/drop-target-event.d.ts

@@ -4,7 +4,7 @@
 *-------------------------------------------------------------------------------------------*/
 import { NormalizedDragEvent } from "@progress/kendo-draggable-common";
 /**
- * Arguments for the drag events of the DropTarget and DropTargetContainer directives.
+ * Arguments for the drag events of the `DropTarget` and `DropTargetContainer` directives.
  */
 export declare class DropTargetEvent {
     /**
@@ -24,11 +24,11 @@ export declare class DropTargetEvent {
      */
     dragData: any;
     /**
-     * The index of the current drop target in the collection of drop targets (applicable for the `DropTargetContainer` directive).
+     * The index of the current drop target in the collection of drop targets. Applies to `DropTargetContainer` directive.
      */
     dropTargetIndex?: number;
     /**
-     * The hint of the DragTarget.
+     * The hint element of the `DragTarget`.
      */
     hintElement?: HTMLElement;
     /**

package/drag-and-drop/models/autoscroll-options.d.ts

@@ -5,19 +5,19 @@
 import { ElementRef } from "@angular/core";
 import { ScrollDirection } from "./scroll-direction";
 /**
- * Represents additional configuration options for the autoScroll functionality of the DragTarget.
+ * Represents additional configuration options for the autoScroll feature of the DragTarget.
  */
 export interface AutoScrollOptions {
     /**
-     * Overrides the calculated element used for boundary detection, used to calculate the autoScroll velocity.
+     * Sets the element for boundary detection. Used to calculate the autoScroll velocity.
      */
     boundaryElementRef?: ElementRef;
     /**
-     * Specifies the direction of the autoScroll functionality.
+     * Sets the direction for the autoScroll feature.
      */
     direction?: ScrollDirection;
     /**
-     * Specifies whether the autoScroll functionality will be enabled.
+     * Enables or disables the autoScroll feature.
      */
     enabled?: boolean;
 }

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

@@ -3,20 +3,18 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Represents the callback that is used by the `dragData` property of the [`DragTarget`]({% slug api_utils_dragtargetdirective %}) and [`DragTargetContainer`]({% slug api_utils_dragtargetcontainerdirective %}) directives.
- *
+ * Represents the callback used by the `dragData` property of the [`DragTarget`]({% slug api_utils_dragtargetdirective %}) and [`DragTargetContainer`]({% slug api_utils_dragtargetcontainerdirective %}) directives.
  * It returns the custom data that will be available in the events of the respective [`DropTarget`]({% slug api_utils_droptargetdirective %}) or [`DropTargetContainer`]({% slug api_utils_droptargetcontainerdirective %}) directives upon interaction.
  *
  */
 export type DragTargetDataFn = (args: DragTargetDataArgs) => any;
 /**
- * Represents the callback that is used by the `dragTargetId` property of the [`DragTargetContainer`]({% slug api_utils_dragtargetcontainerdirective %}) directive.
- *
+ * Represents the callback used by the `dragTargetId` property of the [`DragTargetContainer`]({% slug api_utils_dragtargetcontainerdirective %}) directive.
  * It returns a custom identifier that will be available in the events of the respective directive upon its interaction with a valid DropTarget.
  */
 export type DragTargetIdFn = (args: DragTargetIdArgs) => any;
 /**
- * Represents the callback arguments used by the `dragData` property.
+ * Represents the callback arguments for the `dragData` property.
  */
 export interface DragTargetDataArgs {
     /**
@@ -24,16 +22,16 @@ export interface DragTargetDataArgs {
      */
     dragTarget: HTMLElement;
     /**
-     * The drag target unique identifier, result from executing the callback used by the `dragTargetId` property. Applicable for the `DragTargetContainerDirective`.
+     * The drag target unique identifier, result from executing the callback used by the `dragTargetId` property. Applies to `DragTargetContainerDirective`.
      */
     dragTargetId: any;
     /**
-     * The index of the current drag target in the collection of drag targets. Applicable for the `DragTargetContainerDirective`.
+     * The index of the current drag target in the collection. Applies to `DragTargetContainerDirective`.
      */
     dragTargetIndex: number;
 }
 /**
- * Represents the callback arguments used by the `dragTargetId` property.
+ * Represents the callback arguments for the `dragTargetId` property.
  */
 export interface DragTargetIdArgs {
     /**
@@ -41,7 +39,7 @@ export interface DragTargetIdArgs {
      */
     dragTarget: HTMLElement;
     /**
-     * The index of the current drag target in the collection of drag targets. Applicable for the `DragTargetContainerDirective`.
+     * The index of the current drag target in the collection. Applies to `DragTargetContainerDirective`.
      */
     dragTargetIndex: number;
 }

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

@@ -8,15 +8,15 @@ import { TemplateRef, ViewContainerRef } from "@angular/core";
  */
 export interface HintSettings {
     /**
-     * Renders the passed template as a hint of the current DragTarget.
+     * Renders the given template as a hint for the current drag target.
      */
     hintTemplate?: TemplateRef<any>;
     /**
-     * The CSS classes that will be rendered on the hint host element when the default hint is utilized. Supports the type of values that are supported by [ngClass](link:site.data.urls.angular['ngclassapi']).
+     * Sets the CSS classes for the hint host element when using the default hint. Supports values accepted by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
      */
     hintClass?: any;
     /**
-     * Controls the hint container. By default, the hint will be appended to the document body.
+     * Controls the hint container. By default, the hint is appended to the document body.
      */
     appendTo?: ViewContainerRef;
 }

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

@@ -2,6 +2,9 @@
 * Copyright © 2025 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
+/**
+ * Represents the autoscroll direction during drag-and-drop operations.
+ */
 export interface ScrollDirection {
     horizontal: boolean;
     vertical: boolean;

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

@@ -10,34 +10,22 @@ import * as i4 from "./drag-and-drop/dragtarget-container.directive";
 import * as i5 from "./drag-and-drop/droptarget-container.directive";
 import * as i6 from "./drag-and-drop/hint.component";
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmodules'])
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmodules'])
  * definition for the Drag and Drop directives.
  *
  * @example
- *
- * ```ts-no-run
- * // Import the DragAndDrop module
+ * ```ts
  * import { DragAndDropModule } from '@progress/kendo-angular-utils';
- *
- * // The browser platform with a compiler
  * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
- *
  * import { NgModule } from '@angular/core';
- *
- * // Import the app component
  * import { AppComponent } from './app.component';
  *
- * // Define the app module
- * _@NgModule({
- *     declarations: [AppComponent], // declare app component
- *     imports:      [BrowserModule, DragAndDropModule], // import DragAndDropModule module
+ * @NgModule({
+ *     declarations: [AppComponent],
+ *     imports:      [BrowserModule, DragAndDropModule],
  *     bootstrap:    [AppComponent]
  * })
  * export class AppModule {}
- *
- * // Compile and launch the module
- * platformBrowserDynamic().bootstrapModule(AppModule);
- *
  * ```
  */
 export declare class DragAndDropModule {

package/esm2022/adaptive-breakpoints/adaptive-settings.mjs

@@ -4,17 +4,17 @@
 *-------------------------------------------------------------------------------------------*/
 import { InjectionToken } from '@angular/core';
 /**
- * A token that specifies the AdaptiveSettings of the Kendo UI for Angular components.
+ * A token that specifies the `AdaptiveSettings` for Kendo UI for Angular components.
  *
+ * @example
  * ```ts
  * import { NgModule } from '@angular/core';
  *
  * @NgModule({
- * ...
- * providers: [{ provide: ADAPTIVE_SETTINGS, useValue: { small: 400, medium: 600 }}]
+ *   ...,
+ *   providers: [{ provide: ADAPTIVE_SETTINGS, useValue: { small: 400, medium: 600 } }]
  * })
  * export class AppModule {}
  * ```
- *
  */
 export const ADAPTIVE_SETTINGS = new InjectionToken('Kendo UI Adaptive-Settings token');

package/esm2022/adaptive-breakpoints/adaptive-settings.service.mjs

@@ -6,7 +6,7 @@ import { Injectable } from '@angular/core';
 import { Subject } from 'rxjs';
 import * as i0 from "@angular/core";
 /**
- * A service that allows changing the current adaptive settings dynamically. Use the public `notify` method to implement this.
+ * A service that lets you change the current adaptive settings dynamically. Use the public `notify` method to update the settings.
  */
 export class AdaptiveSettingsService {
     /**
@@ -14,7 +14,7 @@ export class AdaptiveSettingsService {
      */
     changes = new Subject();
     /**
-     * Notifies subscribers that the adaptive settings were changed.
+     * Notifies subscribers that the adaptive settings have changed.
      *
      * @param adaptiveSettings - (Optional) A new value for the adaptive settings token.
      */

package/esm2022/adaptive-breakpoints/adaptive.service.mjs

@@ -15,21 +15,17 @@ const DEFAULT_ADAPTIVE_SETTINGS = {
     medium: 768
 };
 /**
- * The service responsible for handling changes in the adaptive settings. Should be included in the providers array when implementing the functionality in a standalone component.
+ * The service responsible for handling changes in adaptive settings. Add it to the providers array when using adaptive breakpoints in a standalone component.
  *
  * @example
- *
- * ```ts-no-run
- * // Import the AdaptiveService
+ * ```ts
  * import { AdaptiveService } from '@progress/kendo-angular-utils';
  *
- * // Define a standalone component
  * @Component({
- *  selector: my-component,
- *  standalone: true,
- *  imports: [ ... ],
- *  providers: [AdaptiveService, { provide: ADAPTIVE_SETTINGS , useValue: { small: 300 } }],
- *  template: ...
+ *   selector: 'my-component',
+ *   standalone: true,
+ *   providers: [AdaptiveService, { provide: ADAPTIVE_SETTINGS, useValue: { small: 300 } }],
+ *   template: '...'
  * })
  * export class AppComponent {}
  * ```

package/esm2022/directives.mjs

@@ -9,7 +9,24 @@ import { DropTargetContainerDirective } from "./drag-and-drop/droptarget-contain
 import { DropTargetDirective } from "./drag-and-drop/droptarget.directive";
 import { HintComponent } from "./drag-and-drop/hint.component";
 /**
- * Utility array that contains all `Drag and Drop` related components and directives
+ * Use this utility array to access all Drag and Drop-related components and directives in a standalone Angular component.
+ *
+ * @example
+ * ```typescript
+ * import { Component } from '@angular/core';
+ * import { KENDO_DRAGANDDROP } from '@progress/kendo-angular-utils';
+ *
+ * @Component({
+ *   selector: 'my-app',
+ *   standalone: true,
+ *   imports: [KENDO_DRAGANDDROP],
+ *   template: `
+ *      <div kendoDragTarget>Drag me</div>
+ *      <div kendoDropTarget>Drop here</div>
+ *   `
+ * })
+ * export class AppComponent {}
+ * ```
  */
 export const KENDO_DRAGANDDROP = [
     DragTargetDirective,
@@ -20,8 +37,8 @@ export const KENDO_DRAGANDDROP = [
     HintComponent
 ];
 /**
-* Utility array that contains all `@progress/kendo-angular-utils` related components and directives.
-* > As of now, `KENDO_UTILS` includes only the `KENDO_DRAGANDDROP` utility array and their usage is equivalent.
+* Use this utility array to access all `@progress/kendo-angular-utils`-related components and directives in a standalone Angular component.
+* > Currently, `KENDO_UTILS` includes only the `KENDO_DRAGANDDROP` utility array and their usage is equivalent.
 */
 export const KENDO_UTILS = [
     ...KENDO_DRAGANDDROP

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

@@ -6,13 +6,21 @@ import { Directive, ElementRef, HostBinding, Input } from "@angular/core";
 import * as i0 from "@angular/core";
 /**
  * Represents the Kendo UI DragHandle directive for Angular.
- * It is used to specify a concrete element within a drag target as a handle for dragging, instead the drag target itself.
+ * Use this directive to specify an element inside a drag target as a handle for dragging instead of the drag target itself.
+ *
+ * ```html
+ * <div kendoDragTarget>
+ *  <button kendoDragHandle kendoButton>
+ *   Drag me
+ *  </button>
+ * </div>
+ * ```
  */
 export class DragHandleDirective {
     element;
     touchActionStyle = 'none';
     /**
-     * Specifies the cursor style of the drag handle. Accepts same values as the [CSS `cursor` property](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#values).
+     * Sets the cursor style of the drag handle. Accepts same values as the [CSS `cursor` property](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#values).
      *
      * @default 'move'
      */

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

@@ -17,12 +17,14 @@ let isDragStartPrevented = false;
 let isDragPrevented = false;
 /**
  * Represents the [Kendo UI DragTargetContainer directive for Angular]({% slug api_utils_dragtargetcontainerdirective %}).
- * Used to configure multiple elements as draggable.
+ * Use this directive to make multiple elements draggable inside a container.
  *
  * @example
- * ```ts-no-run
+ * ```html
  * <ul kendoDragTargetContainer dragTargetFilter=".my-draggable">
- *    <li class="my-draggable">foo</li>
+ *   <li class="my-draggable"> Item 1</li>
+ *   <li class="my-draggable"> Item 2</li>
+ *   <li class="my-draggable"> Item 3</li>
  * </ul>
  * ```
  */
@@ -34,15 +36,14 @@ export class DragTargetContainerDirective {
     viewContainer;
     cdr;
     /**
-     * Defines whether a hint will be used for dragging. By default, the hint is a copy of the current drag target. ([see example]({% slug drag_hint %})).
+     * Defines whether a hint will be used for dragging. By default, the hint is a copy of the current drag target. [See example]({% slug drag_hint %}).
      *
      * @default false
      */
     hint = false;
     /**
-     * Specifies a selector for elements within a container which will be configured as draggable
-     * ([see example]({% slug drag_target_container %})). The possible values include any
-     * DOM `selector`.
+     * Sets a selector for elements in the container to make them draggable. The possible values include any
+     * DOM `selector`. [See example]({% slug drag_target_container %}).
      */
     set dragTargetFilter(value) {
         this._dragTargetFilter = value;
@@ -54,24 +55,24 @@ export class DragTargetContainerDirective {
         return this._dragTargetFilter;
     }
     /**
-     * Specifies a selector for elements within each DragTarget which will be configured as drag handles.
+     * Sets a selector for elements inside each drag target to use as drag handles.
      */
     dragHandle;
     /**
-     * Defines the delay in milliseconds after which the drag will begin ([see example](slug:drag_target_container#toc-events)).
+     * Sets the delay in milliseconds before dragging begins. [See example](slug:drag_target_container#toc-events).
      *
      * @default 0
      */
     dragDelay = 0;
     /**
-     * The number of pixels the pointer moves in any direction before the dragging starts ([see example]({% slug minimum_distance %})).
+     * Sets the number of pixels the pointer must move before dragging starts. [See example]({% slug minimum_distance %}).
      *
      * @default 0
      */
     threshold = 0;
     /**
-     * Defines a unique identifier for each drag target.
-     * It exposes the current DragTarget HTML element and its index in the collection of drag targets as arguments.
+     * Sets a unique identifier for each drag target.
+     * It exposes the current drag target HTML element and its index in the collection of drag targets as arguments.
      */
     set dragTargetId(fn) {
         if (isDevMode && typeof fn !== 'function') {
@@ -83,8 +84,8 @@ export class DragTargetContainerDirective {
         return this._dragTargetId;
     }
     /**
-     * Defines a callback function which returns custom data passed to the DropTarget events.
-     * It exposes the current DragTarget HTML element, its `dragTargetId` and its index in the collection of drag targets as arguments.
+     * Sets a callback function to return custom data for `DropTarget` events.
+     * It exposes the current `DragTarget` HTML element, its `dragTargetId`, and its index in the collection of drag targets as arguments.
      */
     set dragData(fn) {
         if (isDevMode && typeof fn !== 'function') {
@@ -96,7 +97,7 @@ export class DragTargetContainerDirective {
         return this._dragData;
     }
     /**
-     * If set to true, the dragging of DragTargets within the container will be disabled.
+     * Disables dragging of drag targets in the container when set to `true`.
      *
      * @default false
      */
@@ -120,13 +121,13 @@ export class DragTargetContainerDirective {
         return this._dragDisabled;
     }
     /**
-     * Specifies whether the default dragging behavior will be performed or the developer will manually handle the drag action.
+     * Sets whether to use the default dragging behavior or handle it manually.
      *
      * @default 'auto'
      */
     mode = 'auto';
     /**
-     * Specifies the cursor style of the drag targets. Accepts same values as the [CSS `cursor` property](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#values).
+     * Sets the cursor style of the drag targets. Accepts same values as the [CSS `cursor` property](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#values).
      *
      * @default 'move'
      */
@@ -136,31 +137,31 @@ export class DragTargetContainerDirective {
      */
     hintContext;
     /**
-     * Fires when a DragTarget's `dragDelay` has passed and the user is able to drag the element.
+     * Fires when a drag target's `dragDelay` has passed and the user can drag the element.
      */
     onDragReady = new EventEmitter();
     /**
-     * Fires when the user presses a DragTarget element.
+     * Fires when the user presses a drag target element.
      */
     onPress = new EventEmitter();
     /**
-     * Fires when the dragging of a DragTarget element begins.
-    */
+     * Fires when dragging of a drag target element begins.
+     */
     onDragStart = new EventEmitter();
     /**
-     * Fires while the user drags a DragTarget element.
+     * Fires while the user drags a drag target element.
      */
     onDrag = new EventEmitter();
     /**
-     * Fires when the user releases a DragTarget element after being pressed.
+     * Fires when the user releases a drag target element after pressing it.
      */
     onRelease = new EventEmitter();
     /**
-     * Fires when the dragging of a DragTarget ends and the element is released.
+     * Fires when dragging of a drag target ends and the element is released.
      */
     onDragEnd = new EventEmitter();
     /**
-     * Used for notifying the DragTargetContainer that its content has changed.
+     * Notifies the `DragTargetContainer` that its content has changed.
      */
     notify() {
         this.cdr.detectChanges();

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

@@ -20,6 +20,7 @@ let isDragStartPrevented = false;
 let isDragPrevented = false;
 /**
  * Represents the Kendo UI DragTarget directive for Angular.
+ * Use this directive to make an element draggable.
  */
 export class DragTargetDirective {
     element;
@@ -37,40 +38,40 @@ export class DragTargetDirective {
      */
     hint = false;
     /**
-     * The number of pixels the pointer moves in any direction before the dragging starts ([see example]({% slug minimum_distance %})). Applicable when `manualDrag` is set to `false`.
+     * Sets the number of pixels the pointer must move before dragging starts. Applies when `manualDrag` is `false`. [See example]({% slug minimum_distance %}).
      *
      * @default 0
      */
     threshold = 0;
     /**
-     * Defines the automatic container scrolling behavior when close to the edge ([see example]({% slug auto_scroll %})).
+     * Sets the automatic container scrolling behavior when close to the edge. [See example]({% slug auto_scroll %}).
      *
      * @default true
      */
     autoScroll = true;
     /**
-     * Defines a unique identifier for the dragTarget.
+     * Sets a unique identifier for the drag target.
      */
     dragTargetId;
     /**
-     * Defines the delay in milliseconds after which the drag will begin ([see example]({% slug drag_delay %})).
+     * Sets the delay in milliseconds before dragging begins. [See example]({% slug drag_delay %}).
      *
      * @default 0
      */
     dragDelay = 0;
     /**
-     * Restricts the element to be dragged horizontally or vertically only ([see example]({% slug axis_lock %})). Applicable when `mode` is set to `auto`.
+     * Restricts dragging to horizontal or vertical only. Applies when `mode` is `auto`. [See example]({% slug axis_lock %}).
      */
     restrictByAxis;
     /**
-     * Specifies whether the default dragging behavior will be performed or the developer will manually handle the drag action.
+     * Specifies whether to use the default dragging behavior or handle it manually.
      *
      * @default 'auto'
      */
     mode = 'auto';
     /**
-     * Defines a callback function used for attaching custom data to the dragTarget.
-     * The data will be available in the events of the respective [`DropTarget`]({% slug api_utils_droptargetdirective %}) or [`DropTargetContainer`]({% slug api_utils_droptargetcontainerdirective %}) directives.
+     * Defines a callback function used for attaching custom data to the drag target.
+     * The data is available in the events of the respective [`DropTarget`]({% slug api_utils_droptargetdirective %}) or [`DropTargetContainer`]({% slug api_utils_droptargetcontainerdirective %}) directives.
      * The current DragTarget HTML element and its `dragTargetId` will be available as arguments.
      */
     set dragData(fn) {
@@ -83,33 +84,33 @@ export class DragTargetDirective {
         return this._dragData;
     }
     /**
-     * Specifies the cursor style of the drag target. Accepts same values as the [CSS `cursor` property](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#values).
+     * Sets the cursor style of the drag target. Accepts same values as the [CSS `cursor` property](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#values).
      *
      * @default 'move'
      */
     cursorStyle = 'move';
     /**
-     * Fires when the user presses the DragTarget element.
+     * Fires when the user presses the drag target element.
      */
     onPress = new EventEmitter();
     /**
-     * Fires when the dragging of the DragTarget element begins.
+     * Fires when dragging of the drag target element begins.
      */
     onDragStart = new EventEmitter();
     /**
-     * Fires while the user drags the DragTarget element.
+     * Fires while the user drags the drag target element.
      */
     onDrag = new EventEmitter();
     /**
-     * Fires when the DragTarget's `dragDelay` has passed and the user is able to drag the element.
+     * Fires when the drag target's `dragDelay` has passed and the user can drag the element.
      */
     onDragReady = new EventEmitter();
     /**
-     * Fires when the user releases the DragTarget element after being pressed.
+     * Fires when `DragTarget` is released, either by dropping it on a drop target or by releasing the mouse button.
      */
     onRelease = new EventEmitter();
     /**
-     * Fires when the dragging of the DragTarget ends and the element is released.
+     * Fires when dragging of the drag target ends and the element is released.
      */
     onDragEnd = new EventEmitter();
     dragTarget = null;

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

@@ -12,12 +12,14 @@ import * as i0 from "@angular/core";
 import * as i1 from "./drag-state.service";
 /**
  * Represents the [Kendo UI DropTargetContainer directive for Angular]({% slug api_utils_droptargetcontainerdirective %}).
- * Used to configure multiple elements as drop targets.
+ * Use this directive to make multiple elements drop targets inside a container.
  *
  * @example
- * ```ts-no-run
+ * ```html
  * <div kendoDropTargetContainer dropTargetFilter=".my-droptarget">
- *    <div class="my-droptarget">foo</div>
+ *   <div class="my-droptarget">
+ *     Drop here
+ *   </div>
  * </div>
  * ```
  */
@@ -27,9 +29,7 @@ export class DropTargetContainerDirective {
     ngZone;
     cdr;
     /**
-     * Specifies a selector for elements within a container which will be configured as drop targets
-     * ([see example]({% slug drop_target_container %})). The possible values include any
-     * DOM `selector`.
+     * Sets a selector for elements in the container to make them drop targets. [See example]({% slug drop_target_container %}).
      */
     set dropTargetFilter(value) {
         this._dropTargetFilter = value;
@@ -41,7 +41,7 @@ export class DropTargetContainerDirective {
         return this._dropTargetFilter;
     }
     /**
-     * Specifies whether the Drop Targets within the container will emit the corresponding events upon interaction with a Drag Target.
+     * Specifies whether the drop targets within the container will emit the corresponding events upon interaction with a drag target.
      */
     set dropDisabled(value) {
         this._dropDisabled = value;
@@ -56,23 +56,23 @@ export class DropTargetContainerDirective {
         return this._dropDisabled;
     }
     /**
-     * Fires when a DragTarget element enters the DropTarget.
+     * Fires when a drag target enters a drop target.
      */
     onDragEnter = new EventEmitter();
     /**
-     * Fires when a DragTarget element is being dragged over the DropTarget.
+     * Fires when a drag target is dragged over a drop target.
      */
     onDragOver = new EventEmitter();
     /**
-     * Fires when a DragTarget element leaves the DropTarget.
+     * Fires when a drag target leaves a drop target.
      */
     onDragLeave = new EventEmitter();
     /**
-     * Fires when a DragTarget element is dropped over the DropTarget.
+     * Fires when a drag target is dropped over a drop target.
      */
     onDrop = new EventEmitter();
     /**
-     * Used for notifying the DropTargetContainer that its content has changed.
+     * Notifies the `DropTargetContainer` that its content has changed.
      */
     notify() {
         this.cdr.detectChanges();