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

package/models/animation.model.d.ts

@@ -4,6 +4,6 @@
 *-------------------------------------------------------------------------------------------*/
 import { PopupAnimation } from "@progress/kendo-angular-popup";
 /**
- * Specifies the available Popover animation options
+ * Specifies the available Popover animation options.
  */
 export type PopoverAnimation = PopupAnimation | boolean;

package/models/events.d.ts

@@ -5,32 +5,30 @@
 import { PreventableEvent } from "@progress/kendo-angular-common";
 import { PopupRef } from "@progress/kendo-angular-popup";
 /**
- * Arguments for the `show` event. The `show` event fires when a popover is about
- * to be opened. If you cancel the event, the opening is prevented.
+ * Provides arguments for the `show` event. The event fires when a popover is about to open. Cancel the event to prevent opening.
  */
 export declare class PopoverShowEvent extends PreventableEvent {
     /**
-     * The host element related to the popover.
+     * Specifies the host element related to the Popover.
      */
     anchor: Element;
     /**
      * @hidden
      * Constructs the event arguments for the `show` event.
-     * @param anchor - The host element related to the popover.
+     * @param anchor - The host element related to the Popover.
      */
     constructor(anchor: Element);
 }
 /**
- * Arguments for the `hide` event. The `hide` event fires when a popover is about
- * to be closed. If you cancel the event, the popover stays open.
+ * Provides arguments for the `hide` event. The event fires when a popover is about to close. Cancel the event to keep it open.
  */
 export declare class PopoverHideEvent extends PreventableEvent {
     /**
-     * The host element related to the popover.
+     * Specifies the host element related to the Popover.
      */
     anchor: Element;
     /**
-     * The popover element.
+     * Specifies the Popover element.
      */
     popover: PopupRef;
     /**
@@ -42,15 +40,15 @@ export declare class PopoverHideEvent extends PreventableEvent {
     constructor(anchor: Element, popover: PopupRef);
 }
 /**
- * Arguments for the `shown` event. The `shown` event fires after the popover has opened and its opening animation has finished.
+ * Provides arguments for the `shown` event. The event fires after the Popover has opened and its opening animation has finished.
  */
 export declare class PopoverShownEvent {
     /**
-     * The host element related to the popover.
+     * Specifies the host element related to the Popover.
      */
     anchor: Element;
     /**
-     * The popover element.
+     * Specifies the Popover element.
      */
     popover: PopupRef;
     /**
@@ -62,11 +60,11 @@ export declare class PopoverShownEvent {
     constructor(anchor: Element, popover: PopupRef);
 }
 /**
- * Arguments for the `hidden` event. The `hidden` event fires after the popover has closed and its closing animation has finished.
+ * Provides arguments for the `hidden` event. The event fires after the popover has closed and its closing animation has finished.
  */
 export declare class PopoverHiddenEvent {
     /**
-     * The host element related to the popover.
+     * Specifies the host element related to the Popover.
      */
     anchor: Element;
     /**

package/models/functions.model.d.ts

@@ -4,14 +4,12 @@
 *-------------------------------------------------------------------------------------------*/
 import { PopoverComponent } from "../popover/popover.component";
 /**
- * Represents a callback that is used by the [popover]({% slug api_tooltip_popoveranchordirective %}#toc-popover) property.
- * It returns the popover instance to be displayed.
- * ([see example]({% slug configuration_popover %}#toc-popover-callback))
+ * Represents a callback used by the [`popover`]({% slug api_tooltip_popoveranchordirective %}#toc-popover) property.
+ * Returns the popover instance to display. [See example]({% slug configuration_popover %}#toc-popover-callback).
  */
 export type PopoverFn = (anchor: Element) => PopoverComponent;
 /**
- * Represents the callback that is used by the [`templateData`]({% slug api_tooltip_popovercomponent %}#toc-templateData) property.
- * It returns the custom data that will be passed to the popover templates.
- * ([see example]({% slug templates_popover %}#toc-passing-data-to-templates))
+ * Represents a callback used by the [`templateData`]({% slug api_tooltip_popovercomponent %}#toc-templateData) property.
+ * Returns custom data to pass to the popover templates. [See example]({% slug templates_popover %}#toc-passing-data-to-templates).
  */
 export type PopoverDataFn = (anchor: Element) => any;

package/models/popover-show-option.type.d.ts

@@ -3,6 +3,12 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Specifies the possible events on which the Popover could be shown.
+ * The `PopoverShowOption` type defines the different ways a Popover can be displayed based on user interaction with its anchor element.
+ *
+ * The supported values are:
+ * - `click` (default) — Shows the Popover when its anchor element is clicked.
+ * - `hover`—Shows the Popover when its anchor element is hovered.
+ * - `focus`—Shows the Popover when its anchor element is focused.
+ * - `none`—Does not show the Popover on user interaction. You can render it via the Popover API methods.
  */
 export type PopoverShowOption = 'hover' | 'click' | 'none' | 'focus';

package/models/position.type.d.ts

@@ -3,12 +3,12 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Specifies the position of the Tooltip or Popover in relation to the anchor element.
+ * Specifies the position of the Tooltip or Popover relative to the anchor element.
  *
  * The available options are:
- * - `top` (default)—Aligns the tooltip above the `anchor` element.
- * - `bottom`—Aligns the tooltip below the `anchor` element.
- * - `right`—Aligns the tooltip with the rightmost point of the `anchor` element.
- * - `left`—Aligns the tooltip with the leftmost point of the `anchor` element.
+ * - `top` (default)—Aligns the tooltip above the anchor element.
+ * - `bottom`—Aligns the tooltip below the anchor element.
+ * - `right`—Aligns the tooltip with the rightmost point of the anchor element.
+ * - `left`—Aligns the tooltip with the leftmost point of the anchor element.
  */
 export type Position = 'top' | 'bottom' | 'right' | 'left';

package/models/show.option.type.d.ts

@@ -3,11 +3,11 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Specifies when the Тooltip will be rendered.
+ * The `ShowOption` type defines the different ways a tooltip can be displayed in the Kendo UI Tooltip component.
  *
  * The available options are:
- * - `hover`(default)—Tooltip is rendered when its `anchor` element is hovered.
- * - `click`—Tooltip is rendered when its `anchor` element is clicked.
- * - `none`—Tooltip is not rendered in `kendoTooltip` container.
+ * - `hover` (default)—Tooltip is rendered when its anchor element is hovered.
+ * - `click`—Tooltip is rendered when its anchor element is clicked.
+ * - `none`—Tooltip is not rendered in the kendoTooltip container.
  */
 export type ShowOption = 'hover' | 'click' | 'none';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-tooltip",
-  "version": "19.1.2-develop.3",
+  "version": "19.1.2-develop.5",
   "description": "Kendo UI Tooltip for Angular - A highly customizable and easily themeable tooltip from the creators developers trust for professional Angular components.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -21,7 +21,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1750152613,
+      "publishDate": 1750430954,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -31,15 +31,15 @@
     "@angular/core": "16 - 20",
     "@angular/platform-browser": "16 - 20",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-common": "19.1.2-develop.3",
-    "@progress/kendo-angular-l10n": "19.1.2-develop.3",
-    "@progress/kendo-angular-popup": "19.1.2-develop.3",
-    "@progress/kendo-angular-icons": "19.1.2-develop.3",
+    "@progress/kendo-angular-common": "19.1.2-develop.5",
+    "@progress/kendo-angular-l10n": "19.1.2-develop.5",
+    "@progress/kendo-angular-popup": "19.1.2-develop.5",
+    "@progress/kendo-angular-icons": "19.1.2-develop.5",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "19.1.2-develop.3"
+    "@progress/kendo-angular-schematics": "19.1.2-develop.5"
   },
   "schematics": "./schematics/collection.json",
   "module": "fesm2022/progress-kendo-angular-tooltip.mjs",

package/popover/anchor.directive.d.ts

@@ -9,10 +9,10 @@ import { PopoverService } from "./popover.service";
 import * as i0 from "@angular/core";
 /**
  * Represents the [`kendoPopoverAnchor`](slug:configuration_popover#toc-popover-anchor) directive.
- * It is used to target an element, which should display a popover on interaction.
+ * Targets an element to display a popover on user interaction.
  *
  * @example
- * ```ts-no-run
+ * ```html
  * <button kendoPopoverAnchor [popover]="myPopover">Show Popover</button>
  * ```
  */

package/popover/container.directive.d.ts

@@ -9,14 +9,14 @@ import { PopoverService } from "./popover.service";
 import * as i0 from "@angular/core";
 /**
  * Represents the [`kendoPopoverContainer`](slug:configuration_popover#toc-popover-container) directive.
- * It is used to filter and target multiple elements, which should display a popover on interaction.
+ * Filters and targets multiple elements to display a popover on user interaction.
  *
  * @example
- * ```ts-no-run
+ * ```html
  * <div kendoPopoverContainer [popover]="myPopover" filter=".has-popover">
- *     <button class="has-popover">Show Popover</button>
- *     <button>Button Without Popover</button>
- *     <button class="has-popover">Show Popover</button>
+ *   <button class="has-popover">Show Popover</button>
+ *   <button>Button Without Popover</button>
+ *   <button class="has-popover">Show Popover</button>
  * </div>
  * ```
  */
@@ -27,23 +27,21 @@ export declare class PopoverContainerDirective extends PopoverDirectivesBase {
     protected renderer: Renderer2;
     protected popoverService: PopoverService;
     /**
-     * Specifies a selector for the elements that should display a popover.
-     *
-     * The possible values include any valid query selector.
-     * [See example](slug:configuration_popover#toc-popover-container)
+     * Specifies a selector for the elements that display a popover. Accepts a CSS selector string similar to a [querySelector method](https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelector).
+     * [See example](slug:configuration_popover#toc-popover-container).
      */
     filter: string;
     constructor(wrapperEl: ElementRef, ngZone: NgZone, popupService: PopupService, renderer: Renderer2, popoverService: PopoverService);
     /**
      * Shows the Popover.
      *
-     * @param anchor&mdash;Specifies the element that will be used as an anchor. The Popover opens relative to that element. [See example]({% slug programmaticcontrol_popover %})
+     * @param anchor - The element used as an anchor. The Popover opens relative to this element. [See example]({% slug programmaticcontrol_popover %}).
      */
     show(anchor: Element | ElementRef): void;
     /**
-     * Toggles the visibility of the Popover. [See example]({% slug programmaticcontrol_popover %})
+     * Toggles the visibility of the Popover. [See example]({% slug programmaticcontrol_popover %}).
      *
-     * @param anchor&mdash;Specifies the element that will be used as an anchor. The Popover opens relative to that element.
+     * @param anchor - The element used as an anchor. The Popover opens relative to this element.
      */
     toggle(anchor: Element | ElementRef): void;
     protected subscribeClick(): void;

package/popover/directives-base.d.ts

@@ -18,23 +18,13 @@ export declare abstract class PopoverDirectivesBase {
     protected popupService: PopupService;
     protected renderer: Renderer2;
     /**
-     * Specifies the popover instance that will be rendered.
-     * Accepts a [`PopoverComponent`]({% slug api_tooltip_popovercomponent %}) instance or
-     * a [`PopoverFn`]({% slug api_tooltip_popoverfn %}) callback which returns a [`PopoverComponent`]({% slug api_tooltip_popovercomponent %}) instance
-     * depending on the current anchor element.
-     *
-     * [See example](slug:templates_popover#toc-passing-data-to-templates)
+     * Specifies the popover instance to render.
+     * Accepts a [`PopoverComponent`]({% slug api_tooltip_popovercomponent %}) instance or a [`PopoverFn`]({% slug api_tooltip_popoverfn %}) callback that returns a [`PopoverComponent`]({% slug api_tooltip_popovercomponent %}) instance for the current anchor element. [See example](slug:templates_popover#toc-passing-data-to-templates).
      */
     set popover(value: PopoverComponent | PopoverFn);
     get popover(): PopoverComponent | PopoverFn;
     /**
-     * The event on which the Popover will be shown
-     *
-     * The supported values are:
-     * - `click` (default) —The Popover will be shown when its `anchor` element is clicked.
-     * - `hover`—The Popover will be shown when its `anchor` element is hovered.
-     * - `focus`—The Popover will be shown when its `anchor` element is focused.
-     * - `none`—The Popover will not be shown on user interaction. It could be rendered via the Popover API methods.
+     * Specifies the mouse action that triggers the popover to show. [See example]({% slug programmaticcontrol_popover %}).
      */
     set showOn(value: PopoverShowOption);
     get showOn(): PopoverShowOption;
@@ -62,7 +52,7 @@ export declare abstract class PopoverDirectivesBase {
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     /**
-     * Hides the Popover ([See example]({% slug programmaticcontrol_popover %})).
+     * Hides the Popover. [See example]({% slug programmaticcontrol_popover %}).
      */
     hide(): void;
     /**

package/popover/popover.component.d.ts

@@ -14,14 +14,14 @@ import { PopoverAnimation } from '../models/animation.model';
 import * as i0 from "@angular/core";
 /**
  * Represents the [Kendo UI Popover component for Angular]({% slug overview_popover %}).
- * Used to display additional information that is related to a target element.
+ * Displays additional information related to a target element.
  *
  * @example
- * ```ts-no-run
+ * ```html
  * <kendo-popover>
- *    <ng-template kendoPopoverTitleTemplate>Foo Title</ng-template>
- *    <ng-template kendoPopoverBodyTemplate>Foo Body</ng-template>
- *    <ng-template kendoPopoverActionsTemplate>Foo Actions</ng-template>
+ *   <ng-template kendoPopoverTitleTemplate>Title</ng-template>
+ *   <ng-template kendoPopoverBodyTemplate>Body</ng-template>
+ *   <ng-template kendoPopoverActionsTemplate>Actions</ng-template>
  * </kendo-popover>
  * ```
  */
@@ -35,30 +35,28 @@ export declare class PopoverComponent implements OnInit, AfterViewInit, OnDestro
      */
     anchor: Element;
     /**
-     * Specifies the position of the Popover in relation to its anchor element. [See example]({% slug positioning_popover %})
+     * Specifies the position of the Popover relative to its anchor element. [See example]({% slug positioning_popover %}).
      *
-     * The possible options are:
-     * `top`
-     * `bottom`
-     * `right` (Default)
-     * `left`
+     * @default 'right'
      */
     position: Position;
     /**
      * Specifies the distance from the Popover to its anchor element in pixels.
      *
-     * @default `6`
+     * @default 6
      */
     set offset(value: number);
     get offset(): number;
     /**
-     * Determines the width of the popover. Numeric values are treated as pixels.
+     * Determines the width of the Popover. Numeric values are treated as pixels.
+     *
      * @default 'auto'
      */
     set width(value: number | string);
     get width(): string | number;
     /**
-     * Determines the height of the popover. Numeric values are treated as pixels.
+     * Determines the height of the Popover. Numeric values are treated as pixels.
+     *
      * @default 'auto'
      */
     set height(value: number | string);
@@ -68,9 +66,7 @@ export declare class PopoverComponent implements OnInit, AfterViewInit, OnDestro
      */
     direction: 'ltr' | 'rtl';
     /**
-     * Specifies the main header text of the Popover.
-     *
-     * If a `titleTemplate` is provided it would take precedence over the title.
+     * Specifies the main header text of the Popover. If a `titleTemplate` is provided, it takes precedence.
      */
     title: string;
     /**
@@ -81,31 +77,26 @@ export declare class PopoverComponent implements OnInit, AfterViewInit, OnDestro
      */
     subtitle: string;
     /**
-     * Represents the text that will be rendered in the Popover body section.
-     *
-     * If a `bodyTemplate` is provided it would take precedence over this text.
+     * Represents the text rendered in the Popover body section. If a `bodyTemplate` is provided, it takes precedence.
      */
     body: string;
     /**
-     * Determines whether a callout will be rendered along the Popover. [See example]({% slug callout_popover %})
+     * Determines whether a callout is rendered along the Popover. [See example]({% slug callout_popover %}).
      *
      * @default true
      */
     callout: boolean;
     /**
-     * Enables and configures the Popover animation. [See example]({% slug animations_popover %})
-     *
-     * The possible options are:
+     * Enables and configures the Popover animation. [See example]({% slug animations_popover %}).
      *
-     * * `boolean`&mdash;Enables the default animation
-     * * `PopoverAnimation`&mdash;A configuration object which allows setting the `direction`, `duration` and `type` of the animation.
+     * Accepts a boolean to enable the default animation, or a `PopoverAnimation` object for custom settings.
      *
      * @default false
      */
     animation: PopoverAnimation;
     /**
-     * Defines a callback function which returns custom data passed to the Popover templates.
-     * It exposes the current anchor element as an argument. [See example](slug:templates_popover#toc-passing-data-to-templates)
+     * Defines a callback function that returns custom data for the Popover templates.
+     * The function exposes the `anchor` element as an argument and returns an object that can be used in the templates. [See example](slug:templates_popover#toc-passing-data-to-templates).
      */
     set templateData(fn: PopoverDataFn);
     get templateData(): PopoverDataFn;
@@ -123,21 +114,19 @@ export declare class PopoverComponent implements OnInit, AfterViewInit, OnDestro
      */
     get hasAttributeHidden(): boolean;
     /**
-     * Fires before the Popover is about to be shown ([see example]({% slug events_popover %})).
-     * The event is preventable. If canceled, the Popover will not be displayed. [See example]({% slug events_popover %})
+     * Fires before the Popover is shown. The event is preventable. If canceled, the Popover will not display. [See example]({% slug events_popover %}).
      */
     show: EventEmitter<PopoverShowEvent>;
     /**
-     * Fires after the Popover has been shown and the animation has ended. [See example]({% slug events_popover %})
+     * Fires after the Popover has been shown and the animation has ended. [See example]({% slug events_popover %}).
      */
     shown: EventEmitter<PopoverShownEvent>;
     /**
-     * Fires when the Popover is about to be hidden ([see example]({% slug events_popover %})).
-     * The event is preventable. If canceled, the Popover will remain visible.
+     * Fires when the Popover is about to be hidden. The event is preventable. If canceled, the Popover remains visible. [See example]({% slug events_popover %}).
      */
     hide: EventEmitter<PopoverHideEvent>;
     /**
-     * Fires after the Popover has been hidden and the animation has ended. [See example]({% slug events_popover %})
+     * Fires after the Popover has been hidden and the animation has ended. [See example]({% slug events_popover %}).
      */
     hidden: EventEmitter<any>;
     /**

package/popover/template-directives/actions-template.directive.d.ts

@@ -5,10 +5,19 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents a template that defines the content of the Popover actions.
+ * Represents the Kendo UI Popover actions template directive for Angular.
+ * Use the `kendoPopoverActionsTemplate` directive to define a custom actions template for the Popover component.
  *
  * To define the template, nest an `<ng-template>` tag
  * with the `kendoPopoverActionsTemplate` directive inside the `<kendo-popover>` tag.
+ *
+ * ```html
+ * <kendo-popover>
+ *  <ng-template kendoPopoverActionsTemplate>
+ *    Custom Actions
+ *  </ng-template>
+ * </kendo-popover>
+ * ```
  */
 export declare class PopoverActionsTemplateDirective {
     templateRef: TemplateRef<any>;

package/popover/template-directives/body-template.directive.d.ts

@@ -5,10 +5,19 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents a template that defines the content of the Popover body.
+ * Represents the Kendo UI Popover body template directive for Angular.
+ * Use the `kendoPopoverBodyTemplate` directive to define a custom body template for the Popover component.
  *
  * To define the template, nest an `<ng-template>` tag
  * with the `kendoPopoverBodyTemplate` directive inside the `<kendo-popover>` tag.
+ *
+ * ```html
+ * <kendo-popover>
+ *  <ng-template kendoPopoverBodyTemplate>
+ *   Custom Body Content
+ *  </ng-template>
+ * </kendo-popover>
+ * ```
  */
 export declare class PopoverBodyTemplateDirective {
     templateRef: TemplateRef<any>;

package/popover/template-directives/title-template.directive.d.ts

@@ -5,10 +5,19 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents a template that defines the content of the Popover title.
+ * Represents the Kendo UI Popover title template directive for Angular.
+ * Use the `kendoPopoverTitleTemplate` directive to define a custom title template for the Popover component.
  *
  * To define the template, nest an `<ng-template>` tag
  * with the `kendoPopoverTitleTemplate` directive inside the `<kendo-popover>` tag.
+ *
+ * ```html
+ * <kendo-popover>
+ *   <ng-template kendoPopoverTitleTemplate>
+ *     Custom Title
+ *   </ng-template>
+ * </kendo-popover>
+ * ```
  */
 export declare class PopoverTitleTemplateDirective {
     templateRef: TemplateRef<any>;

package/popover.module.d.ts

@@ -10,28 +10,23 @@ import * as i4 from "./popover/template-directives/title-template.directive";
 import * as i5 from "./popover/anchor.directive";
 import * as i6 from "./popover/container.directive";
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmoduleapi'])
  * definition for the Popover component.
  *
  * @example
- *
- * ```ts-no-run
+ * ```typescript
  * import { PopoverModule } from '@progress/kendo-angular-tooltip';
  *
  * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
  * import { NgModule } from '@angular/core';
- *
  * import { AppComponent } from './app.component';
  *
- * _@NgModule({
+ * @NgModule({
  *     declarations: [AppComponent],
  *     imports:      [BrowserModule, PopoverModule],
  *     bootstrap:    [AppComponent]
  * })
  * export class AppModule {}
- *
- * platformBrowserDynamic().bootstrapModule(AppModule);
- *
  * ```
  */
 export declare class PopoverModule {