@progress/kendo-angular-layout 19.1.2-develop.4 → 19.1.2-develop.6

package/avatar/avatar.component.d.ts

@@ -8,7 +8,26 @@ import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { AvatarFillMode, AvatarShape, AvatarSize, AvatarThemeColor, AvatarRounded } from './models/models';
 import * as i0 from "@angular/core";
 /**
- * Displays images, icons or initials representing people or other entities.
+ * Represents the Kendo UI Avatar component for Angular. Displays images, icons, or initials representing people or other entities.
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   selector: 'my-app',
+ *   template: `
+ *     <kendo-avatar [imageSrc]="userImage" size="large"></kendo-avatar>
+ *     <kendo-avatar [initials]="userInitials" themeColor="primary"></kendo-avatar>
+ *     <kendo-avatar [icon]="userIcon" fillMode="outline"></kendo-avatar>
+ *   `
+ * })
+ * class AppComponent {
+ *   userImage = 'path/to/image.jpg';
+ *   userInitials = 'JD';
+ *   userIcon = 'user';
+ * }
+ * ```
+ * @remarks
+ * Supported children components are: {@link AvatarCustomMessagesComponent}.
  */
 export declare class AvatarComponent implements OnInit, AfterViewInit {
     private localization;
@@ -29,57 +48,33 @@ export declare class AvatarComponent implements OnInit, AfterViewInit {
      */
     set shape(shape: AvatarShape);
     /**
-     * Specifies the size of the avatar
+     * Specifies the size of the Avatar
      * ([see example]({% slug appearance_avatar %}#toc-size)).
      *
-     * The possible values are:
-     * * `small`
-     * * `medium` (Default)
-     * * `large`
-     * * `none`
+     * @default 'medium'
      */
     set size(size: AvatarSize);
     get size(): AvatarSize;
     /**
-     * Specifies the rounded styling of the avatar
+     * Specifies the rounded styling of the Avatar
      * ([see example](slug:appearance_avatar#toc-roundness)).
      *
-     * The possible values are:
-     * * `small`
-     * * `medium`
-     * * `large`
-     * * `full` (Default)
-     * * `none`
+     * @default 'full'
      */
     set rounded(rounded: AvatarRounded);
     get rounded(): AvatarRounded;
     /**
-     * Specifies the theme color of the avatar.
-     * The theme color will be applied as background and border color, while also amending the text color accordingly.
+     * Specifies the theme color of the Avatar.
+     * The theme color applies as background and border color while adjusting the text color accordingly.
      *
-     * The possible values are:
-     * * `base`&mdash; Applies the base coloring value.
-     * * `primary` (Default)&mdash;Applies coloring based on primary theme color.
-     * * `secondary`&mdash;Applies coloring based on secondary theme color.
-     * * `tertiary`&mdash; Applies coloring based on tertiary theme color.
-     * * `info`&mdash;Applies coloring based on info theme color.
-     * * `success`&mdash; Applies coloring based on success theme color.
-     * * `warning`&mdash; Applies coloring based on warning theme color.
-     * * `error`&mdash; Applies coloring based on error theme color.
-     * * `dark`&mdash; Applies coloring based on dark theme color.
-     * * `light`&mdash; Applies coloring based on light theme color.
-     * * `inverse`&mdash; Applies coloring based on inverted theme color.
-     * * `none`&mdash; Removes the styling associated with the theme color.
+     * @default 'primary'
      */
     set themeColor(themeColor: AvatarThemeColor);
     get themeColor(): AvatarThemeColor;
     /**
-     * Specifies the appearance fill style of the avatar.
+     * Specifies the fill style of the Avatar.
      *
-     * The possible values are:
-     * * `solid` (Default)
-     * * `outline`
-     * * `none`
+     * @default 'solid'
      */
     set fillMode(fillMode: AvatarFillMode);
     get fillMode(): AvatarFillMode;
@@ -91,17 +86,18 @@ export declare class AvatarComponent implements OnInit, AfterViewInit {
      */
     set fill(fillMode: AvatarFillMode);
     /**
-     * Sets a border to the avatar.
+     * Adds a border to the Avatar.
+     *
+     * @default false
      */
     border: boolean;
     /**
-     * Defines a CSS class — or multiple classes separated by spaces —
-     * which are applied to a span element inside the avatar.
-     * Allows the usage of custom icons.
+     * Defines a CSS class or multiple classes separated by spaces.
+     * You can apply these classes to a `span` element inside the Avatar and also use custom icons.
      */
     iconClass: string;
     /**
-     * Sets the width of the avatar.
+     * Sets the width of the Avatar.
      */
     width: string;
     /**
@@ -109,7 +105,7 @@ export declare class AvatarComponent implements OnInit, AfterViewInit {
      */
     get avatarWidth(): string;
     /**
-     * Sets the height of the avatar.
+     * Sets the height of the Avatar.
      */
     height: string;
     /**
@@ -117,26 +113,26 @@ export declare class AvatarComponent implements OnInit, AfterViewInit {
      */
     get avatarHeight(): string;
     /**
-     * The CSS styles that will be rendered on the content element of the avatar.
-     * Supports the type of values that are supported by [ngStyle](link:site.data.urls.angular['ngstyleapi']).
+     * Defines the CSS styles that render on the content element of the Avatar.
+     * Supports the type of values that [`ngStyle`](link:site.data.urls.angular['ngstyleapi']) supports.
      */
     cssStyle?: any;
     /**
-     * Sets `initials` to the avatar.
+     * Sets the initials for the Avatar.
      */
     initials: string;
     /**
-     * Sets the `icon` for the avatar.
+     * Sets the icon for the Avatar.
      * All [Kendo UI Icons](slug:icons#icons-list) are supported.
      */
     icon: string;
     /**
-     * Sets the `image` source of the avatar.
+     * Sets the image source of the Avatar.
      */
     imageSrc: string;
     /**
-     * Defines an SVGIcon to be rendered.
-     * The input can take either an [existing Kendo SVG icon](slug:svgicon_list) or a custom one.
+     * Defines an SVG icon to render.
+     * You can use either an [existing Kendo SVG icon](slug:svgicon_list) or a custom one.
      */
     set svgIcon(icon: SVGIcon);
     get svgIcon(): SVGIcon;

package/avatar/l10n/custom-messages.component.d.ts

@@ -6,8 +6,16 @@ import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { Messages } from './messages';
 import * as i0 from "@angular/core";
 /**
- * Custom component messages override default component messages
+ * Provides custom component messages that override default component messages
  * ([see example]({% slug rtl_layout %})).
+ *
+ * ```html
+ * <kendo-avatar>
+ *   <kendo-avatar-messages
+ *     avatarAlt="User's profile picture"
+ *   ></kendo-avatar-messages>
+ * </kendo-avatar>
+ * ```
  */
 export declare class AvatarCustomMessagesComponent extends Messages {
     protected service: LocalizationService;

package/avatar/l10n/messages.d.ts

@@ -9,7 +9,7 @@ import * as i0 from "@angular/core";
  */
 export declare class Messages extends ComponentMessages {
     /**
-     * The alt attribute text of the image in the avatar.
+     * Defines the alt attribute text of the image in the Avatar.
      */
     avatarAlt: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<Messages, never>;

package/avatar/models/fill.d.ts

@@ -3,6 +3,6 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Specifies the possible appearance fill styles of the аvatar ([see example](slug:appearance_avatar#toc-fill-mode)).
+ * Defines the possible fill styles of the Avatar ([see example](slug:appearance_avatar#toc-fill-mode)).
  */
 export type AvatarFillMode = 'solid' | 'outline' | 'none';

package/avatar/models/rounded.d.ts

@@ -3,6 +3,6 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Specifies the possible rounded options of the аvatar ([see example](slug:appearance_avatar#roundness)).
+ * Defines the possible rounded options of the Avatar ([see example](slug:appearance_avatar#roundness)).
  */
 export type AvatarRounded = 'small' | 'medium' | 'large' | 'full' | 'none';

package/avatar/models/size.d.ts

@@ -3,6 +3,6 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Specifies the possible sizes of the аvatar ([see example]({% slug appearance_avatar %}#toc-size)).
+ * Defines the possible sizes of the Avatar ([see example]({% slug appearance_avatar %}#toc-size)).
  */
 export type AvatarSize = 'small' | 'medium' | 'large' | 'none';

package/avatar/models/theme-color.d.ts

@@ -3,6 +3,6 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Specifies the possible theme colors of the аvatar ([see example]({% slug appearance_avatar %}#toc-theme-color)).
+ * Defines the possible theme colors of the Avatar ([see example]({% slug appearance_avatar %}#toc-theme-color)).
  */
 export type AvatarThemeColor = 'primary' | 'secondary' | 'tertiary' | 'base' | 'info' | 'success' | 'warning' | 'error' | 'dark' | 'light' | 'inverse' | 'none';

package/avatar.module.d.ts

@@ -6,8 +6,20 @@ import * as i0 from "@angular/core";
 import * as i1 from "./avatar/avatar.component";
 import * as i2 from "./avatar/l10n/custom-messages.component";
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the Avatar component.
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the Avatar component.
+ *
+ * Use this module to add the Avatar component to your NgModule-based Angular application.
+ *
+ * @example
+ * ```typescript
+ * import { AvatarModule } from '@progress/kendo-angular-layout';
+ * import { NgModule } from '@angular/core';
+ *
+ * @NgModule({
+ *   imports: [AvatarModule]
+ * })
+ * export class AppModule { }
+ * ```
  */
 export declare class AvatarModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<AvatarModule, never>;

package/card/card-actions.component.d.ts

@@ -8,8 +8,16 @@ import { CardAction } from './models/card-action';
 import { Orientation } from '../common/orientation';
 import * as i0 from "@angular/core";
 /**
- * Specifies the action buttons of the Card.
- * * ([see example]({% slug actions_card %})).
+ * Defines the action buttons of the Card ([see example]({% slug actions_card %})).
+ * The Card actions can be used to perform operations related to the Card's content, such as saving, editing, or deleting.
+ *
+ * @example
+ * ```html
+ * <kendo-card-actions
+ *   layout="end"
+ *   orientation="horizontal">
+ * </kendo-card-actions>
+ * ```
  */
 export declare class CardActionsComponent {
     hostClass: boolean;
@@ -20,31 +28,24 @@ export declare class CardActionsComponent {
     get verticalClass(): boolean;
     get horizontalClass(): boolean;
     /**
-     * Specifies the layout of the Card action buttons.
-     *
-     * * The possible values are:
-     * * (Default) `horizontal`
-     * * `vertical`
+     * Specifies the orientation of the Card action buttons.
      *
+     * @default 'horizontal'
      */
     orientation: Orientation;
     /**
      * Specifies the layout of the Card action buttons.
      *
-     * The possible values are:
-     * * (Default) `start`
-     * * `center`
-     * * `end`
-     * * `stretched`
-     *
+     * @default 'start'
      */
     layout: ActionsLayout;
     /**
-     * Allows the declarative specification of the Card actions.
+     * Defines the Card actions declaratively.
+     * You can pass an array of `CardAction` objects or a `TemplateRef`.
      */
     set actions(value: CardAction[] | TemplateRef<any>);
     /**
-     * Fires when the user clicks an action button.
+     * Fires when you click an action button.
      */
     action: EventEmitter<CardAction>;
     /**

package/card/card-body.component.d.ts

@@ -4,7 +4,15 @@
 *-------------------------------------------------------------------------------------------*/
 import * as i0 from "@angular/core";
 /**
- * Specifies the content in the Card body.
+ * Defines the content in the Card body.
+ * The body is the main area of the Card where the primary content is displayed.
+ *
+ * @example
+ * ```html
+ * <kendo-card-body>
+ *   <p>Main content of the card.</p>
+ * </kendo-card-body>
+ * ```
  */
 export declare class CardBodyComponent {
     hostClass: boolean;

package/card/card-footer.component.d.ts

@@ -4,7 +4,15 @@
 *-------------------------------------------------------------------------------------------*/
 import * as i0 from "@angular/core";
 /**
- * Specifies the content in the Card footer.
+ * Defines the content in the Card footer.
+ * The footer can include additional information, actions, or links related to the Card's content.
+ *
+ * @example
+ * ```html
+ * <kendo-card-footer>
+ *   <p>Footer content</p>
+ * </kendo-card-footer>
+ * ```
  */
 export declare class CardFooterComponent {
     hostClass: boolean;

package/card/card-header.component.d.ts

@@ -4,7 +4,16 @@
 *-------------------------------------------------------------------------------------------*/
 import * as i0 from "@angular/core";
 /**
- * Specifies the content in the Card header.
+ * Defines the content in the Card header.
+ * The header can include a title, subtitle, and other elements that provide context for the Card's content.
+ *
+ * @example
+ * ```html
+ * <kendo-card-header>
+ *   <h5 kendoCardTitle>Card Title</h5>
+ *   <p kendoCardSubtitle>Card Subtitle</p>
+ * </kendo-card-header>
+ * ```
  */
 export declare class CardHeaderComponent {
     hostClass: boolean;

package/card/card.component.d.ts

@@ -7,7 +7,22 @@ import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { Orientation } from '../common/orientation';
 import * as i0 from "@angular/core";
 /**
- * Represents the [Kendo UI Card component for Angular]({% slug overview_card %})
+ * Represents the Kendo UI Card component for Angular.
+ * Displays content in a structured container with customizable layout and styling ([Card overview]({% slug overview_card %})).
+ *
+ * @example
+ * ```html
+ * <kendo-card orientation="vertical">
+ *   <kendo-card-header>
+ *     <h5 kendoCardTitle>Card Title</h5>
+ *   </kendo-card-header>
+ *   <kendo-card-body>
+ *     <p>Card content goes here.</p>
+ *   </kendo-card-body>
+ * </kendo-card>
+ * ```
+ * @remarks
+ * Supported children components are: {@link CardFooterComponent}, {@link CardHeaderComponent}, {@link CardActionsComponent}, {@link CardBodyComponent}.
  */
 export declare class CardComponent implements OnDestroy {
     private localizationService;
@@ -22,15 +37,13 @@ export declare class CardComponent implements OnDestroy {
     /**
      * Specifies the layout of the Card content.
      *
-     * The possible values are:
-     * * (Default) `vertical`
-     * * `horizontal`
-     *
+     * @default 'vertical'
      */
     orientation: Orientation;
     /**
      * Defines the width of the Card.
-     * Defaults to `285px`.
+     *
+     * @default '285px'
      */
     width: string;
     private dynamicRTLSubscription;

package/card/directives/card-media.directive.d.ts

@@ -4,7 +4,16 @@
 *-------------------------------------------------------------------------------------------*/
 import * as i0 from "@angular/core";
 /**
- * Specifies any media that will be displayed and aligned in the Card.
+ * Defines any media that displays and aligns in the Card.
+ * The media can be an image, video, or any other media type.
+ *
+ * ```html
+ * <kendo-card>
+ *  <div kendoCardMedia>
+ *   <img src="path/to/image.jpg" alt="Card Media">
+ *  </div>
+ * </kendo-card>
+ * ```
  */
 export declare class CardMediaDirective {
     hostClass: boolean;

package/card/directives/card-separator.directive.d.ts

@@ -5,7 +5,15 @@
 import { Orientation } from '../../common/orientation';
 import * as i0 from "@angular/core";
 /**
- * Specifies a separator in the content of the Card.
+ * Defines a separator in the content of the Card.
+ * The separator can be used to visually divide sections within the Card.
+ *
+ * ```html
+ * <kendo-card>
+ *  <div kendoCardSeparator></div>
+ *  <p>Content below the separator</p>
+ * </kendo-card>
+ * ```
  */
 export declare class CardSeparatorDirective {
     hostClass: boolean;
@@ -18,9 +26,7 @@ export declare class CardSeparatorDirective {
     /**
      * Specifies the orientation of the Card separator.
      *
-     * The possible values are:
-     * (Default) `horizontal`
-     * `vertical`
+     * @default 'horizontal'
      */
     orientation: Orientation;
     static ɵfac: i0.ɵɵFactoryDeclaration<CardSeparatorDirective, never>;

package/card/directives/card-subtitle.directive.d.ts

@@ -4,7 +4,14 @@
 *-------------------------------------------------------------------------------------------*/
 import * as i0 from "@angular/core";
 /**
- * Specifies the text and styles for the subtitle of the Card.
+ * Defines the text and styles for the subtitle of the Card.
+ * The subtitle is displayed below the title and above the content of the Card.
+ *
+ * ```html
+ * <kendo-card>
+ *  <h4 kendoCardSubtitle>Card Subtitle</h4>
+ * </kendo-card>
+ * ```
  */
 export declare class CardSubtitleDirective {
     hostClass: boolean;

package/card/directives/card-title.directive.d.ts

@@ -4,7 +4,14 @@
 *-------------------------------------------------------------------------------------------*/
 import * as i0 from "@angular/core";
 /**
- * Specifies the text and styles for the title of the Card.
+ * Defines the text and styles for the title of the Card.
+ * The title is displayed at the top of the Card, above the subtitle and content.
+ *
+ * ```html
+ * <kendo-card>
+ *   <h3 kendoCardTitle>Card Title</h3>
+ * </kendo-card>
+ * ```
  */
 export declare class CardTitleDirective {
     hostClass: boolean;

package/card/models/actions-layout.d.ts

@@ -3,13 +3,6 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Specifies the layout of the Card action buttons.
- *
- * The possible values are:
- * * (Default) `start`
- * * `center`
- * * `end`
- * * `stretched`
- *
+ * Defines the layout of the Card action buttons.
  */
 export type ActionsLayout = 'start' | 'center' | 'end' | 'stretched';

package/card/models/card-action.d.ts

@@ -3,19 +3,19 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * The settings of the Card action buttons.
+ * Defines the settings of the Card action buttons.
  */
 export declare class CardAction {
     /**
-     * Determines if the action button is styled as a primary button.
+     * Specifies whether the action button uses primary styling.
      */
     primary?: boolean;
     /**
-     * Determines if the action button is styled as a flat button.
+     * Specifies whether the action button uses flat styling.
      */
     flat?: boolean;
     /**
-     * The text of the action button.
+     * Defines the text of the action button.
      */
     text: string;
 }

package/card.module.d.ts

@@ -13,8 +13,20 @@ import * as i7 from "./card/directives/card-separator.directive";
 import * as i8 from "./card/directives/card-subtitle.directive";
 import * as i9 from "./card/directives/card-title.directive";
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the Card component.
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the Card component.
+ *
+ * Use this module to add the Card component to your NgModule-based Angular application.
+ *
+ * @example
+ * ```typescript
+ * import { CardModule } from '@progress/kendo-angular-layout';
+ * import { NgModule } from '@angular/core';
+ *
+ * @NgModule({
+ *   imports: [CardModule]
+ * })
+ * export class AppModule { }
+ * ```
  */
 export declare class CardModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<CardModule, never>;

package/codemods/utils.js

@@ -207,8 +207,6 @@ const tsPropertyValueTransformer = (root, j, typeName, oldValue, newValue) => {
             path.node.value.value = newValue;
         }
     });
-    // 2. Find all assignments to variables of the specified type
-    const variablesOfType = new Set();
     // First, collect all variables with the specified type
     root
         .find(j.VariableDeclarator)
@@ -224,7 +222,6 @@ const tsPropertyValueTransformer = (root, j, typeName, oldValue, newValue) => {
     })
         .forEach(path => {
         if (path.node.id.type === 'Identifier') {
-            variablesOfType.add(path.node.id.name);
             // Also update the initial value if it matches
             if (path.node.init &&
                 path.node.init.type === 'StringLiteral' &&

package/common/orientation.d.ts

@@ -3,6 +3,6 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Specifies the orientation of layouts in different scenarios.
+ * Defines the orientation of layouts in different scenarios.
  */
 export type Orientation = 'horizontal' | 'vertical';

package/common/preventable-event.d.ts

@@ -9,16 +9,13 @@ export declare class PreventableEvent {
     private prevented;
     /**
      * Prevents the default action for a specified event.
-     * In this way, the source component suppresses
-     * the built-in behavior that follows the event.
+     * The source component suppresses the built-in behavior that follows the event.
      */
     preventDefault(): void;
     /**
-     * Returns `true` if the event was prevented
-     * by any of its subscribers.
+     * Returns `true` if the event was prevented by any of its subscribers.
      *
-     * @returns `true` if the default action was prevented.
-     * Otherwise, returns `false`.
+     * @returns `true` if the default action was prevented. Otherwise, returns `false`.
      */
     isDefaultPrevented(): boolean;
     /**