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

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

@@ -13,13 +13,21 @@ import { map, tap, filter } from 'rxjs/operators';
 
 /**
  * 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>
+ * ```
  */
 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'
      */
@@ -55,8 +63,8 @@ const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1750152426,
-    version: '19.1.2-develop.3',
+    publishDate: 1750430763,
+    version: '19.1.2-develop.5',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };
 
@@ -330,15 +338,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * Arguments for the press event of the DragTarget and DragTargetContainer.
+ * Arguments for the press event of the `DragTarget` and `DragTargetContainer`.
  */
 class DragTargetPressEvent {
     /**
-     * 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;
     /**
-     * The DOM element that is being dragged.
+     * The DOM element being dragged.
      */
     dragTarget;
     /**
@@ -346,7 +355,7 @@ class DragTargetPressEvent {
      */
     dragTargetId;
     /**
-     * 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;
     /**
@@ -372,15 +381,16 @@ class DragTargetPressEvent {
 }
 
 /**
- * Arguments for the dragReady event of the DragTarget and DragTargetContainer.
+ * Arguments for the dragReady event of the `DragTarget` and `DragTargetContainer`.
  */
 class DragTargetDragReadyEvent {
     /**
-     * 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;
     /**
-     * The DOM element that is being dragged.
+     * The DOM element being dragged.
      */
     dragTarget;
     /**
@@ -388,7 +398,7 @@ class DragTargetDragReadyEvent {
      */
     dragTargetId;
     /**
-     * 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;
     /**
@@ -400,15 +410,16 @@ class DragTargetDragReadyEvent {
 }
 
 /**
- * Arguments for the dragStart event of the DragTarget and DragTargetContainer.
+ * Arguments for the `dragStart` event of the `DragTarget` and `DragTargetContainer`.
  */
 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;
     /**
-     * The DOM element that is being dragged.
+     * The DOM element being dragged.
      */
     dragTarget;
     /**
@@ -416,7 +427,7 @@ class DragTargetDragStartEvent extends PreventableEvent {
      */
     dragTargetId;
     /**
-     * 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;
     /**
@@ -443,15 +454,16 @@ class DragTargetDragStartEvent extends PreventableEvent {
 }
 
 /**
- * Arguments for the dragEnd event of the DragTarget and DragTargetContainer.
+ * Arguments for the dragEnd event of the `DragTarget` and `DragTargetContainer`.
  */
 class DragTargetDragEndEvent {
     /**
-     * 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;
     /**
-     * The DOM element that is being dragged.
+     * The DOM element being dragged.
      */
     dragTarget;
     /**
@@ -459,7 +471,7 @@ class DragTargetDragEndEvent {
      */
     dragTargetId;
     /**
-     * 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;
     /**
@@ -485,19 +497,20 @@ class DragTargetDragEndEvent {
 }
 
 /**
- * Arguments for the drag event of the DragTarget and DragTargetContainer.
+ * Arguments for the drag event of the `DragTarget` and `DragTargetContainer`.
  */
 class DragTargetDragEvent 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;
     /**
-     * The DOM element that is being dragged.
+     * The DOM element being dragged.
      */
     dragTarget;
     /**
-     * The hint of the DragTarget.
+     * The hint element of the `DragTarget`.
      */
     hintElement;
     /**
@@ -505,7 +518,7 @@ class DragTargetDragEvent extends PreventableEvent {
      */
     dragTargetId;
     /**
-     * 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;
     /**
@@ -532,15 +545,16 @@ class DragTargetDragEvent extends PreventableEvent {
 }
 
 /**
- * Arguments for the release event of the DragTarget and DragTargetContainer.
+ * Arguments for the release event of the `DragTarget` and `DragTargetContainer`.
  */
 class DragTargetReleaseEvent {
     /**
-     * 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;
     /**
-     * The DOM element that is being dragged.
+     * The DOM element being dragged.
      */
     dragTarget;
     /**
@@ -548,7 +562,7 @@ class DragTargetReleaseEvent {
      */
     dragTargetId;
     /**
-     * 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;
     /**
@@ -577,12 +591,14 @@ let isDragStartPrevented$1 = false;
 let isDragPrevented$1 = 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>
  * ```
  */
@@ -594,15 +610,14 @@ 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;
@@ -614,24 +629,24 @@ 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') {
@@ -643,8 +658,8 @@ 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') {
@@ -656,7 +671,7 @@ 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
      */
@@ -680,13 +695,13 @@ 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'
      */
@@ -696,31 +711,31 @@ 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();
@@ -1271,6 +1286,7 @@ let isDragStartPrevented = false;
 let isDragPrevented = false;
 /**
  * Represents the Kendo UI DragTarget directive for Angular.
+ * Use this directive to make an element draggable.
  */
 class DragTargetDirective {
     element;
@@ -1288,40 +1304,40 @@ 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) {
@@ -1334,33 +1350,33 @@ 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;
@@ -1842,7 +1858,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * Arguments for the drag events of the DropTarget and DropTargetContainer directives.
+ * Arguments for the drag events of the `DropTarget` and `DropTargetContainer` directives.
  */
 class DropTargetEvent {
     /**
@@ -1862,11 +1878,11 @@ class DropTargetEvent {
      */
     dragData;
     /**
-     * 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;
     /**
-     * The hint of the DragTarget.
+     * The hint element of the `DragTarget`.
      */
     hintElement;
     /**
@@ -1893,12 +1909,14 @@ class DropTargetEvent {
 
 /**
  * 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>
  * ```
  */
@@ -1908,9 +1926,7 @@ 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;
@@ -1922,7 +1938,7 @@ 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;
@@ -1937,23 +1953,23 @@ 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();
@@ -2116,25 +2132,33 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 
 /**
  * Represents the Kendo UI DropTarget directive for Angular.
+ * Use this directive to make an element a drop target for draggable items.
+ *
+ * ```html
+ * <div kendoDropTarget>
+ *   Drop here
+ * </div>
+ * ```
+ *
  */
 class DropTargetDirective {
     service;
     element;
     ngZone;
     /**
-     * Fires when a DragTarget element enters the DropTarget.
+     * Fires when a drag target enters the drop target.
      */
     onDragEnter = new EventEmitter();
     /**
-     * Fires when a DragTarget element is being dragged over the DropTarget.
+     * Fires when a drag target is dragged over the drop target.
      */
     onDragOver = new EventEmitter();
     /**
-     * Fires when a DragTarget element leaves the DropTarget.
+     * Fires when a drag target leaves the drop target.
      */
     onDragLeave = new EventEmitter();
     /**
-     * Fires when a DragTarget element is dropped over the DropTarget.
+     * Fires when a drag target is dropped over the drop target.
      */
     onDrop = new EventEmitter();
     constructor(service, element, ngZone) {
@@ -2233,7 +2257,24 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * 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 {}
+ * ```
  */
 const KENDO_DRAGANDDROP = [
     DragTargetDirective,
@@ -2244,8 +2285,8 @@ 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.
 */
 const KENDO_UTILS = [
     ...KENDO_DRAGANDDROP
@@ -2253,34 +2294,22 @@ const KENDO_UTILS = [
 
 // IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmodules'])
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmodules'])
  * definition for the Utils components.
  *
  * @example
- *
- * ```ts-no-run
- * // Import the Utils module
+ * ```ts
  * import { UtilsModule } 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, UtilsModule], // import Utils module
+ * @NgModule({
+ *     declarations: [AppComponent],
+ *     imports:      [BrowserModule, UtilsModule],
  *     bootstrap:    [AppComponent]
  * })
  * export class AppModule {}
- *
- * // Compile and launch the module
- * platformBrowserDynamic().bootstrapModule(AppModule);
- *
  * ```
  */
 class UtilsModule {
@@ -2298,34 +2327,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 
 // IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * 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);
- *
  * ```
  */
 class DragAndDropModule {
@@ -2342,7 +2359,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }] });
 
 /**
- * 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.
  */
 class AdaptiveSettingsService {
     /**
@@ -2350,7 +2367,7 @@ 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.
      */
@@ -2365,18 +2382,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }] });
 
 /**
- * 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 {}
  * ```
- *
  */
 const ADAPTIVE_SETTINGS = new InjectionToken('Kendo UI Adaptive-Settings token');
 
@@ -2385,21 +2402,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 {}
  * ```