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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (197) hide show
  1. package/avatar/avatar.component.d.ts +43 -47
  2. package/avatar/l10n/custom-messages.component.d.ts +9 -1
  3. package/avatar/l10n/messages.d.ts +1 -1
  4. package/avatar/models/fill.d.ts +1 -1
  5. package/avatar/models/rounded.d.ts +1 -1
  6. package/avatar/models/size.d.ts +1 -1
  7. package/avatar/models/theme-color.d.ts +1 -1
  8. package/avatar.module.d.ts +14 -2
  9. package/card/card-actions.component.d.ts +16 -15
  10. package/card/card-body.component.d.ts +9 -1
  11. package/card/card-footer.component.d.ts +9 -1
  12. package/card/card-header.component.d.ts +10 -1
  13. package/card/card.component.d.ts +19 -6
  14. package/card/directives/card-media.directive.d.ts +10 -1
  15. package/card/directives/card-separator.directive.d.ts +10 -4
  16. package/card/directives/card-subtitle.directive.d.ts +8 -1
  17. package/card/directives/card-title.directive.d.ts +8 -1
  18. package/card/models/actions-layout.d.ts +1 -8
  19. package/card/models/card-action.d.ts +4 -4
  20. package/card.module.d.ts +14 -2
  21. package/codemods/utils.js +0 -3
  22. package/common/orientation.d.ts +1 -1
  23. package/common/preventable-event.d.ts +3 -6
  24. package/directives.d.ts +13 -13
  25. package/drawer/drawer-container.component.d.ts +13 -1
  26. package/drawer/drawer-content.component.d.ts +9 -1
  27. package/drawer/drawer.component.d.ts +48 -47
  28. package/drawer/events/select-event.d.ts +5 -5
  29. package/drawer/models/drawer-animation.interface.d.ts +1 -2
  30. package/drawer/models/drawer-item-expand.interface.d.ts +1 -1
  31. package/drawer/models/drawer-item.interface.d.ts +15 -17
  32. package/drawer/models/mode.d.ts +4 -3
  33. package/drawer/models/position.d.ts +1 -6
  34. package/drawer/template-directives/drawer-template.directive.d.ts +18 -5
  35. package/drawer/template-directives/footer-template.directive.d.ts +11 -3
  36. package/drawer/template-directives/header-template.directive.d.ts +11 -3
  37. package/drawer/template-directives/item-template.directive.d.ts +19 -3
  38. package/drawer.module.d.ts +14 -2
  39. package/esm2022/avatar/avatar.component.mjs +43 -47
  40. package/esm2022/avatar/l10n/custom-messages.component.mjs +9 -1
  41. package/esm2022/avatar/l10n/messages.mjs +1 -1
  42. package/esm2022/avatar.module.mjs +14 -2
  43. package/esm2022/card/card-actions.component.mjs +16 -15
  44. package/esm2022/card/card-body.component.mjs +9 -1
  45. package/esm2022/card/card-footer.component.mjs +9 -1
  46. package/esm2022/card/card-header.component.mjs +10 -1
  47. package/esm2022/card/card.component.mjs +19 -6
  48. package/esm2022/card/directives/card-media.directive.mjs +10 -1
  49. package/esm2022/card/directives/card-separator.directive.mjs +10 -4
  50. package/esm2022/card/directives/card-subtitle.directive.mjs +8 -1
  51. package/esm2022/card/directives/card-title.directive.mjs +8 -1
  52. package/esm2022/card/models/card-action.mjs +4 -4
  53. package/esm2022/card.module.mjs +14 -2
  54. package/esm2022/common/preventable-event.mjs +3 -6
  55. package/esm2022/directives.mjs +13 -13
  56. package/esm2022/drawer/drawer-container.component.mjs +13 -1
  57. package/esm2022/drawer/drawer-content.component.mjs +9 -1
  58. package/esm2022/drawer/drawer.component.mjs +48 -47
  59. package/esm2022/drawer/events/select-event.mjs +5 -5
  60. package/esm2022/drawer/template-directives/drawer-template.directive.mjs +18 -5
  61. package/esm2022/drawer/template-directives/footer-template.directive.mjs +11 -3
  62. package/esm2022/drawer/template-directives/header-template.directive.mjs +11 -3
  63. package/esm2022/drawer/template-directives/item-template.directive.mjs +19 -3
  64. package/esm2022/drawer.module.mjs +14 -2
  65. package/esm2022/expansionpanel/events/action-event.mjs +2 -2
  66. package/esm2022/expansionpanel/expansionpanel-title.directive.mjs +12 -3
  67. package/esm2022/expansionpanel/expansionpanel.component.mjs +20 -27
  68. package/esm2022/expansionpanel.module.mjs +14 -2
  69. package/esm2022/gridlayout.module.mjs +14 -2
  70. package/esm2022/layout.module.mjs +10 -21
  71. package/esm2022/layouts/grid-layout.component.mjs +24 -17
  72. package/esm2022/layouts/gridlayout-item.component.mjs +16 -4
  73. package/esm2022/layouts/stack-layout.component.mjs +15 -6
  74. package/esm2022/package-metadata.mjs +2 -2
  75. package/esm2022/panelbar/events/collapse-event.mjs +2 -2
  76. package/esm2022/panelbar/events/expand-event.mjs +2 -2
  77. package/esm2022/panelbar/events/item-click-event.mjs +3 -3
  78. package/esm2022/panelbar/events/select-event.mjs +2 -2
  79. package/esm2022/panelbar/events/state-change-event.mjs +2 -2
  80. package/esm2022/panelbar/panelbar-content.directive.mjs +12 -1
  81. package/esm2022/panelbar/panelbar-expand-mode.mjs +3 -4
  82. package/esm2022/panelbar/panelbar-item-template.directive.mjs +12 -1
  83. package/esm2022/panelbar/panelbar-item-title.directive.mjs +12 -19
  84. package/esm2022/panelbar/panelbar-item.component.mjs +26 -11
  85. package/esm2022/panelbar/panelbar.component.mjs +40 -17
  86. package/esm2022/panelbar.module.mjs +13 -8
  87. package/esm2022/splitter/splitter-pane.component.mjs +40 -20
  88. package/esm2022/splitter/splitter.component.mjs +25 -41
  89. package/esm2022/splitter.module.mjs +13 -5
  90. package/esm2022/stacklayout.module.mjs +14 -2
  91. package/esm2022/stepper/events/activate-event.mjs +5 -5
  92. package/esm2022/stepper/localization/custom-messages.component.mjs +9 -1
  93. package/esm2022/stepper/localization/messages.mjs +1 -1
  94. package/esm2022/stepper/stepper.component.mjs +32 -39
  95. package/esm2022/stepper/stepper.service.mjs +4 -4
  96. package/esm2022/stepper/template-directives/indicator-template.directive.mjs +10 -1
  97. package/esm2022/stepper/template-directives/label-template.directive.mjs +10 -1
  98. package/esm2022/stepper/template-directives/step-template.directive.mjs +12 -1
  99. package/esm2022/stepper.module.mjs +14 -2
  100. package/esm2022/tabstrip/directives/tab-content.directive.mjs +12 -24
  101. package/esm2022/tabstrip/directives/tab-title.directive.mjs +10 -29
  102. package/esm2022/tabstrip/events/select-event.mjs +3 -1
  103. package/esm2022/tabstrip/events/tabclose-event.mjs +2 -1
  104. package/esm2022/tabstrip/events/tabscroll-event.mjs +2 -2
  105. package/esm2022/tabstrip/localization/custom-messages.component.mjs +11 -2
  106. package/esm2022/tabstrip/localization/messages.mjs +3 -3
  107. package/esm2022/tabstrip/models/tabstrip-tab.component.mjs +30 -17
  108. package/esm2022/tabstrip/tabstrip.component.mjs +49 -37
  109. package/esm2022/tabstrip.module.mjs +13 -7
  110. package/esm2022/tilelayout/reorder-event.mjs +3 -2
  111. package/esm2022/tilelayout/resize-event.mjs +3 -2
  112. package/esm2022/tilelayout/tilelayout-item-body.component.mjs +10 -1
  113. package/esm2022/tilelayout/tilelayout-item-header.component.mjs +12 -2
  114. package/esm2022/tilelayout/tilelayout-item.component.mjs +20 -10
  115. package/esm2022/tilelayout/tilelayout.component.mjs +31 -26
  116. package/esm2022/tilelayout.module.mjs +13 -7
  117. package/esm2022/timeline/templates/timeline-card-actions.directive.mjs +11 -2
  118. package/esm2022/timeline/templates/timeline-card-body.directive.mjs +11 -2
  119. package/esm2022/timeline/templates/timeline-card-header.directive.mjs +12 -2
  120. package/esm2022/timeline/timeline.component.mjs +3 -0
  121. package/esm2022/timeline.module.mjs +13 -4
  122. package/expansionpanel/events/action-event.d.ts +3 -3
  123. package/expansionpanel/expansionpanel-title.directive.d.ts +12 -3
  124. package/expansionpanel/expansionpanel.component.d.ts +20 -27
  125. package/expansionpanel.module.d.ts +14 -2
  126. package/fesm2022/progress-kendo-angular-layout.mjs +1072 -641
  127. package/gridlayout.module.d.ts +14 -2
  128. package/layout.module.d.ts +10 -21
  129. package/layouts/grid-layout.component.d.ts +24 -17
  130. package/layouts/gridlayout-item.component.d.ts +16 -4
  131. package/layouts/models/gridlayout-gap-settings.d.ts +3 -3
  132. package/layouts/models/gridlayout-row-col-size.d.ts +4 -4
  133. package/layouts/models/layout-align-settings.d.ts +3 -3
  134. package/layouts/models/layout-horizontal-align.d.ts +1 -1
  135. package/layouts/models/layout-vertical-align.d.ts +1 -1
  136. package/layouts/stack-layout.component.d.ts +15 -6
  137. package/package.json +11 -10
  138. package/panelbar/events/collapse-event.d.ts +2 -2
  139. package/panelbar/events/expand-event.d.ts +2 -2
  140. package/panelbar/events/item-click-event.d.ts +3 -3
  141. package/panelbar/events/select-event.d.ts +2 -2
  142. package/panelbar/events/state-change-event.d.ts +2 -2
  143. package/panelbar/panelbar-content.directive.d.ts +12 -1
  144. package/panelbar/panelbar-expand-mode.d.ts +3 -4
  145. package/panelbar/panelbar-item-model.d.ts +6 -6
  146. package/panelbar/panelbar-item-template.directive.d.ts +12 -1
  147. package/panelbar/panelbar-item-title.directive.d.ts +12 -19
  148. package/panelbar/panelbar-item.component.d.ts +24 -9
  149. package/panelbar/panelbar.component.d.ts +40 -17
  150. package/panelbar.module.d.ts +13 -8
  151. package/splitter/splitter-pane.component.d.ts +40 -20
  152. package/splitter/splitter.component.d.ts +24 -40
  153. package/splitter.module.d.ts +13 -5
  154. package/stacklayout.module.d.ts +14 -2
  155. package/stepper/events/activate-event.d.ts +5 -5
  156. package/stepper/localization/custom-messages.component.d.ts +9 -1
  157. package/stepper/localization/messages.d.ts +1 -1
  158. package/stepper/models/orientation.d.ts +1 -3
  159. package/stepper/models/step-predicate.d.ts +5 -6
  160. package/stepper/models/step-type.d.ts +1 -4
  161. package/stepper/models/stepper-step.interface.d.ts +12 -12
  162. package/stepper/stepper.component.d.ts +32 -39
  163. package/stepper/template-directives/indicator-template.directive.d.ts +10 -1
  164. package/stepper/template-directives/label-template.directive.d.ts +10 -1
  165. package/stepper/template-directives/step-template.directive.d.ts +12 -1
  166. package/stepper.module.d.ts +14 -2
  167. package/tabstrip/directives/tab-content.directive.d.ts +12 -24
  168. package/tabstrip/directives/tab-title.directive.d.ts +10 -29
  169. package/tabstrip/events/select-event.d.ts +3 -1
  170. package/tabstrip/events/tabclose-event.d.ts +2 -1
  171. package/tabstrip/events/tabscroll-event.d.ts +2 -2
  172. package/tabstrip/localization/custom-messages.component.d.ts +11 -2
  173. package/tabstrip/localization/messages.d.ts +3 -3
  174. package/tabstrip/models/scroll-buttons-visibility.d.ts +1 -1
  175. package/tabstrip/models/scrollable-settings.d.ts +17 -22
  176. package/tabstrip/models/size.d.ts +1 -1
  177. package/tabstrip/models/tab-alignment.d.ts +1 -1
  178. package/tabstrip/models/tab-position.d.ts +1 -1
  179. package/tabstrip/models/tabstrip-tab.component.d.ts +30 -17
  180. package/tabstrip/tabstrip.component.d.ts +41 -29
  181. package/tabstrip.module.d.ts +13 -7
  182. package/tilelayout/models/flowmode.type.d.ts +7 -8
  183. package/tilelayout/models/gap.interface.d.ts +3 -5
  184. package/tilelayout/reorder-event.d.ts +3 -2
  185. package/tilelayout/resize-event.d.ts +3 -2
  186. package/tilelayout/tilelayout-item-body.component.d.ts +10 -1
  187. package/tilelayout/tilelayout-item-header.component.d.ts +12 -2
  188. package/tilelayout/tilelayout-item.component.d.ts +20 -10
  189. package/tilelayout/tilelayout.component.d.ts +31 -26
  190. package/tilelayout.module.d.ts +13 -7
  191. package/timeline/events/navigation-direction.d.ts +6 -0
  192. package/timeline/models/anchor-target.d.ts +6 -0
  193. package/timeline/templates/timeline-card-actions.directive.d.ts +11 -2
  194. package/timeline/templates/timeline-card-body.directive.d.ts +11 -2
  195. package/timeline/templates/timeline-card-header.directive.d.ts +12 -2
  196. package/timeline/timeline.component.d.ts +3 -0
  197. package/timeline.module.d.ts +13 -4
@@ -20,6 +20,24 @@ import { TabStripSize } from './models/size';
20
20
  import * as i0 from "@angular/core";
21
21
  /**
22
22
  * Represents the [Kendo UI TabStrip component for Angular]({% slug overview_tabstrip %}).
23
+ *
24
+ * @example
25
+ * ```html
26
+ * <kendo-tabstrip>
27
+ * <kendo-tabstrip-tab [title]="'First Tab'">
28
+ * <ng-template kendoTabContent>
29
+ * <p>Content of the first tab.</p>
30
+ * </ng-template>
31
+ * </kendo-tabstrip-tab>
32
+ * <kendo-tabstrip-tab [title]="'Second Tab'">
33
+ * <ng-template kendoTabContent>
34
+ * <p>Content of the second tab.</p>
35
+ * </ng-template>
36
+ * </kendo-tabstrip-tab>
37
+ * </kendo-tabstrip>
38
+ * ```
39
+ * @remarks
40
+ * Supported children components are: {@link TabStripCustomMessagesComponent}, {@link TabStripTabComponent}.
23
41
  */
24
42
  export declare class TabStripComponent implements AfterViewInit, OnDestroy {
25
43
  localization: LocalizationService;
@@ -30,11 +48,12 @@ export declare class TabStripComponent implements AfterViewInit, OnDestroy {
30
48
  private ngZone;
31
49
  /**
32
50
  * Sets the height of the TabStrip.
51
+ * Accepts a CSS size value, such as `100px`, `50%`, or `auto`.
33
52
  */
34
53
  set height(value: string | null | undefined);
35
54
  get height(): string | null | undefined;
36
55
  /**
37
- * Enables the tab animation.
56
+ * Sets whether the TabStrip should animate when switching tabs.
38
57
  *
39
58
  * @default true
40
59
  */
@@ -42,83 +61,75 @@ export declare class TabStripComponent implements AfterViewInit, OnDestroy {
42
61
  /**
43
62
  * Sets the alignment of the tabs.
44
63
  *
45
- * @default: 'start'
64
+ * @default 'start'
46
65
  */
47
66
  tabAlignment: TabAlignment;
48
67
  /**
49
- * Sets the position of the tabs. Defaults to `top`.
68
+ * Sets the position of the tabs.
50
69
  *
51
70
  * @default 'top'
52
71
  */
53
72
  tabPosition: TabPosition;
54
73
  /**
55
- * When set to `true`, the component renders all tabs and they are persisted in the DOM.
56
- * By default, `keepTabContent` is `false`.
74
+ * When set to `true`, the tabs are persisted in the DOM and their content is not destroyed when they are not selected ([see example](slug:rendering_tabstrip)).
57
75
  *
58
76
  * @default false
59
77
  */
60
78
  keepTabContent: boolean;
61
79
  /**
62
- * When set to `true`, a close button will be rendered inside each tab.
63
- * By default, `closable` is `false`.
80
+ * When set to `true`, renders a close button inside each tab.
64
81
  *
65
82
  * @default false
66
83
  */
67
84
  closable: boolean;
68
85
  /**
69
- * Enables the scrolling of the tab list. When set to `true` and the total size of all tabs
70
- * is greater than the size of the TabStrip container, scroll buttons will be rendered on each end of the tab list.
71
- *
72
- * By default, `scrollable` is `false`.
86
+ * Enables scrolling of the tab list.
87
+ * When set to `true` and the total size of all tabs exceeds the size of the TabStrip container, scroll buttons appear on each end of the tab list.
73
88
  *
74
89
  * @default false
75
90
  */
76
91
  set scrollable(value: boolean | TabStripScrollableSettings);
77
92
  get scrollable(): boolean | TabStripScrollableSettings;
78
93
  /**
79
- * Specifies the size of the TabStrip.
80
- * ([see example](slug:api_layout_tabstripcomponent#toc-size).
81
- *
82
- * The possible values are:
83
- * * `small`
84
- * * `medium` (Default)
85
- * * `large`
86
- * * `none`
94
+ * Sets the size of the TabStrip.
95
+ * [See example](slug:api_layout_tabstripcomponent#toc-size).
96
+ * @default 'medium'
87
97
  */
88
98
  set size(value: TabStripSize);
89
99
  get size(): TabStripSize;
90
100
  /**
91
- * Defines the name for an existing font icon in the Kendo UI theme for the close icon.
101
+ * Defines the name of an existing font icon in the Kendo UI theme for the close icon.
102
+ * @default 'x'
92
103
  */
93
104
  closeIcon: string;
94
105
  /**
95
- * Allows defining a custom CSS class, or multiple classes separated by spaces, which will be applied to the close button.
106
+ * Defines a custom CSS class, or multiple classes separated by spaces, applied to the close button.
96
107
  */
97
108
  closeIconClass: string;
98
109
  /**
99
- * Defines an SVGIcon to be rendered for the close icon.
100
- * The input can take either an [existing Kendo SVG icon](slug:svgicon_list) or a custom one.
110
+ * Defines an SVGIcon to render for the close icon.
111
+ * The input accepts either an [existing Kendo SVG icon](slug:svgicon_list) or a custom one.
101
112
  */
102
113
  set closeSVGIcon(icon: SVGIcon);
103
114
  get closeSVGIcon(): SVGIcon;
104
115
  /**
105
- * Determines whether the content associated with each tab will be rendered.
116
+ * If set to `false`, the content area is hidden, but the tab headers are still visible.
106
117
  *
107
118
  * @default true
108
119
  */
109
120
  showContentArea: boolean;
110
121
  /**
111
- * Fires each time the user selects a tab ([see example](slug:events_tabstrip)).
122
+ * Fires each time a tab is selected.
112
123
  * The event data contains the index of the selected tab and its title.
113
124
  */
114
125
  tabSelect: EventEmitter<SelectEvent>;
115
126
  /**
116
- * Fires each time the user closes a tab.
127
+ * Fires each time a tab is closed.
117
128
  * The event data contains the index of the closed tab and its instance.
118
129
  */
119
130
  tabClose: EventEmitter<TabCloseEvent>;
120
131
  /**
121
- * Fires each time the user scrolls the TabStrip list.
132
+ * Fires when the tab list is scrolled.
122
133
  * The event is preventable.
123
134
  */
124
135
  tabScroll: EventEmitter<TabScrollEvent>;
@@ -191,8 +202,9 @@ export declare class TabStripComponent implements AfterViewInit, OnDestroy {
191
202
  */
192
203
  get itemsWrapperClass(): string;
193
204
  /**
194
- * Allows the user to select a tab programmatically.
195
- * @param {number} index - The index of the tab that will be selected.
205
+ * Allows you to programmatically select a tab by its index.
206
+ * If the tab is disabled, it will not be selected.
207
+ * @param {number} index The index of the tab that will be selected.
196
208
  */
197
209
  selectTab(index: number): void;
198
210
  /**
@@ -9,14 +9,20 @@ import * as i3 from "./tabstrip/directives/tab-content.directive";
9
9
  import * as i4 from "./tabstrip/directives/tab-title.directive";
10
10
  import * as i5 from "./tabstrip/localization/custom-messages.component";
11
11
  /**
12
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
13
- * definition for the TabStrip component.
12
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the TabStrip component.
14
13
  *
15
- * The module registers:
16
- * - `TabStripComponent`&mdash;The `TabStrip` component class.
17
- * - `TabStripTabComponent`&mdash;The `TabStripTab` component class.
18
- * - `TabContentDirective`&mdash;The tab content directive used on the `<ng-template>` tag.
19
- * - `TabTitleDirective`&mdash;The tab title directive used on the `<ng-template>` tag.
14
+ * Use this module to add the TabStrip component to your NgModule-based Angular application.
15
+ *
16
+ * @example
17
+ * ```typescript
18
+ * import { TabStripModule } from '@progress/kendo-angular-layout';
19
+ * import { NgModule } from '@angular/core';
20
+ *
21
+ * @NgModule({
22
+ * imports: [TabStripModule]
23
+ * })
24
+ * export class AppModule { }
25
+ * ```
20
26
  */
21
27
  export declare class TabStripModule {
22
28
  static ɵfac: i0.ɵɵFactoryDeclaration<TabStripModule, never>;
@@ -3,15 +3,14 @@
3
3
  * Licensed under commercial license. See LICENSE.md in the project root for more information
4
4
  *-------------------------------------------------------------------------------------------*/
5
5
  /**
6
- * Controls how the auto-placement algorithm works, specifying exactly how auto-placed items are flowed in the TileLayout.
6
+ * The flow modes controls how auto-placed items are arranged in the TileLayout.
7
7
  * For further reference, check the [grid-auto-flow CSS article](https://developer.mozilla.org/en-US/docs/Web/CSS/grid-auto-flow).
8
8
  *
9
- * The possible values are:
10
- * * (Default) `column`
11
- * * `row`
12
- * * `row-dense`
13
- * * `column-dense`
14
- * * `none`
15
- *
9
+ * The available values are:
10
+ * * `column` (Default)&mdash;Sets the grid-auto-flow CSS property of the TileLayout to column.
11
+ * * `column-dense`&mdash;Sets the grid-auto-flow CSS property of the TileLayout to column dense.
12
+ * *`row`&mdash;Sets the grid-auto-flow CSS property of the TileLayout to row.
13
+ * *`row-dense`&mdash;Sets the grid-auto-flow CSS property of the TileLayout to row dense.
14
+ * *`none`&mdash;Does not apply the grid-auto-flow CSS property. In this case the default behavior of the CSS Grid Layout will be used.
16
15
  */
17
16
  export type TileLayoutFlowMode = 'none' | 'row' | 'column' | 'row-dense' | 'column-dense';
@@ -3,17 +3,15 @@
3
3
  * Licensed under commercial license. See LICENSE.md in the project root for more information
4
4
  *-------------------------------------------------------------------------------------------*/
5
5
  /**
6
- * Тhe values which determine the spacing between the layout items horizontally and vertically.
6
+ * Sets the spacing between layout items horizontally and vertically.
7
7
  */
8
8
  export interface TileLayoutGap {
9
9
  /**
10
- * The vertical spacing. Numeric values are treated as pixels.
11
- * @default 16
10
+ * Sets the vertical spacing in pixels.
12
11
  */
13
12
  rows?: number;
14
13
  /**
15
- * The horizontal spacing. Numeric values are treated as pixels.
16
- * @default 16
14
+ * Sets the horizontal spacing in pixels.
17
15
  */
18
16
  columns?: number;
19
17
  }
@@ -5,8 +5,9 @@
5
5
  import { PreventableEvent } from '@progress/kendo-angular-common';
6
6
  import { TileLayoutItemComponent } from './tilelayout-item.component';
7
7
  /**
8
- * Arguments for the `reorder` event. The event fires when the order or starting
9
- * positions of the items is changed via the UI. If you prevent the event, the change is canceled ([see example]({% slug reordering_tilelayout %}#toc-handling-the-reorder-event)).
8
+ * Arguments for the `reorder` event.
9
+ * The event fires when you change the order or starting positions of items through the UI.
10
+ * You can prevent this event to cancel the reorder operation.
10
11
  */
11
12
  export declare class TileLayoutReorderEvent extends PreventableEvent {
12
13
  item: TileLayoutItemComponent;
@@ -5,8 +5,9 @@
5
5
  import { PreventableEvent } from '@progress/kendo-angular-common';
6
6
  import { TileLayoutItemComponent } from './tilelayout-item.component';
7
7
  /**
8
- * Arguments for the `resize` event. The `resize` event fires when any item size
9
- * is changed from the UI. If you cancel the event, the change is prevented ([see example]({% slug resizing_tilelayout %}#toc-handling-the-resize-event)).
8
+ * Arguments for the `resize` event.
9
+ * The `resize` event fires when you change any item size through the UI.
10
+ * You can prevent this event to stop the resize operation.
10
11
  */
11
12
  export declare class TileLayoutResizeEvent extends PreventableEvent {
12
13
  item: TileLayoutItemComponent;
@@ -4,7 +4,16 @@
4
4
  *-------------------------------------------------------------------------------------------*/
5
5
  import * as i0 from "@angular/core";
6
6
  /**
7
- * Holds the main content of the TileLayoutItem component.
7
+ * Contains the main content of the `TileLayoutItem` component.
8
+ *
9
+ * @example
10
+ * ```html
11
+ * <kendo-tilelayout-item>
12
+ * <kendo-tilelayout-item-body>
13
+ * <p>Main content goes here</p>
14
+ * </kendo-tilelayout-item-body>
15
+ * </kendo-tilelayout-item>
16
+ * ```
8
17
  */
9
18
  export declare class TileLayoutItemBodyComponent {
10
19
  hostClass: boolean;
@@ -4,8 +4,18 @@
4
4
  *-------------------------------------------------------------------------------------------*/
5
5
  import * as i0 from "@angular/core";
6
6
  /**
7
- * Holds the content of the header section of the TileLayoutItem component.
8
- * This is the area which can be dragged to reorder the items if reordering is enabled for this item.
7
+ * Contains the header content of the `TileLayoutItem` component.
8
+ * You can drag this area to reorder items when reordering is enabled.
9
+ *
10
+ * @example
11
+ * ```html
12
+ * <kendo-tilelayout-item>
13
+ * <kendo-tilelayout-item-header>
14
+ * <h3>Custom Header</h3>
15
+ * </kendo-tilelayout-item-header>
16
+ * <p>Item content</p>
17
+ * </kendo-tilelayout-item>
18
+ * ```
9
19
  */
10
20
  export declare class TileLayoutItemHeaderComponent {
11
21
  hostClass: boolean;
@@ -9,6 +9,17 @@ import { TileLayoutKeyboardNavigationService } from './keyboard-navigation.servi
9
9
  import * as i0 from "@angular/core";
10
10
  /**
11
11
  * Represents a tile item within the TileLayoutComponent.
12
+ *
13
+ * @example
14
+ * ```html
15
+ * <kendo-tilelayout>
16
+ * <kendo-tilelayout-item [title]="'Item 1'" [colSpan]="2">
17
+ * <p>Item content goes here</p>
18
+ * </kendo-tilelayout-item>
19
+ * </kendo-tilelayout>
20
+ * ```
21
+ * @remarks
22
+ * Supported children components are: {@link TileLayoutItemBodyComponent}, {@link TileLayoutItemHeaderComponent}.
12
23
  */
13
24
  export declare class TileLayoutItemComponent implements AfterViewInit, OnDestroy, OnChanges {
14
25
  elem: ElementRef;
@@ -18,42 +29,41 @@ export declare class TileLayoutItemComponent implements AfterViewInit, OnDestroy
18
29
  private draggingService;
19
30
  private keyboardNavigationService;
20
31
  /**
21
- * The title that will be rendered in the item header ([see example]({% slug tiles_tilelayout %}#toc-tiles-configuration)).
32
+ * Sets the title text that appears in the item header ([see example]({% slug tiles_tilelayout %}#toc-tiles-configuration)).
22
33
  */
23
34
  title: string;
24
35
  /**
25
- * Determines how many rows will the tile item span ([see example](slug:resizing_tilelayout#programmatic-resizing)).
36
+ * Sets how many rows the tile item spans ([see example](slug:resizing_tilelayout#programmatic-resizing)).
26
37
  * @default 1
27
38
  */
28
39
  rowSpan: number;
29
40
  /**
30
- * Determines how many columns will the tile item span ([see example](slug:resizing_tilelayout#programmatic-resizing)).
41
+ * Sets how many columns the tile item spans ([see example](slug:resizing_tilelayout#programmatic-resizing)).
31
42
  * @default 1
32
43
  */
33
44
  colSpan: number;
34
45
  /**
35
- * Determines the order of the tile items within the TileLayout.
36
- * If not set, the items will receive increasing sequential order in accordance with
37
- * their position in the DOM when initially rendered.
46
+ * Sets the order of the tile item within the TileLayout.
47
+ * When not set, items receive increasing order values based on their DOM position.
38
48
  */
39
49
  set order(value: number);
40
50
  get order(): number;
41
51
  /**
42
- * Sets the starting column of the item ([see example](slug:tiles_tilelayout#size-and-position)).
52
+ * Sets the starting column position of the item ([see example](slug:tiles_tilelayout#size-and-position)).
43
53
  */
44
54
  col: number;
45
55
  /**
46
- * Sets the starting row of the item ([see example](slug:tiles_tilelayout#size-and-position)).
56
+ * Sets the starting row position of the item ([see example](slug:tiles_tilelayout#size-and-position)).
47
57
  */
48
58
  row: number;
49
59
  /**
50
- * Determines whether the item can be reordered. By default all items are reorderable when the [reorderable]({% slug api_layout_tilelayoutcomponent %}#toc-reorderable) property of the TileLayoutComponent is set to `true` ([see example]({% slug reordering_tilelayout %}#toc-disabling-reordering)).
60
+ * Enables or disables individual item reordering.
51
61
  *
52
62
  * @default true
53
63
  */
54
64
  reorderable: boolean;
55
65
  /**
56
- * Determines whether the item can be resized. By default all items are resizable when the [resizable]({% slug api_layout_tilelayoutcomponent %}#resizable) property of the TileLayoutComponent is set to `true` ([see example](slug:resizing_tilelayout#toc-disabling-resizing)).
66
+ * Enables or disables individual item resizing.
57
67
  * @default true
58
68
  */
59
69
  resizable: boolean;
@@ -14,6 +14,16 @@ import { TileLayoutKeyboardNavigationService } from './keyboard-navigation.servi
14
14
  import * as i0 from "@angular/core";
15
15
  /**
16
16
  * Represents the [Kendo UI TileLayout component for Angular]({% slug overview_tilelayout %})
17
+ *
18
+ * @example
19
+ * ```html
20
+ * <kendo-tilelayout [columns]="3" [gap]="10">
21
+ * <kendo-tilelayout-item>Content 1</kendo-tilelayout-item>
22
+ * <kendo-tilelayout-item>Content 2</kendo-tilelayout-item>
23
+ * </kendo-tilelayout>
24
+ * ```
25
+ * @remarks
26
+ * Supported children components are: {@link TileLayoutItemComponent}.
17
27
  */
18
28
  export declare class TileLayoutComponent implements OnInit, AfterViewInit, AfterContentInit, OnDestroy, OnChanges {
19
29
  private zone;
@@ -23,68 +33,62 @@ export declare class TileLayoutComponent implements OnInit, AfterViewInit, After
23
33
  private draggingService;
24
34
  private navigationService;
25
35
  /**
26
- * Defines the number of columns ([see example](slug:tiles_tilelayout#size-and-position)).
36
+ * Specifies the number of columns ([see example](slug:tiles_tilelayout#size-and-position)).
27
37
  * @default 1
28
38
  */
29
39
  columns: number;
30
40
  /**
31
- * Determines the width of the columns. Numeric values are treated as pixels ([see example](slug:tiles_tilelayout#size-and-position)).
41
+ * Sets the width of the columns.
42
+ * Use numeric values for pixels or string values for other CSS units ([see example](slug:tiles_tilelayout#size-and-position)).
32
43
  * @default '1fr'
33
44
  */
34
45
  columnWidth: string | number;
35
46
  /**
36
- * The numeric values which determine the spacing in pixels between the layout items horizontally and vertically.
37
- * Properties:
38
- * * rows - the vertical spacing. Numeric values are treated as pixels. Defaults to `16`.
39
- * * columns - the horizontal spacing. Numeric values are treated as pixels. Defaults to `16`.
47
+ * Sets the spacing between layout items in pixels.
48
+ * Use an object with `rows` and `columns` properties to set different horizontal and vertical spacing.
49
+ * Use a single number to apply the same spacing to both directions.
40
50
  *
41
- * When bound to a single numeric value, it will be set to both `rows` and `columns` properties.
51
+ * @default { rows: 16, columns: 16 }
42
52
  */
43
53
  set gap(value: TileLayoutGap | number);
44
54
  get gap(): TileLayoutGap | number;
45
55
  /**
46
- * Determines whether the reordering functionality will be enabled ([see example]({% slug reordering_tilelayout %})).
56
+ * Enables or disables item reordering ([see example]({% slug reordering_tilelayout %})).
47
57
  * @default false
48
58
  */
49
59
  reorderable: boolean;
50
60
  /**
51
- * Determines whether the resizing functionality will be enabled ([see example]({% slug resizing_tilelayout %})).
61
+ * Enables or disables item resizing ([see example]({% slug resizing_tilelayout %})).
52
62
  * @default false
53
63
  */
54
64
  resizable: boolean;
55
65
  /**
56
- * Determines the height of the rows. Numeric values are treated as pixels ([see example](slug:tiles_tilelayout#size-and-position)).
66
+ * Sets the height of the rows.
67
+ * Use numeric values for pixels or string values for other CSS units ([see example](slug:tiles_tilelayout#size-and-position)).
57
68
  * @default '1fr'
58
69
  */
59
70
  rowHeight: string | number;
60
71
  /**
61
- * Controls how the auto-placement algorithm works, specifying exactly how auto-placed items are flowed in the TileLayout ([see example]({% slug tiles_autoflow_tilelayout %})).
62
- * For further reference, check the [grid-auto-flow CSS article](https://developer.mozilla.org/en-US/docs/Web/CSS/grid-auto-flow).
63
72
  *
64
- * The possible values are:
65
- * * (Default) `column`
66
- * * `row`
67
- * * `row dense`
68
- * * `column dense`
69
- * * `none`
73
+ * Controls how the auto-placement algorithm works, specifying exactly how auto-placed items are flowed in the TileLayout ([see example]({% slug tiles_autoflow_tilelayout %})).
70
74
  *
75
+ * For further reference, check the [grid-auto-flow CSS article](https://developer.mozilla.org/en-US/docs/Web/CSS/grid-auto-flow).
76
+ * @default 'column'
71
77
  */
72
78
  autoFlow: TileLayoutFlowMode;
73
79
  /**
74
- * When the keyboard navigation is enabled, the user can use dedicated shortcuts to interact with the TileLayout.
75
- * By default, navigation is enabled. To disable it and include focusable TileLayout content as a part of the natural tab sequence of the page, set the property to `false`.
76
- *
80
+ * Enables or disables [keyboard navigation](slug:keyboard_navigation_tilelayout).
77
81
  * @default true
78
82
  */
79
83
  navigable: boolean;
80
84
  /**
81
- * Fires when the user completes the reordering of the item ([see example]({% slug reordering_tilelayout %})).
82
- * This event is preventable. If you cancel it, the item will not be reordered.
85
+ * Fires when item reordering is completed ([see example]({% slug reordering_tilelayout %})).
86
+ * You can prevent this event to cancel the reorder operation.
83
87
  */
84
88
  reorder: EventEmitter<TileLayoutReorderEvent>;
85
89
  /**
86
- * Fires when the user completes the resizing of the item ([see example]({% slug resizing_tilelayout %})).
87
- * This event is preventable. If you cancel it, the item will not be resized.
90
+ * Fires when item resizing is completed ([see example]({% slug resizing_tilelayout %})).
91
+ * You can prevent this event to cancel the resize operation.
88
92
  */
89
93
  resize: EventEmitter<TileLayoutResizeEvent>;
90
94
  hostClass: boolean;
@@ -96,7 +100,8 @@ export declare class TileLayoutComponent implements OnInit, AfterViewInit, After
96
100
  get draggedItemWrapper(): HTMLElement;
97
101
  get targetOrder(): number;
98
102
  /**
99
- * A query list of all declared [TileLayoutItemComponent]({% slug api_layout_tilelayoutitemcomponent %}) items.
103
+ * Contains a query list of the `TileLayoutItemComponent` instances that are used in the TileLayout.
104
+ * This allows you to access the items programmatically and manipulate their properties or listen to their events.
100
105
  */
101
106
  items: QueryList<TileLayoutItemComponent>;
102
107
  private hint;
@@ -8,14 +8,20 @@ import * as i2 from "./tilelayout/tilelayout-item-body.component";
8
8
  import * as i3 from "./tilelayout/tilelayout-item.component";
9
9
  import * as i4 from "./tilelayout/tilelayout-item-header.component";
10
10
  /**
11
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
12
- * definition for the TileLayout component.
11
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the TileLayout component.
13
12
  *
14
- * The module registers:
15
- * - `TileLayoutComponent`&mdash;The `TileLayoutComponent` component class.
16
- * - `TileLayoutItemComponent`&mdash;The `TileLayoutItemComponent` component class.
17
- * - `TileLayoutItemHeaderComponent`&mdash;The `TileLayoutItemHeaderComponent` component class.
18
- * - `TileLayoutItemBodyComponent`&mdash;The `TileLayoutItemBodyComponent` component class.
13
+ * Use this module to add the TileLayout component to your NgModule-based Angular application.
14
+ *
15
+ * @example
16
+ * ```typescript
17
+ * import { TileLayoutModule } from '@progress/kendo-angular-layout';
18
+ * import { NgModule } from '@angular/core';
19
+ *
20
+ * @NgModule({
21
+ * imports: [TileLayoutModule]
22
+ * })
23
+ * export class AppModule { }
24
+ * ```
19
25
  */
20
26
  export declare class TileLayoutModule {
21
27
  static ɵfac: i0.ɵɵFactoryDeclaration<TileLayoutModule, never>;
@@ -2,4 +2,10 @@
2
2
  * Copyright © 2025 Progress Software Corporation. All rights reserved.
3
3
  * Licensed under commercial license. See LICENSE.md in the project root for more information
4
4
  *-------------------------------------------------------------------------------------------*/
5
+ /**
6
+ * Specifies the direction for navigating through `Timeline` items.
7
+ *
8
+ * Use 'previous' to navigate to the previous item.
9
+ * Use 'next' to navigate to the next item.
10
+ */
5
11
  export type NavigationDirection = 'previous' | 'next';
@@ -2,4 +2,10 @@
2
2
  * Copyright © 2025 Progress Software Corporation. All rights reserved.
3
3
  * Licensed under commercial license. See LICENSE.md in the project root for more information
4
4
  *-------------------------------------------------------------------------------------------*/
5
+ /**
6
+ * Defines the target for opening links in the Timeline component.
7
+ *
8
+ * Use 'self' to open the link in the same window or tab.
9
+ * Use 'blank' to open the link in a new window or tab.
10
+ */
5
11
  export type AnchorTarget = 'self' | 'blank';
@@ -9,8 +9,17 @@ import * as i0 from "@angular/core";
9
9
  * with the `kendoTimelineCardActionsTemplate` directive inside the `<kendo-timeline>` tag.
10
10
  *
11
11
  * The following values are available as context variables:
12
- * - `let-event="event"` (`TimelineEvent`) - The current card's event. Also available as implicit context variable.
13
- * - `let-index="index"` (`number`) - The current event index.
12
+ * - `let-event="event"` (`TimelineEvent`)&mdash;The current card's event. Also available as implicit context variable.
13
+ * - `let-index="index"` (`number`)&mdash;The current event index.
14
+ *
15
+ * @example
16
+ * ```html
17
+ * <kendo-timeline [events]="events">
18
+ * <ng-template kendoTimelineCardActionsTemplate let-event let-index="index">
19
+ * Content for the actions of the card with index {{ index }} and event {{ event.title }}.
20
+ * </ng-template>
21
+ * </kendo-timeline>
22
+ * ```
14
23
  */
15
24
  export declare class TimelineCardActionsTemplateDirective {
16
25
  templateRef: TemplateRef<any>;
@@ -9,8 +9,17 @@ import * as i0 from "@angular/core";
9
9
  * with the `kendoTimelineCardBodyTemplate` directive inside the `<kendo-timeline>` tag.
10
10
  *
11
11
  * The following values are available as context variables:
12
- * - `let-event="event"` (`TimelineEvent`) - The current card's event. Also available as implicit context variable.
13
- * - `let-index="index"` (`number`) - The current event index.
12
+ * - `let-event="event"` (`TimelineEvent`)&mdash;The current card's event. Also available as implicit context variable.
13
+ * - `let-index="index"` (`number`)&mdash;The current event index.
14
+ *
15
+ * @example
16
+ * ```html
17
+ * <kendo-timeline [events]="events">
18
+ * <ng-template kendoTimelineCardBodyTemplate let-event let-index="index">
19
+ * Component for the body of the card with index {{ index }} and event {{ event.title }}.
20
+ * </ng-template>
21
+ * </kendo-timeline>
22
+ * ```
14
23
  */
15
24
  export declare class TimelineCardBodyTemplateDirective {
16
25
  templateRef: TemplateRef<any>;
@@ -9,8 +9,18 @@ import * as i0 from "@angular/core";
9
9
  * with the `kendoTimelineCardHeaderTemplate` directive inside the `<kendo-timeline>` tag.
10
10
  *
11
11
  * The following values are available as context variables:
12
- * - `let-event="event"` (`TimelineEvent`) - The current card's event. Also available as implicit context variable.
13
- * - `let-index="index"` (`number`) - The current event index.
12
+ * - `let-event="event"` (`TimelineEvent`)&mdash;The current card's event. Also available as implicit context variable.
13
+ * - `let-index="index"` (`number`)&mdash;The current event index.
14
+ *
15
+ * @example
16
+ * ```html
17
+ * <kendo-timeline [events]="events">
18
+ * <ng-template kendoTimelineCardHeaderTemplate let-event let-index="index">
19
+ * <span class="k-event-title">Title: {{ event.title }}</span>
20
+ * <div kendoCardSubtitle>Event number {{ index }}</div>
21
+ * </ng-template>
22
+ * </kendo-timeline>
23
+ * ```
14
24
  */
15
25
  export declare class TimelineCardHeaderTemplateDirective {
16
26
  templateRef: TemplateRef<any>;
@@ -15,6 +15,9 @@ import { TimelineCardActionsTemplateDirective } from './templates/timeline-card-
15
15
  import * as i0 from "@angular/core";
16
16
  /**
17
17
  * Represents the [Kendo UI Timeline component for Angular]({% slug overview_timeline %}).
18
+ *
19
+ * @remarks
20
+ * Supported children components are: {@link TimelineCustomMessagesComponent}.
18
21
  */
19
22
  export declare class TimelineComponent implements AfterContentInit, OnDestroy {
20
23
  private timelineService;
@@ -9,11 +9,20 @@ import * as i3 from "./timeline/templates/timeline-card-actions.directive";
9
9
  import * as i4 from "./timeline/templates/timeline-card-body.directive";
10
10
  import * as i5 from "./timeline/templates/timeline-card-header.directive";
11
11
  /**
12
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
13
- * definition for the Timeline component.
12
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the Timeline component.
14
13
  *
15
- * The module registers:
16
- * - `TimelineComponent`&mdash;The `TimelineComponent` component class.
14
+ * Use this module to add the Timeline component to your NgModule-based Angular application.
15
+ *
16
+ * @example
17
+ * ```typescript
18
+ * import { TimelineModule } from '@progress/kendo-angular-layout';
19
+ * import { NgModule } from '@angular/core';
20
+ *
21
+ * @NgModule({
22
+ * imports: [TimelineModule]
23
+ * })
24
+ * export class AppModule { }
25
+ * ```
17
26
  */
18
27
  export declare class TimelineModule {
19
28
  static ɵfac: i0.ɵɵFactoryDeclaration<TimelineModule, never>;