@progress/kendo-angular-scheduler 19.1.2-develop.4 → 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 (161) hide show
  1. package/data-binding.directive.d.ts +12 -3
  2. package/directives.d.ts +42 -2
  3. package/editing/edit-dialog-template.directive.d.ts +15 -2
  4. package/editing/recurrence/recurrence-editor.component.d.ts +29 -10
  5. package/editing/timezone-editor.component.d.ts +13 -3
  6. package/editing-directives/base-edit.service.d.ts +8 -11
  7. package/editing-directives/edit-service.interface.d.ts +22 -24
  8. package/editing-directives/reactive-editing.directive.d.ts +15 -2
  9. package/esm2022/data-binding.directive.mjs +12 -3
  10. package/esm2022/directives.mjs +42 -2
  11. package/esm2022/editing/edit-dialog-template.directive.mjs +15 -2
  12. package/esm2022/editing/recurrence/recurrence-editor.component.mjs +29 -10
  13. package/esm2022/editing/timezone-editor.component.mjs +13 -3
  14. package/esm2022/editing-directives/base-edit.service.mjs +8 -11
  15. package/esm2022/editing-directives/reactive-editing.directive.mjs +15 -2
  16. package/esm2022/events/add-event.mjs +3 -3
  17. package/esm2022/events/cancel-event.mjs +2 -2
  18. package/esm2022/events/create-event.mjs +6 -6
  19. package/esm2022/events/date-change-event.mjs +4 -4
  20. package/esm2022/events/drag-end-event.mjs +8 -8
  21. package/esm2022/events/drag-event.mjs +8 -8
  22. package/esm2022/events/drag-start-event.mjs +4 -4
  23. package/esm2022/events/edit-event.mjs +4 -4
  24. package/esm2022/events/event-click-event.mjs +5 -5
  25. package/esm2022/events/event-keydown-event.mjs +4 -4
  26. package/esm2022/events/navigate-event.mjs +3 -3
  27. package/esm2022/events/remove-event.mjs +4 -4
  28. package/esm2022/events/resize-end-event.mjs +6 -6
  29. package/esm2022/events/resize-event.mjs +8 -8
  30. package/esm2022/events/resize-start-event.mjs +4 -4
  31. package/esm2022/events/save-event.mjs +3 -3
  32. package/esm2022/events/slot-click-event.mjs +7 -7
  33. package/esm2022/events/slot-drag-end-event.mjs +1 -1
  34. package/esm2022/events/slot-drag-event.mjs +7 -7
  35. package/esm2022/events/slot-drag-start-event.mjs +8 -7
  36. package/esm2022/localization/custom-messages.component.mjs +14 -1
  37. package/esm2022/localization/messages.mjs +98 -98
  38. package/esm2022/package-metadata.mjs +2 -2
  39. package/esm2022/pdf/pdf-command.directive.mjs +11 -11
  40. package/esm2022/pdf/pdf-export-event.mjs +1 -1
  41. package/esm2022/pdf/pdf.component.mjs +19 -8
  42. package/esm2022/pdf/pdf.module.mjs +7 -8
  43. package/esm2022/scheduler.component.mjs +62 -62
  44. package/esm2022/scheduler.module.mjs +6 -7
  45. package/esm2022/toolbar/navigation.component.mjs +16 -7
  46. package/esm2022/toolbar/toolbar-template.directive.mjs +18 -10
  47. package/esm2022/toolbar/toolbar.service.mjs +3 -4
  48. package/esm2022/toolbar/view-selector.component.mjs +14 -8
  49. package/esm2022/types/crud-operation.enum.mjs +3 -3
  50. package/esm2022/types/edit-mode.enum.mjs +2 -2
  51. package/esm2022/types/scheduler-view.mjs +1 -1
  52. package/esm2022/views/agenda/agenda-view.component.mjs +15 -11
  53. package/esm2022/views/common/slot-selectable.directive.mjs +16 -4
  54. package/esm2022/views/month/month-view.component.mjs +17 -16
  55. package/esm2022/views/month/multi-week-view.component.mjs +20 -18
  56. package/esm2022/views/multi-day/day-view.component.mjs +12 -7
  57. package/esm2022/views/multi-day/multi-day-view.component.mjs +16 -11
  58. package/esm2022/views/multi-day/week-view.component.mjs +14 -11
  59. package/esm2022/views/multi-day/work-week-view.component.mjs +8 -1
  60. package/esm2022/views/scheduler-view.directive.mjs +13 -3
  61. package/esm2022/views/templates/agenda-date-template.directive.mjs +13 -3
  62. package/esm2022/views/templates/agenda-time-template.directive.mjs +13 -3
  63. package/esm2022/views/templates/all-day-event-template.directive.mjs +13 -3
  64. package/esm2022/views/templates/all-day-slot-template.directive.mjs +13 -3
  65. package/esm2022/views/templates/date-header-template.directive.mjs +14 -4
  66. package/esm2022/views/templates/event-template.directive.mjs +13 -3
  67. package/esm2022/views/templates/group-header-template.directive.mjs +14 -4
  68. package/esm2022/views/templates/major-time-header-template.directive.mjs +13 -3
  69. package/esm2022/views/templates/minor-time-header-template.directive.mjs +13 -3
  70. package/esm2022/views/templates/month-day-slot-template.directive.mjs +13 -3
  71. package/esm2022/views/templates/multi-week-day-slot-template.directive.mjs +12 -3
  72. package/esm2022/views/templates/time-slot-template.directive.mjs +14 -4
  73. package/esm2022/views/timeline/timeline-month-view.component.mjs +16 -11
  74. package/esm2022/views/timeline/timeline-view.component.mjs +16 -11
  75. package/esm2022/views/timeline/timeline-week-view.component.mjs +18 -14
  76. package/esm2022/views/view-context.service.mjs +6 -6
  77. package/esm2022/views/view-state.service.mjs +9 -9
  78. package/esm2022/views/year/year-view.component.mjs +12 -7
  79. package/events/add-event.d.ts +3 -3
  80. package/events/cancel-event.d.ts +2 -2
  81. package/events/create-event.d.ts +6 -6
  82. package/events/date-change-event.d.ts +4 -4
  83. package/events/drag-end-event.d.ts +8 -8
  84. package/events/drag-event.d.ts +8 -8
  85. package/events/drag-start-event.d.ts +4 -4
  86. package/events/edit-event.d.ts +4 -4
  87. package/events/event-click-event.d.ts +5 -5
  88. package/events/event-keydown-event.d.ts +4 -4
  89. package/events/navigate-event.d.ts +3 -3
  90. package/events/remove-event.d.ts +4 -4
  91. package/events/resize-end-event.d.ts +6 -6
  92. package/events/resize-event.d.ts +8 -8
  93. package/events/resize-start-event.d.ts +4 -4
  94. package/events/save-event.d.ts +3 -3
  95. package/events/slot-click-event.d.ts +7 -7
  96. package/events/slot-drag-end-event.d.ts +1 -1
  97. package/events/slot-drag-event.d.ts +7 -7
  98. package/events/slot-drag-start-event.d.ts +8 -7
  99. package/fesm2022/progress-kendo-angular-scheduler.mjs +876 -543
  100. package/localization/custom-messages.component.d.ts +14 -1
  101. package/localization/messages.d.ts +98 -98
  102. package/navigation/focus-position.interface.d.ts +2 -3
  103. package/package.json +15 -15
  104. package/pdf/pdf-command.directive.d.ts +11 -11
  105. package/pdf/pdf-export-event.d.ts +1 -1
  106. package/pdf/pdf.component.d.ts +19 -8
  107. package/pdf/pdf.module.d.ts +7 -8
  108. package/scheduler.component.d.ts +62 -62
  109. package/scheduler.module.d.ts +6 -7
  110. package/schematics/ngAdd/index.js +3 -3
  111. package/toolbar/navigation.component.d.ts +16 -7
  112. package/toolbar/toolbar-template.directive.d.ts +18 -10
  113. package/toolbar/toolbar.service.d.ts +3 -4
  114. package/toolbar/view-selector.component.d.ts +14 -8
  115. package/types/actions.d.ts +51 -45
  116. package/types/create-form-group-args.interface.d.ts +1 -1
  117. package/types/crud-operation.enum.d.ts +3 -3
  118. package/types/current-time-settings.interface.d.ts +10 -8
  119. package/types/date-range.interface.d.ts +7 -11
  120. package/types/datepicker-options.interface.d.ts +33 -38
  121. package/types/edit-event-args.interface.d.ts +3 -4
  122. package/types/edit-mode.enum.d.ts +2 -2
  123. package/types/editable-settings.interface.d.ts +6 -6
  124. package/types/event-style-args.interface.d.ts +4 -4
  125. package/types/group.interface.d.ts +2 -2
  126. package/types/numeric-options.interface.d.ts +20 -16
  127. package/types/ongoing-events-settings.interface.d.ts +8 -6
  128. package/types/resource.interface.d.ts +8 -8
  129. package/types/scheduler-event.d.ts +13 -15
  130. package/types/scheduler-model-fields.interface.d.ts +34 -23
  131. package/types/scheduler-slot.interface.d.ts +7 -7
  132. package/types/scheduler-view.d.ts +3 -5
  133. package/types/slot-class-args.interface.d.ts +6 -6
  134. package/types/view-item.interface.d.ts +1 -1
  135. package/views/agenda/agenda-view.component.d.ts +15 -11
  136. package/views/common/slot-selectable.directive.d.ts +16 -4
  137. package/views/month/month-view.component.d.ts +17 -16
  138. package/views/month/multi-week-view.component.d.ts +20 -18
  139. package/views/multi-day/day-view.component.d.ts +12 -7
  140. package/views/multi-day/multi-day-view.component.d.ts +16 -11
  141. package/views/multi-day/week-view.component.d.ts +14 -11
  142. package/views/multi-day/work-week-view.component.d.ts +8 -1
  143. package/views/scheduler-view.directive.d.ts +13 -3
  144. package/views/templates/agenda-date-template.directive.d.ts +13 -3
  145. package/views/templates/agenda-time-template.directive.d.ts +13 -3
  146. package/views/templates/all-day-event-template.directive.d.ts +13 -3
  147. package/views/templates/all-day-slot-template.directive.d.ts +13 -3
  148. package/views/templates/date-header-template.directive.d.ts +14 -4
  149. package/views/templates/event-template.directive.d.ts +13 -3
  150. package/views/templates/group-header-template.directive.d.ts +14 -4
  151. package/views/templates/major-time-header-template.directive.d.ts +13 -3
  152. package/views/templates/minor-time-header-template.directive.d.ts +13 -3
  153. package/views/templates/month-day-slot-template.directive.d.ts +13 -3
  154. package/views/templates/multi-week-day-slot-template.directive.d.ts +12 -3
  155. package/views/templates/time-slot-template.directive.d.ts +14 -4
  156. package/views/timeline/timeline-month-view.component.d.ts +16 -11
  157. package/views/timeline/timeline-view.component.d.ts +16 -11
  158. package/views/timeline/timeline-week-view.component.d.ts +18 -14
  159. package/views/view-context.service.d.ts +6 -6
  160. package/views/view-state.service.d.ts +9 -9
  161. package/views/year/year-view.component.d.ts +12 -7
@@ -43,25 +43,25 @@ const packageMetadata = {
43
43
  productName: 'Kendo UI for Angular',
44
44
  productCode: 'KENDOUIANGULAR',
45
45
  productCodes: ['KENDOUIANGULAR'],
46
- publishDate: 1750157267,
47
- version: '19.1.2-develop.4',
46
+ publishDate: 1750431181,
47
+ version: '19.1.2-develop.5',
48
48
  licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
49
49
  };
50
50
 
51
51
  /**
52
- * Arguments for the `dateChange` event.
52
+ * Represents the arguments for the `dateChange` event.
53
53
  */
54
54
  class DateChangeEvent {
55
55
  /**
56
- * The currently selected date of the Scheduler.
56
+ * Provides the currently selected date of the Scheduler.
57
57
  */
58
58
  selectedDate;
59
59
  /**
60
- * The date range of the current view.
60
+ * Provides the date range of the current view.
61
61
  */
62
62
  dateRange;
63
63
  /**
64
- * A reference to the Scheduler instance that triggered the event.
64
+ * Provides a reference to the Scheduler instance that triggered the event.
65
65
  */
66
66
  sender;
67
67
  /**
@@ -75,15 +75,15 @@ class DateChangeEvent {
75
75
  }
76
76
 
77
77
  /**
78
- * Arguments for the `navigate` event.
78
+ * Represents the arguments for the `navigate` event.
79
79
  */
80
80
  class NavigateEvent extends PreventableEvent$1 {
81
81
  /**
82
- * The navigation action that triggered the event.
82
+ * Provides the navigation action that triggered the event.
83
83
  */
84
84
  action;
85
85
  /**
86
- * A reference to the Scheduler instance that triggered the event.
86
+ * Provides a reference to the Scheduler instance that triggered the event.
87
87
  */
88
88
  sender;
89
89
  /**
@@ -97,19 +97,19 @@ class NavigateEvent extends PreventableEvent$1 {
97
97
  }
98
98
 
99
99
  /**
100
- * Arguments for `slotClick` and `slotDblClick` events.
100
+ * Represents the arguments for the `slotClick` and `slotDblClick` events.
101
101
  */
102
102
  class SlotClickEvent {
103
103
  /**
104
- * The event type.
104
+ * Provides the event type.
105
105
  */
106
106
  type;
107
107
  /**
108
- * The start date of the slot.
108
+ * Provides the start date of the slot.
109
109
  */
110
110
  start;
111
111
  /**
112
- * The end date of the slot.
112
+ * Provides the end date of the slot.
113
113
  */
114
114
  end;
115
115
  /**
@@ -117,15 +117,15 @@ class SlotClickEvent {
117
117
  */
118
118
  isAllDay;
119
119
  /**
120
- * The resources of the slot.
120
+ * Provides the resources of the slot.
121
121
  */
122
122
  resources;
123
123
  /**
124
- * The original DOM event.
124
+ * Provides the original DOM event.
125
125
  */
126
126
  originalEvent;
127
127
  /**
128
- * A reference to the Scheduler instance that triggered the event.
128
+ * Provides a reference to the Scheduler instance that triggered the event.
129
129
  */
130
130
  sender;
131
131
  /**
@@ -138,23 +138,23 @@ class SlotClickEvent {
138
138
  }
139
139
 
140
140
  /**
141
- * Arguments for the `eventClick` and `eventDblClick` events.
141
+ * Represents the arguments for the `eventClick` and `eventDblClick` events.
142
142
  */
143
143
  class EventClickEvent {
144
144
  /**
145
- * The event type.
145
+ * Provides the event type.
146
146
  */
147
147
  type;
148
148
  /**
149
- * The original Scheduler event.
149
+ * Provides the original Scheduler event.
150
150
  */
151
151
  event;
152
152
  /**
153
- * The original DOM event.
153
+ * Provides the original DOM event.
154
154
  */
155
155
  originalEvent;
156
156
  /**
157
- * A reference to the Scheduler instance that triggered the event.
157
+ * Provides a reference to the Scheduler instance that triggered the event.
158
158
  */
159
159
  sender;
160
160
  /**
@@ -167,19 +167,19 @@ class EventClickEvent {
167
167
  }
168
168
 
169
169
  /**
170
- * Arguments for the `eventKeydown` event.
170
+ * Represents the arguments for the `eventKeydown` event.
171
171
  */
172
172
  class EventKeydownEvent {
173
173
  /**
174
- * The original Scheduler event.
174
+ * Provides the original Scheduler event.
175
175
  */
176
176
  event;
177
177
  /**
178
- * The original DOM event.
178
+ * Provides the original DOM event.
179
179
  */
180
180
  originalEvent;
181
181
  /**
182
- * A reference to the Scheduler instance that triggered the event.
182
+ * Provides a reference to the Scheduler instance that triggered the event.
183
183
  */
184
184
  sender;
185
185
  /**
@@ -192,15 +192,15 @@ class EventKeydownEvent {
192
192
  }
193
193
 
194
194
  /**
195
- * Arguments for the `create` event.
195
+ * Represents the arguments for the `create` event.
196
196
  */
197
197
  class CreateEvent {
198
198
  /**
199
- * The start date of the slot.
199
+ * Provides the start date of the slot.
200
200
  */
201
201
  start;
202
202
  /**
203
- * The end date of the slot.
203
+ * Provides the end date of the slot.
204
204
  */
205
205
  end;
206
206
  /**
@@ -208,15 +208,15 @@ class CreateEvent {
208
208
  */
209
209
  isAllDay;
210
210
  /**
211
- * The resources of the slot.
211
+ * Provides the resources of the slot.
212
212
  */
213
213
  resources;
214
214
  /**
215
- * The original DOM event.
215
+ * Provides the original DOM event.
216
216
  */
217
217
  originalEvent;
218
218
  /**
219
- * A reference to the Scheduler instance that triggered the event.
219
+ * Provides a reference to the Scheduler instance that triggered the event.
220
220
  */
221
221
  sender;
222
222
  /**
@@ -254,35 +254,35 @@ class PreventableEvent {
254
254
  }
255
255
 
256
256
  /**
257
- * Arguments for the `dragEnd` event.
257
+ * Represents the arguments for the `dragEnd` event.
258
258
  */
259
259
  class DragEndEvent extends PreventableEvent {
260
260
  /**
261
- * The original Scheduler event.
261
+ * Provides the original Scheduler event.
262
262
  */
263
263
  event;
264
264
  /**
265
- * The `isAllDay` value.
265
+ * Provides the `isAllDay` value.
266
266
  */
267
267
  isAllDay;
268
268
  /**
269
- * The data item of the event.
269
+ * Provides the data item of the event.
270
270
  */
271
271
  dataItem;
272
272
  /**
273
- * The new start date of the event.
273
+ * Provides the new start date of the event.
274
274
  */
275
275
  start;
276
276
  /**
277
- * The new end date of the event.
277
+ * Provides the new end date of the event.
278
278
  */
279
279
  end;
280
280
  /**
281
- * The resources when ending the dragging.
281
+ * Provides the resources when ending the dragging.
282
282
  */
283
283
  resources;
284
284
  /**
285
- * A reference to the Scheduler instance that triggered the event.
285
+ * Provides a reference to the Scheduler instance that triggered the event.
286
286
  */
287
287
  sender;
288
288
  /**
@@ -296,31 +296,31 @@ class DragEndEvent extends PreventableEvent {
296
296
  }
297
297
 
298
298
  /**
299
- * Arguments for the `drag` event.
299
+ * Represents the arguments for the `drag` event.
300
300
  */
301
301
  class DragEvent extends PreventableEvent {
302
302
  /**
303
- * The original Scheduler event.
303
+ * Provides the original Scheduler event.
304
304
  */
305
305
  event;
306
306
  /**
307
- * The current `isAllDay` value.
307
+ * Provides the current `isAllDay` value.
308
308
  */
309
309
  isAllDay;
310
310
  /**
311
- * The data item of the event.
311
+ * Provides the data item of the event.
312
312
  */
313
313
  dataItem;
314
314
  /**
315
- * The new start date of the event.
315
+ * Provides the new start date of the event.
316
316
  */
317
317
  start;
318
318
  /**
319
- * The new end date of the event.
319
+ * Provides the new end date of the event.
320
320
  */
321
321
  end;
322
322
  /**
323
- * The current resources while dragging.
323
+ * Provides the current resources while dragging.
324
324
  */
325
325
  resources;
326
326
  /**
@@ -332,7 +332,7 @@ class DragEvent extends PreventableEvent {
332
332
  */
333
333
  setSlotClass;
334
334
  /**
335
- * A reference to the Scheduler instance that triggered the event.
335
+ * Provides a reference to the Scheduler instance that triggered the event.
336
336
  */
337
337
  sender;
338
338
  /**
@@ -346,19 +346,19 @@ class DragEvent extends PreventableEvent {
346
346
  }
347
347
 
348
348
  /**
349
- * Arguments for the `dragStart` event.
349
+ * Represents the arguments for the `dragStart` event.
350
350
  */
351
351
  class DragStartEvent extends PreventableEvent {
352
352
  /**
353
- * The original Scheduler event.
353
+ * Provides the original Scheduler event.
354
354
  */
355
355
  event;
356
356
  /**
357
- * The data item of the event.
357
+ * Provides the data item of the event.
358
358
  */
359
359
  dataItem;
360
360
  /**
361
- * A reference to the Scheduler instance that triggered the event.
361
+ * Provides a reference to the Scheduler instance that triggered the event.
362
362
  */
363
363
  sender;
364
364
  /**
@@ -372,19 +372,19 @@ class DragStartEvent extends PreventableEvent {
372
372
  }
373
373
 
374
374
  /**
375
- * Arguments for the `remove` event.
375
+ * Represents the arguments for the `remove` event.
376
376
  */
377
377
  class RemoveEvent extends PreventableEvent {
378
378
  /**
379
- * The event data item whose **Remove** icon is clicked.
379
+ * Provides the event data item whose **Remove** icon is clicked.
380
380
  */
381
381
  dataItem;
382
382
  /**
383
- * The event whose **Remove** icon is clicked.
383
+ * Provides the event whose **Remove** icon is clicked.
384
384
  */
385
385
  event;
386
386
  /**
387
- * A reference to the Scheduler instance that triggered the event.
387
+ * Provides a reference to the Scheduler instance that triggered the event.
388
388
  */
389
389
  sender;
390
390
  /**
@@ -398,27 +398,27 @@ class RemoveEvent extends PreventableEvent {
398
398
  }
399
399
 
400
400
  /**
401
- * Arguments for the `resizeEnd` event.
401
+ * Represents the arguments for the `resizeEnd` event.
402
402
  */
403
403
  class ResizeEndEvent extends PreventableEvent {
404
404
  /**
405
- * The original Scheduler event.
405
+ * Provides the original Scheduler event.
406
406
  */
407
407
  event;
408
408
  /**
409
- * The data item of the event.
409
+ * Provides the data item of the event.
410
410
  */
411
411
  dataItem;
412
412
  /**
413
- * The new start date of the event.
413
+ * Provides the new start date of the event.
414
414
  */
415
415
  start;
416
416
  /**
417
- * The new end date of the event.
417
+ * Provides the new end date of the event.
418
418
  */
419
419
  end;
420
420
  /**
421
- * A reference to the Scheduler instance that triggered the event.
421
+ * Provides a reference to the Scheduler instance that triggered the event.
422
422
  */
423
423
  sender;
424
424
  /**
@@ -432,35 +432,35 @@ class ResizeEndEvent extends PreventableEvent {
432
432
  }
433
433
 
434
434
  /**
435
- * Arguments for the `resize` event.
435
+ * Represents the arguments for the `resize` event.
436
436
  */
437
437
  class ResizeEvent extends PreventableEvent {
438
438
  /**
439
- * The original Scheduler event.
439
+ * Provides the original Scheduler event.
440
440
  */
441
441
  event;
442
442
  /**
443
- * The data item of the event.
443
+ * Provides the data item of the event.
444
444
  */
445
445
  dataItem;
446
446
  /**
447
- * The new start date of the event.
447
+ * Provides the new start date of the event.
448
448
  */
449
449
  start;
450
450
  /**
451
- * The new end date of the event.
451
+ * Provides the new end date of the event.
452
452
  */
453
453
  end;
454
454
  /**
455
- * A reference to the Scheduler instance that triggered the event.
455
+ * Provides a reference to the Scheduler instance that triggered the event.
456
456
  */
457
457
  sender;
458
458
  /**
459
- * Sets the class to the resize hint ([see example]({% slug restrictions_scheduler %})).
459
+ * Provides a method to set the class to the resize hint.
460
460
  */
461
461
  setHintClass;
462
462
  /**
463
- * Sets the class to the slot over which the event is resized.
463
+ * Provides a method to set the class to the slot over which the event is resized.
464
464
  */
465
465
  setSlotClass;
466
466
  /**
@@ -474,19 +474,19 @@ class ResizeEvent extends PreventableEvent {
474
474
  }
475
475
 
476
476
  /**
477
- * Arguments for the `resizeStart` event.
477
+ * Represents the arguments for the `resizeStart` event.
478
478
  */
479
479
  class ResizeStartEvent extends PreventableEvent {
480
480
  /**
481
- * The original Scheduler event.
481
+ * Provides the original Scheduler event.
482
482
  */
483
483
  event;
484
484
  /**
485
- * The data item of the event.
485
+ * Provides the data item of the event.
486
486
  */
487
487
  dataItem;
488
488
  /**
489
- * A reference to the Scheduler instance that triggered the event.
489
+ * Provides a reference to the Scheduler instance that triggered the event.
490
490
  */
491
491
  sender;
492
492
  /**
@@ -550,43 +550,43 @@ class EditEventBase {
550
550
  }
551
551
 
552
552
  /**
553
- * Arguments for the `cancel` event.
553
+ * Represents the arguments for the `cancel` event.
554
554
  */
555
555
  class CancelEvent extends EditEventBase {
556
556
  /**
557
- * The edited `formGroup` instance.
557
+ * Provides the edited `formGroup` instance.
558
558
  */
559
559
  formGroup;
560
560
  }
561
561
 
562
562
  /**
563
- * Arguments for the `save` event.
563
+ * Represents the arguments for the `save` event.
564
564
  */
565
565
  class SaveEvent extends EditEventBase {
566
566
  /**
567
- * The edited `formGroup` instance.
567
+ * Provides the edited `formGroup` instance.
568
568
  */
569
569
  formGroup;
570
570
  /**
571
- * The selected edit mode.
571
+ * Provides the selected edit mode.
572
572
  */
573
573
  mode;
574
574
  }
575
575
 
576
576
  /**
577
- * Arguments for the `edit` event of the editing directives.
577
+ * Represents the arguments for the `edit` event of the editing directives.
578
578
  */
579
579
  class EditEvent extends PreventableEvent {
580
580
  /**
581
- * The event data item for which the **Edit** dialog will be opened.
581
+ * Provides the event data item for which the **Edit** dialog will be opened.
582
582
  */
583
583
  dataItem;
584
584
  /**
585
- * The event for which the **Edit** dialog will be opened.
585
+ * Provides the event for which the **Edit** dialog will be opened.
586
586
  */
587
587
  event;
588
588
  /**
589
- * A reference to the Scheduler instance that triggered the event.
589
+ * Provides a reference to the Scheduler instance that triggered the event.
590
590
  */
591
591
  sender;
592
592
  /**
@@ -600,15 +600,15 @@ class EditEvent extends PreventableEvent {
600
600
  }
601
601
 
602
602
  /**
603
- * Arguments for the `add` event of the editing directives.
603
+ * Represents the arguments for the `add` event of the editing directives.
604
604
  */
605
605
  class AddEvent extends PreventableEvent {
606
606
  /**
607
- * The data for binding the **Add** dialog.
607
+ * Provides the data for binding the **Add** dialog.
608
608
  */
609
609
  dataItem;
610
610
  /**
611
- * A reference to the Scheduler instance that triggered the event.
611
+ * Provides a reference to the Scheduler instance that triggered the event.
612
612
  */
613
613
  sender;
614
614
  /**
@@ -622,16 +622,17 @@ class AddEvent extends PreventableEvent {
622
622
  }
623
623
 
624
624
  /**
625
- * Arguments for the `slotDragStart` event.
626
- * The event is preventable and if prevented, subsequent `slotDrag`, `slotDragEnd`, and `slotSelectionChange` will not be fired.
625
+ * Represents the arguments for the `slotDragStart` event.
626
+ *
627
+ * The event is preventable. If prevented, subsequent `slotDrag`, `slotDragEnd`, and `slotSelectionChange` events will not be fired.
627
628
  */
628
629
  class SlotDragStartEvent extends PreventableEvent {
629
630
  /**
630
- * The start date of the slot selection.
631
+ * Provides the start date of the slot selection.
631
632
  */
632
633
  start;
633
634
  /**
634
- * The end date of the slot selection.
635
+ * Provides the end date of the slot selection.
635
636
  */
636
637
  end;
637
638
  /**
@@ -639,15 +640,15 @@ class SlotDragStartEvent extends PreventableEvent {
639
640
  */
640
641
  isAllDay;
641
642
  /**
642
- * The resources for the slot, if grouping by resource; otherwise all Scheduler resources.
643
+ * Provides the resources for the slot, if grouping by resource; otherwise all Scheduler resources.
643
644
  */
644
645
  resources;
645
646
  /**
646
- * The original DOM event.
647
+ * Provides the original DOM event.
647
648
  */
648
649
  originalEvent;
649
650
  /**
650
- * A reference to the Scheduler instance that triggered the event.
651
+ * Provides a reference to the Scheduler instance that triggered the event.
651
652
  */
652
653
  sender;
653
654
  /**
@@ -661,31 +662,31 @@ class SlotDragStartEvent extends PreventableEvent {
661
662
  }
662
663
 
663
664
  /**
664
- * Arguments for the `slotDrag` event.
665
+ * Represents the arguments for the `slotDrag` event.
665
666
  */
666
667
  class SlotDragEvent {
667
668
  /**
668
- * The start date of the slot selection.
669
+ * Provides the start date of the slot selection.
669
670
  */
670
671
  start;
671
672
  /**
672
- * The end date of the slot selection.
673
+ * Provides the end date of the slot selection.
673
674
  */
674
675
  end;
675
676
  /**
676
- * Indicates if the slot selection consists of all-day slots, or of time slots.
677
+ * Indicates if the slot selection consists of all-day slots, or of time slots.
677
678
  */
678
679
  isAllDay;
679
680
  /**
680
- * The resources for the slot, if grouping by resource; otherwise all Scheduler resources.
681
+ * Provides the resources for the slot, if grouping by resource; otherwise all Scheduler resources.
681
682
  */
682
683
  resources;
683
684
  /**
684
- * The original DOM event.
685
+ * Provides the original DOM event.
685
686
  */
686
687
  originalEvent;
687
688
  /**
688
- * A reference to the Scheduler instance that triggered the event.
689
+ * Provides a reference to the Scheduler instance that triggered the event.
689
690
  */
690
691
  sender;
691
692
  /**
@@ -698,29 +699,37 @@ class SlotDragEvent {
698
699
  }
699
700
 
700
701
  /**
701
- * Arguments for the `slotDragEnd` event.
702
+ * Represents the arguments for the `slotDragEnd` event.
702
703
  */
703
704
  class SlotDragEndEvent extends SlotDragEvent {
704
705
  }
705
706
 
706
707
  /**
707
- * Represents the toolbar template of the Scheduler. To define a toolbar
708
- * template, nest an `<ng-template kendoSchedulerToolbarTemplate>` tag
709
- * inside `<kendo-scheduler>`. For more information and examples, refer to the article on
710
- * [customizing the toolbar]({% slug toolbar_scheduler %}) of the Scheduler.
708
+ * Represents the toolbar template of the Scheduler. To define a toolbar template, nest an `<ng-template kendoSchedulerToolbarTemplate>` tag inside the `<kendo-scheduler>`. For more information and examples, see [customizing the toolbar](slug:toolbar_scheduler) article.
711
709
  *
712
- * The template context receives the following template variables:
710
+ * The template context provides the following variables:
713
711
  * * `selectedDate`&mdash;The currently selected date.
714
- * * `dateRange`&mdash;The currently selected [`DateRange`]({% slug api_scheduler_daterange %}).
715
- * * `views`&mdash;A [`SchedulerView`]({% slug api_scheduler_schedulerview %}) array with the available views.
716
- * * `selectedView`&mdash;The currently selected [`SchedulerView`]({% slug api_scheduler_schedulerview %}).
712
+ * * `dateRange`&mdash;The currently selected [`DateRange`](slug:api_scheduler_daterange).
713
+ * * `views`&mdash;An array of [`SchedulerView`](slug:api_scheduler_schedulerview) instances with the available views.
714
+ * * `selectedView`&mdash;The currently selected [`SchedulerView`](slug:api_scheduler_schedulerview).
717
715
  *
718
716
  * You can declare either of the following built-in navigation components in the toolbar template:
719
717
  * * `kendoSchedulerToolbarNavigation`&mdash;Renders navigation buttons, a calendar, and a date-range label.
720
718
  * * `kendoSchedulerToolbarViewSelector`&mdash;Renders the buttons for selecting the view.
721
719
  *
722
- * To emit navigation events, the components inside the toolbar can inject
723
- * the [`ToolbarService`]({% slug api_scheduler_toolbarservice %}).
720
+ * To emit navigation events, components inside the toolbar can inject the [`ToolbarService`](slug:api_scheduler_toolbarservice).
721
+ *
722
+ * @example
723
+ * ```html
724
+ * <kendo-scheduler>
725
+ * <ng-template kendoSchedulerToolbarTemplate let-selectedDate="selectedDate">
726
+ * <div class="custom-toolbar">
727
+ * <span>Selected Date: {{ selectedDate | date: 'longDate' }}</span>
728
+ * <button kendoButton (click)="navigateToToday()">Today</button>
729
+ * </div>
730
+ * </ng-template>
731
+ * </kendo-scheduler>
732
+ * ```
724
733
  */
725
734
  class ToolbarTemplateDirective {
726
735
  templateRef;
@@ -741,9 +750,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
741
750
  }] }]; } });
742
751
 
743
752
  /**
744
- * A service for communication with the toolbar controls
745
- * which is used by the toolbar components for publishing navigation actions
746
- * ([see example]({% slug toolbar_scheduler %}#toc-using-the-toolbar-service)).
753
+ * Represents a service for communication with toolbar controls. Toolbar components use this service to publish navigation actions
754
+ * ([see example](slug:toolbar_scheduler#toc-using-the-toolbar-service)).
747
755
  */
748
756
  class ToolbarService {
749
757
  /**
@@ -766,7 +774,7 @@ class ToolbarService {
766
774
  /**
767
775
  * Emits the specified navigation action.
768
776
  *
769
- * @param action - The navigation action that will be executed.
777
+ * @param action The navigation action to execute.
770
778
  */
771
779
  navigate(action) {
772
780
  this.actionSource.next(action);
@@ -782,14 +790,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
782
790
  }], ctorParameters: function () { return []; } });
783
791
 
784
792
  /**
785
- * An abstract class which contains meta information about a Scheduler view.
793
+ * Contains meta information about a Scheduler view.
786
794
  */
787
795
  class SchedulerView {
788
796
  }
789
797
 
790
798
  /**
791
- * The selected edit mode during the update or removal of events.
792
- * For non-recurring events, set to `Event`.
799
+ * Represents the selected edit mode when you update or remove events.
800
+ * For non-recurring events, use `Event`.
793
801
  */
794
802
  var EditMode;
795
803
  (function (EditMode) {
@@ -808,16 +816,16 @@ var EditMode;
808
816
  })(EditMode || (EditMode = {}));
809
817
 
810
818
  /**
811
- * The selected CRUD operation when the user edits or removes recurring events.
819
+ * Represents the selected CRUD operation when the user edits or removes recurring events.
812
820
  */
813
821
  var CrudOperation;
814
822
  (function (CrudOperation) {
815
823
  /**
816
- * The user edits the selected recurring event.
824
+ * Indicates that the selected recurring event is edited.
817
825
  */
818
826
  CrudOperation[CrudOperation["Edit"] = 0] = "Edit";
819
827
  /**
820
- * The user removes the selected recurring event.
828
+ * Indicates that the selected recurring event is removed.
821
829
  */
822
830
  CrudOperation[CrudOperation["Remove"] = 1] = "Remove";
823
831
  })(CrudOperation || (CrudOperation = {}));
@@ -855,12 +863,22 @@ var slotDragEventName;
855
863
  })(slotDragEventName || (slotDragEventName = {}));
856
864
 
857
865
  /**
858
- * Represents the template which renders the date header in the **Agenda** view.
859
- * To define the date template, nest an `<ng-template>` tag with the `kendoSchedulerAgendaDateTemplate`
860
- * directive inside the `<kendo-scheduler-agenda-view>` or `<kendo-scheduler>` components ([see example](slug:templates_scheduler#toc-agenda-dates)).
866
+ * Use this directive to customize the date header in the **Agenda** view of the Scheduler.
867
+ *
868
+ * To define a date template, nest an `<ng-template>` tag with the `kendoSchedulerAgendaDateTemplate` directive inside the
869
+ * `<kendo-scheduler-agenda-view>` or `<kendo-scheduler>` component ([see example](slug:templates_scheduler#toc-agenda-dates).
861
870
  *
862
871
  * The available fields in the template context are:
863
872
  * - `date`&mdash;The header date.
873
+ *
874
+ * @example
875
+ * ```html
876
+ * <kendo-scheduler-agenda-view>
877
+ * <ng-template kendoSchedulerAgendaDateTemplate let-date="date">
878
+ * <!-- custom date header -->
879
+ * </ng-template>
880
+ * </kendo-scheduler-agenda-view>
881
+ * ```
864
882
  */
865
883
  class AgendaDateTemplateDirective {
866
884
  templateRef;
@@ -881,9 +899,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
881
899
  }] }]; } });
882
900
 
883
901
  /**
884
- * Represents the template which renders the time header in the **Agenda** view.
885
- * To define the time template, nest an `<ng-template>` tag with the `kendoSchedulerAgendaTimeTemplate`
886
- * directive inside the `<kendo-scheduler>` or in the `<kendo-scheduler-agenda-view>` component ([see example](slug:templates_scheduler#toc-agenda-times)).
902
+ * Use this directive to customize the time header in the **Agenda** view of the Scheduler.
903
+ *
904
+ * To define a time template, nest an `<ng-template>` tag with the `kendoSchedulerAgendaTimeTemplate` directive inside the
905
+ * `<kendo-scheduler>` or `<kendo-scheduler-agenda-view>` component ([see example](slug:templates_scheduler#toc-agenda-times)).
887
906
  *
888
907
  * The available fields in the template context are:
889
908
  * - `start`&mdash;The start date of the event.
@@ -892,6 +911,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
892
911
  * - `description`&mdash;The description of the event.
893
912
  * - `isAllDay`&mdash;A Boolean value which indicates if the event is all-day.
894
913
  * - `resources`&mdash;The resources of the event.
914
+ *
915
+ * @example
916
+ * ```html
917
+ * <kendo-scheduler-agenda-view>
918
+ * <ng-template kendoSchedulerAgendaTimeTemplate let-start="start" let-end="end" let-title="title" let-description="description" let-isAllDay="isAllDay" let-resources="resources">
919
+ * <!-- custom time header -->
920
+ * </ng-template>
921
+ * </kendo-scheduler-agenda-view>
922
+ * ```
895
923
  */
896
924
  class AgendaTimeTemplateDirective {
897
925
  templateRef;
@@ -912,13 +940,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
912
940
  }] }]; } });
913
941
 
914
942
  /**
915
- * Represents the template for and assists the content customization of all-day events.
916
- * To define the all-day event template, nest an `<ng-template>` tag with the `kendoSchedulerAllDayEventTemplate`
917
- * directive inside the `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, or `<kendo-scheduler-week-view>` component ([see example](slug:templates_scheduler#toc-all-day-events)).
943
+ * Use this directive to customize the content of all-day events in the Scheduler.
944
+ *
945
+ * To define an all-day event template, nest an `<ng-template>` tag with the `kendoSchedulerAllDayEventTemplate` directive inside the
946
+ * `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, or `<kendo-scheduler-week-view>` component ([see example](slug:templates_scheduler#toc-all-day-events)).
918
947
  *
919
948
  * The available fields in the template context are:
920
949
  * - `event`&mdash;The event that is associated with the item.
921
950
  * - `resources`&mdash;The resources of the event.
951
+ *
952
+ * @example
953
+ * ```html
954
+ * <kendo-scheduler-day-view>
955
+ * <ng-template kendoSchedulerAllDayEventTemplate let-event="event" let-resources="resources">
956
+ * <!-- custom all-day event -->
957
+ * </ng-template>
958
+ * </kendo-scheduler-day-view>
959
+ * ```
922
960
  */
923
961
  class AllDayEventTemplateDirective {
924
962
  templateRef;
@@ -939,13 +977,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
939
977
  }] }]; } });
940
978
 
941
979
  /**
942
- * Represents the template for and assists the content customization of all-day slots.
943
- * To define the all-day slot template, nest an `<ng-template>` tag with the `kendoSchedulerAllDaySlotTemplate`
944
- * directive inside the `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, or `<kendo-scheduler-week-view>` component ([see example](slug:templates_scheduler#toc-all-day-slots)).
980
+ * Use this directive to customize the content of all-day slots in the Scheduler.
981
+ *
982
+ * To define an all-dat slot template, nest an `<ng-template>` tag with the `kendoSchedulerAllDaySlotTemplate` directive inside the
983
+ * `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, or `<kendo-scheduler-week-view>` components ([see example](slug:templates_scheduler#toc-all-day-slots)).
945
984
  *
946
985
  * The available fields in the template context are:
947
986
  * - `date`&mdash;The date of the slot.
948
987
  * - `resources`&mdash;The resources of the slot.
988
+ *
989
+ * @example
990
+ * ```html
991
+ * <kendo-scheduler-week-view>
992
+ * <ng-template kendoSchedulerAllDaySlotTemplate let-date="date" let-resources="resources">
993
+ * <!-- custom all-day slot -->
994
+ * </ng-template>
995
+ * </kendo-scheduler-week-view>
996
+ * ```
949
997
  */
950
998
  class AllDaySlotTemplateDirective {
951
999
  templateRef;
@@ -966,13 +1014,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
966
1014
  }] }]; } });
967
1015
 
968
1016
  /**
969
- * Represents the template which renders the date header in the **Day**, **Week**, and **Timeline** views.
970
- * To define the day template, nest an `<ng-template>` tag with the `kendoSchedulerDateHeaderTemplate`
971
- * directive inside the `<kendo-scheduler>`, or in the `<kendo-scheduler-day-view>`, `<kendo-scheduler-week-view>`,
972
- * `<kendo-scheduler-timeline-view>`, `<kendo-scheduler-timeline-week-view>`, and `<kendo-scheduler-timeline-month-view>` components ([see example](slug:templates_scheduler#toc-date-headers)).
1017
+ * Use this directive to customize the date header in **Day**, **Week**, and **Timeline** views of the Scheduler.
1018
+ *
1019
+ * To define a date header template, nest an `<ng-template>` tag with the `kendoSchedulerDateHeaderTemplate` directive inside the
1020
+ * `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, `<kendo-scheduler-week-view>`,
1021
+ * `<kendo-scheduler-timeline-view>`, `<kendo-scheduler-timeline-week-view>`, or `<kendo-scheduler-timeline-month-view>` component ([see example](slug:templates_scheduler#toc-date-headers)).
973
1022
  *
974
1023
  * The available fields in the template context are:
975
1024
  * - `date`&mdash;The header date.
1025
+ *
1026
+ * @example
1027
+ * ```html
1028
+ * <kendo-scheduler-week-view>
1029
+ * <ng-template kendoSchedulerDateHeaderTemplate let-date="date">
1030
+ * <!-- custom date header -->
1031
+ * </ng-template>
1032
+ * </kendo-scheduler-week-view>
1033
+ * ```
976
1034
  */
977
1035
  class DateHeaderTemplateDirective {
978
1036
  templateRef;
@@ -993,13 +1051,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
993
1051
  }] }]; } });
994
1052
 
995
1053
  /**
996
- * Represents the template for and assists the content customization of the Scheduler events.
997
- * To define the event template, nest an `<ng-template>` tag with the `kendoSchedulerEventTemplate`
998
- * directive inside the `<kendo-scheduler>`, or in the view components ([see example](slug:templates_scheduler#toc-event-rendering)).
1054
+ * Use this directive to customize the rendering of Scheduler events.
1055
+ *
1056
+ * To define an event template, nest an `<ng-template>` tag with the `kendoSchedulerEventTemplate` directive inside the
1057
+ * `<kendo-scheduler>` or any view component ([see example](slug:templates_scheduler#toc-event-rendering)).
999
1058
  *
1000
1059
  * The available fields in the template context are:
1001
1060
  * - `event`&mdash;The event that is associated with the item.
1002
1061
  * - `resources`&mdash;The resources of the event.
1062
+ *
1063
+ * @example
1064
+ * ```html
1065
+ * <kendo-scheduler>
1066
+ * <ng-template kendoSchedulerEventTemplate let-event="event" let-resources="resources">
1067
+ * <!-- custom event rendering -->
1068
+ * </ng-template>
1069
+ * </kendo-scheduler>
1070
+ * ```
1003
1071
  */
1004
1072
  class EventTemplateDirective {
1005
1073
  templateRef;
@@ -1020,13 +1088,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
1020
1088
  }] }]; } });
1021
1089
 
1022
1090
  /**
1023
- * Represents the template which renders the resource group header in the **Day**, **Week**, and **Timeline** views.
1024
- * To define the template, nest an `<ng-template>` tag with the `kendoSchedulerGroupHeaderTemplate`
1025
- * directive inside the `<kendo-scheduler>`, or in the `<kendo-scheduler-day-view>`, `<kendo-scheduler-week-view>`,
1026
- * `<kendo-scheduler-timeline-view>`, `<kendo-scheduler-timeline-week-view>`, and `<kendo-scheduler-timeline-month-view>` components ([see example](slug:templates_scheduler#toc-group-headers)).
1091
+ * Use this directive to customize the resource group header in **Day**, **Week**, and **Timeline** views of the Scheduler.
1092
+ *
1093
+ * To defina a group header template, nest an `<ng-template>` tag with the `kendoSchedulerGroupHeaderTemplate` directive inside the
1094
+ * `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, `<kendo-scheduler-week-view>`,
1095
+ * `<kendo-scheduler-timeline-view>`, `<kendo-scheduler-timeline-week-view>`, or `<kendo-scheduler-timeline-month-view>` component ([see example](slug:templates_scheduler#toc-group-headers)).
1027
1096
  *
1028
1097
  * The available fields in the template context are:
1029
1098
  * - `resource`&mdash;The resource item.
1099
+ *
1100
+ * @example
1101
+ * ```html
1102
+ * <kendo-scheduler-timeline-view>
1103
+ * <ng-template kendoSchedulerGroupHeaderTemplate let-resource="resource">
1104
+ * <!-- custom group header -->
1105
+ * </ng-template>
1106
+ * </kendo-scheduler-timeline-view>
1107
+ * ```
1030
1108
  */
1031
1109
  class GroupHeaderTemplateDirective {
1032
1110
  templateRef;
@@ -1047,12 +1125,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
1047
1125
  }] }]; } });
1048
1126
 
1049
1127
  /**
1050
- * Represents the template for the major-time headers in the **Day** and **Week** views.
1051
- * To define the major-time header template, nest an `<ng-template>` tag with the `kendoSchedulerMajorTimeHeaderTemplate`
1052
- * directive inside the `<kendo-scheduler>`, or in the `<kendo-scheduler-day-view>` and `<kendo-scheduler-week-view>` components ([see example](slug:templates_scheduler#toc-major-time-headers)).
1128
+ * Use this directive to customize the major-time headers in **Day** and **Week** views of the Scheduler.
1129
+ *
1130
+ * To define a major-time header template, nest an `<ng-template>` tag with the `kendoSchedulerMajorTimeHeaderTemplate` directive inside the
1131
+ * `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, or `<kendo-scheduler-week-view>` component ([see example](slug:templates_scheduler#toc-major-time-headers)).
1053
1132
  *
1054
1133
  * The available fields in the template context are:
1055
1134
  * - `date`&mdash;The date of the header.
1135
+ *
1136
+ * @example
1137
+ * ```html
1138
+ * <kendo-scheduler-day-view>
1139
+ * <ng-template kendoSchedulerMajorTimeHeaderTemplate let-date="date">
1140
+ * <!-- custom major time header -->
1141
+ * </ng-template>
1142
+ * </kendo-scheduler-day-view>
1143
+ * ```
1056
1144
  */
1057
1145
  class MajorTimeHeaderTemplateDirective {
1058
1146
  templateRef;
@@ -1073,12 +1161,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
1073
1161
  }] }]; } });
1074
1162
 
1075
1163
  /**
1076
- * Represents the template for the minor-time headers in the **Day** and **Week** views.
1077
- * To define the minor-time header template, nest an `<ng-template>` tag with the `kendoSchedulerMinorTimeHeaderTemplate`
1078
- * directive inside the `<kendo-scheduler>`, or in the `<kendo-scheduler-day-view>` and `<kendo-scheduler-week-view>` components ([see example](slug:templates_scheduler#toc-minor-time-headers)).
1164
+ * Use this directive to customize the minor-time headers in the **Day** and **Week** views of the Scheduler.
1165
+ *
1166
+ * To define a minor-time header template, nest an `<ng-template>` tag with the `kendoSchedulerMinorTimeHeaderTemplate` directive inside the
1167
+ * `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, or `<kendo-scheduler-week-view>` component ([see example](slug:templates_scheduler#toc-minor-time-headers)).
1079
1168
  *
1080
1169
  * The available fields in the template context are:
1081
1170
  * - `date`&mdash;The date of the header.
1171
+ *
1172
+ * @example
1173
+ * ```html
1174
+ * <kendo-scheduler-week-view>
1175
+ * <ng-template kendoSchedulerMinorTimeHeaderTemplate let-date="date">
1176
+ * <!-- custom minor time header -->
1177
+ * </ng-template>
1178
+ * </kendo-scheduler-week-view>
1179
+ * ```
1082
1180
  */
1083
1181
  class MinorTimeHeaderTemplateDirective {
1084
1182
  templateRef;
@@ -1099,13 +1197,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
1099
1197
  }] }]; } });
1100
1198
 
1101
1199
  /**
1102
- * Represents the template for rendering the day slots in the **Month** view.
1103
- * To define the day template, nest an `<ng-template>` tag with the `kendoSchedulerMonthDaySlotTemplate`
1104
- * directive inside the `<kendo-scheduler>`, or in the `<kendo-scheduler-month-view>` component ([see example](slug:templates_scheduler#toc-month-slots)).
1200
+ * Use this directive to customize the day slots in the **Month** view of the Scheduler.
1201
+ *
1202
+ * To define a day slot template, nest an `<ng-template>` tag with the `kendoSchedulerMonthDaySlotTemplate` directive inside the
1203
+ * `<kendo-scheduler>` or `<kendo-scheduler-month-view>` component ([see example](slug:templates_scheduler#toc-month-slots)).
1105
1204
  *
1106
1205
  * The available fields in the template context are:
1107
1206
  * - `date`&mdash;The date of the slot.
1108
1207
  * - `resources`&mdash;The resources of the slot.
1208
+ *
1209
+ * @example
1210
+ * ```html
1211
+ * <kendo-scheduler-month-view>
1212
+ * <ng-template kendoSchedulerMonthDaySlotTemplate let-date="date" let-resources="resources">
1213
+ * <!-- custom month day slot -->
1214
+ * </ng-template>
1215
+ * </kendo-scheduler-month-view>
1216
+ * ```
1109
1217
  */
1110
1218
  class MonthDaySlotTemplateDirective {
1111
1219
  templateRef;
@@ -1126,14 +1234,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
1126
1234
  }] }]; } });
1127
1235
 
1128
1236
  /**
1129
- * Represents the template for rendering the day slots in the **Month** view.
1130
- * To define the day template, nest an `<ng-template>` tag with the `kendoSchedulerMultiWeekDaySlotTemplate`
1131
- * directive inside the `<kendo-scheduler>`, or in the `<kendo-scheduler-month-view>` component ([see example](slug:templates_scheduler#toc-multi-week-slots)).
1237
+ * Use this directive to customize the day slots in the **Multi-Week** view of the Scheduler.
1238
+ *
1239
+ * To defina a day slot template, nest an `<ng-template>` tag with the `kendoSchedulerMultiWeekDaySlotTemplate` directive inside the
1240
+ * `<kendo-scheduler>` or `<kendo-scheduler-multi-week-view>` component ([see example](slug:templates_scheduler#toc-multi-week-slots)).
1132
1241
  *
1133
1242
  * The available fields in the template context are:
1134
1243
  * - `date`&mdash;The date of the slot.
1135
1244
  * - `resources`&mdash;The resources of the slot.
1136
1245
  *
1246
+ * @example
1247
+ * ```html
1248
+ * <kendo-scheduler-multi-week-view>
1249
+ * <ng-template kendoSchedulerMultiWeekDaySlotTemplate let-date="date" let-resources="resources">
1250
+ * <!-- custom multi-week day slot -->
1251
+ * </ng-template>
1252
+ * <kendo-scheduler-multi-week-view>
1253
+ * ```
1137
1254
  */
1138
1255
  class MultiWeekDaySlotTemplateDirective {
1139
1256
  templateRef;
@@ -1154,14 +1271,24 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
1154
1271
  }] }]; } });
1155
1272
 
1156
1273
  /**
1157
- * Represents the template for the time-slot renderer in the **Day**, **Week**, and **Timeline** views.
1158
- * To define the time-slot template, nest an `<ng-template>` tag with the `kendoSchedulerTimeSlotTemplate`
1159
- * directive inside the `<kendo-scheduler>`, or in the `<kendo-scheduler-day-view>`, `<kendo-scheduler-week-view>`,
1160
- * `<kendo-scheduler-timeline-view>`, `<kendo-scheduler-timeline-week-view>`, and `<kendo-scheduler-timeline-month-view>` components ([see example](slug:templates_scheduler#toc-time-slots)).
1274
+ * Represents the template for the time-slot renderer in the ***Day**, ***Week**, and ***Timeline** views.
1275
+ *
1276
+ * To define a time-slot template, nest an `<ng-template>` tag with the `kendoSchedulerTimeSlotTemplate`
1277
+ * directive inside the `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, `<kendo-scheduler-week-view>`,
1278
+ * `<kendo-scheduler-timeline-view>`, `<kendo-scheduler-timeline-week-view>`, or `<kendo-scheduler-timeline-month-view>` component ([see example](slug:templates_scheduler#toc-time-slots)).
1161
1279
  *
1162
1280
  * The available fields in the template context are:
1163
1281
  * - `date`&mdash;The date of the slot.
1164
1282
  * - `resources`&mdash;The resources of the slot.
1283
+ *
1284
+ * @example
1285
+ * ```html
1286
+ * <kendo-scheduler-week-view>
1287
+ * <ng-template kendoSchedulerTimeSlotTemplate let-date="date" let-resources="resources">
1288
+ * <!-- custom time slot -->
1289
+ * </ng-template>
1290
+ * </kendo-scheduler-week-view>
1291
+ * ```
1165
1292
  */
1166
1293
  class TimeSlotTemplateDirective {
1167
1294
  templateRef;
@@ -1187,27 +1314,27 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
1187
1314
  */
1188
1315
  class ViewContextService {
1189
1316
  /**
1190
- * A stream of navigation actions that will be handled by the view.
1317
+ * Represents a stream that publishes navigation actions to the view.
1191
1318
  */
1192
1319
  action;
1193
1320
  /**
1194
- * A stream that executes methods from the view.
1321
+ * Represents a stream that executes methods from the view.
1195
1322
  */
1196
1323
  execute;
1197
1324
  /**
1198
- * A stream of items (events) that will be displayed in the view.
1325
+ * Represents a stream of items (events) to be displayed in the view.
1199
1326
  */
1200
1327
  items;
1201
1328
  /**
1202
- * A stream with the selected date that will be displayed by the view.
1329
+ * Represents a stream with the selected date to be displayed in the view.
1203
1330
  */
1204
1331
  selectedDate;
1205
1332
  /**
1206
- * Fires when the Scheduler element is resized.
1333
+ * Emits when the Scheduler element is resized.
1207
1334
  */
1208
1335
  resize;
1209
1336
  /**
1210
- * Fires when the Scheduler options are changed.
1337
+ * Emits when the Scheduler options change.
1211
1338
  */
1212
1339
  optionsChange;
1213
1340
  actionSource = new Subject();
@@ -1297,39 +1424,39 @@ const emptyDateRange = () => ({
1297
1424
  */
1298
1425
  class ViewStateService {
1299
1426
  /**
1300
- * A stream for publishing the visible date range of the current view to the Scheduler.
1427
+ * Represents a stream that publishes the visible date range for the current view to the Scheduler.
1301
1428
  */
1302
1429
  dateRange;
1303
1430
  /**
1304
- * A stream for publishing the changes to the selected date that are initiated from the view.
1431
+ * Represents a stream that publishes changes to the selected date, which initiate from the view.
1305
1432
  */
1306
1433
  nextDate;
1307
1434
  /**
1308
- * A stream fro navigating from the current to another view.
1435
+ * Represents a stream for navigating from the current view to another view.
1309
1436
  */
1310
1437
  navigate;
1311
1438
  /**
1312
- * A stream for navigating from the current to another view.
1439
+ * Represents a stream that publishes events for navigation between views.
1313
1440
  */
1314
1441
  viewEvent;
1315
1442
  /**
1316
- * A stream for indicating that the view layout finished.
1443
+ * Represents a stream that indicates when the view layout finishes.
1317
1444
  */
1318
1445
  layoutEnd;
1319
1446
  /**
1320
- * A stream for indicating that the view options has changed.
1447
+ * Represents a stream that indicates when the view options change.
1321
1448
  */
1322
1449
  optionsChange;
1323
1450
  /**
1324
- * A stream indicating that the user has started making a new slot selection.
1451
+ * Represents a stream that indicates when the user starts a new slot selection.
1325
1452
  */
1326
1453
  slotSelectionStart;
1327
1454
  /**
1328
- * A stream indicating that the user has dragged over a different slot while making a selection.
1455
+ * Represents a stream that indicates when the user drags over a different slot during selection.
1329
1456
  */
1330
1457
  slotSelectionDrag;
1331
1458
  /**
1332
- * A stream indicating that the user has finished making a slot selection.
1459
+ * Represents a stream that indicates when the user finishes making a slot selection.
1333
1460
  */
1334
1461
  slotSelectionEnd;
1335
1462
  /**
@@ -1799,15 +1926,28 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
1799
1926
  }], ctorParameters: function () { return [{ type: i0.NgZone }]; } });
1800
1927
 
1801
1928
  /**
1802
- * Represents the template for the edit dialog of the Scheduler.
1929
+ * Represents the template directive for customizing the Scheduler edit dialog.
1803
1930
  * To define the template, nest an `<ng-template>` tag
1804
1931
  * with the `kendoSchedulerEditDialogTemplate` directive inside the `<kendo-scheduler>` tag ([see example](slug:custom_reactive_editing_scheduler)).
1805
1932
  *
1806
- * The template context is set to the current event and then the following additional fields are passed:
1933
+ * The template context is set to the current event and the following additional fields are passed:
1807
1934
  * - `event`&mdash;The currently edited event. Represents the default context that will be assigned to any template variable which utilizes the `let-x` syntax&mdash;for example, `let-event`.
1808
1935
  * - `formGroup`&mdash;The current [`FormGroup`](https://angular.io/docs/ts/latest/api/forms/index/FormGroup-class.html).
1809
1936
  * - `editMode`&mdash;The current edit mode.
1810
1937
  * - `isNew`&mdash;The state of the current event.
1938
+ *
1939
+ * @example
1940
+ * ```html
1941
+ * <kendo-scheduler>
1942
+ * <ng-template kendoSchedulerEditDialogTemplate let-formGroup="formGroup" let-isNew="isNew"
1943
+ * autoFocusedElement=".title-input" let-editMode="editMode" let-event>
1944
+ * <div>
1945
+ * <label>Title:</label>
1946
+ * <kendo-textbox placeholder="Title" [formControl]="formGroup.get('title') />
1947
+ * </div>
1948
+ * </ng-template>
1949
+ * </kendo-scheduler>
1950
+ * ```
1811
1951
  */
1812
1952
  class EditDialogTemplateDirective {
1813
1953
  templateRef;
@@ -2209,7 +2349,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
2209
2349
  }] });
2210
2350
 
2211
2351
  /**
2212
- * The arguments for the `pdfExport` event.
2352
+ * Provides the arguments for the `pdfExport` event.
2213
2353
  */
2214
2354
  class PDFExportEvent extends PreventableEvent {
2215
2355
  }
@@ -4863,14 +5003,33 @@ const RECURRENCE_VALUE_ACCESSOR = {
4863
5003
  useExisting: forwardRef(() => RecurrenceEditorComponent)
4864
5004
  };
4865
5005
  /**
4866
- * Represents the Kendo UI Recurrence Editor component for Angular. [This example](slug:custom_reactive_editing_scheduler) demonstrates the Recurrence Editor, among other components.
5006
+ * Represents the Kendo UI Recurrence Editor component for Angular. Use this component to let users set recurrence rules for Scheduler events.
5007
+ *
5008
+ * [This example](slug:custom_reactive_editing_scheduler) demonstrates the Recurrence Editor, among other components.
5009
+ *
5010
+ * @example
5011
+ * ```html
5012
+ * <kendo-scheduler
5013
+ * [kendoSchedulerBinding]="events"
5014
+ * [kendoSchedulerReactiveEditing]="createFormGroup"
5015
+ * >
5016
+ * <ng-template kendoSchedulerEditDialogTemplate let-formGroup="formGroup" let-event>
5017
+ * <kendo-formfield>
5018
+ * <kendo-recurrence-editor
5019
+ * [start]="event.value.start"
5020
+ * [formControl]="formGroup.get('recurrenceRule')"
5021
+ * ></kendo-recurrence-editor>
5022
+ * </kendo-formfield>
5023
+ * </ng-template>
5024
+ * </kendo-scheduler>
5025
+ * ```
4867
5026
  */
4868
5027
  class RecurrenceEditorComponent {
4869
5028
  recurrenceService;
4870
5029
  intl;
4871
5030
  cssClass = true;
4872
5031
  /**
4873
- * Specifies the start date of the event.
5032
+ * Sets the start date for the event.
4874
5033
  */
4875
5034
  set start(value) {
4876
5035
  this._start = value;
@@ -4879,33 +5038,33 @@ class RecurrenceEditorComponent {
4879
5038
  return isPresent(this._start) ? this._start : getDate(new Date());
4880
5039
  }
4881
5040
  /**
4882
- * Specifies the id of the timezone that will be used.
5041
+ * Sets the id of the timezone to use.
5042
+ *
4883
5043
  * @default 'Etc/UTC'
4884
5044
  */
4885
5045
  timezone = 'Etc/UTC';
4886
5046
  /**
4887
- * The first day of the week. Defaults to the locale settings.
5047
+ * Sets the first day of the week. Uses the locale settings by default.
4888
5048
  */
4889
5049
  weekStart;
4890
5050
  /**
4891
- * Specifies the options of the `Repeat Every` NumericTextBox component within the recurrence `interval` editor.
5051
+ * Sets the options for the **Repeat Every** NumericTextBox in the recurrence `interval` editor.
4892
5052
  */
4893
5053
  repeatEveryOptions;
4894
5054
  /**
4895
- * Specifies the options of the `End After` NumericTextBox component within the recurrence `count` rule editor.
5055
+ * Sets the options for the **End After** NumericTextBox in the recurrence `count` rule editor.
4896
5056
  */
4897
5057
  endAfterOptions;
4898
5058
  /**
4899
- * Specifies the options of the `Repeat On` NumericTextBox component for choosing the day
4900
- * an event will occur on within the monthly and yearly sections of the recurrence editor.
5059
+ * Sets the options for the **Repeat On** NumericTextBox for choosing the day an event occurs in the monthly and yearly sections.
4901
5060
  */
4902
5061
  repeatOnOptions;
4903
5062
  /**
4904
- * Specifies the options of the `End On` DatePicker component within the recurrence `until` rule editor.
5063
+ * Sets the options for the **End On** DatePicker in the recurrence `until` rule editor.
4905
5064
  */
4906
5065
  endOnOptions;
4907
5066
  /**
4908
- * Fires when the value of the component has changed.
5067
+ * Fires when the value of the component changes.
4909
5068
  */
4910
5069
  valueChange = new EventEmitter();
4911
5070
  _start;
@@ -5311,15 +5470,25 @@ const TIME_ZONE_VALUE_ACCESSOR = {
5311
5470
  };
5312
5471
  /**
5313
5472
  * Represents the Kendo UI TimeZone Editor component for Angular.
5314
- * `TimeZoneEditorComponent` displays the currently loaded timezones.
5315
- * Used for editing the `start` and `end` timezones of the `SchedulerEvent` objects.
5473
+ *
5474
+ * Displays a ComboBox for selecting time zone names, used for editing the `start` and `end` time zones of Scheduler events.
5475
+ *
5476
+ * @example
5477
+ * ```html
5478
+ * <kendo-scheduler>
5479
+ * <ng-template kendoSchedulerEditDialogTemplate>
5480
+ * <div> Select Time Zone:
5481
+ * <kendo-timezone-editor></kendo-timezone-editor>
5482
+ * </div>
5483
+ * </ng-template>
5484
+ * </kendo-scheduler>
5316
5485
  */
5317
5486
  class TimeZoneEditorComponent {
5318
5487
  injector;
5319
5488
  tzComboBox;
5320
5489
  tzComboBoxControl;
5321
5490
  /**
5322
- * Specifies the width of the ComboBox which contains the names of the timezones.
5491
+ * Specifies the width of the ComboBox that contains the names of the timezones.
5323
5492
  * @default 260
5324
5493
  */
5325
5494
  width = 260;
@@ -6278,23 +6447,29 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
6278
6447
  }] } });
6279
6448
 
6280
6449
  /**
6281
- * A toolbar component which contains the controls for switching the views
6282
- * ([see example]({% slug toolbar_scheduler %}#toc-including-the-built-in-components)).
6450
+ * A toolbar component that contains controls for switching views
6451
+ * ([see example](slug:toolbar_scheduler#toc-including-the-built-in-components)).
6452
+ *
6453
+ * To render the view-selection buttons, include this component in the [toolbar template](slug:api_scheduler_toolbartemplatedirective).
6283
6454
  *
6284
- * To render the view-selection buttons, include the component in the
6285
- * [toolbar template]({% slug api_scheduler_toolbartemplatedirective %}).
6455
+ * @example
6456
+ * ```html
6457
+ * <kendo-scheduler>
6458
+ * <ng-template kendoSchedulerToolbarTemplate>
6459
+ * <div kendoSchedulerToolbarViewSelector responsiveBreakpoint]="960"></div>
6460
+ * </ng-template>
6461
+ * </kendo-scheduler>
6462
+ * ```
6286
6463
  */
6287
6464
  class ToolbarViewSelectorComponent {
6288
6465
  service;
6289
6466
  localization;
6290
6467
  /**
6291
- * Specifies the current width of the Toolbar (in pixels) so the responsive calculations can be made.
6292
- * The ([schedulerResize]({% slug api_scheduler_schedulercomponent %}#toc-schedulerresize)) event can be used in order to obtain the Toolbar width.
6468
+ * Sets the current width of the Toolbar in pixels for responsive calculations. Use the [`schedulerResize`](slug:api_scheduler_schedulercomponent#toc-schedulerresize) event to get the Toolbar width.
6293
6469
  */
6294
6470
  toolbarWidth;
6295
6471
  /**
6296
- * Specifies the Toolbar width (in pixels) at which the responsive behavior should be enabled.
6297
- * The responsive behavior means that the ButtonGroup with the views will be replaced by a `select` element.
6472
+ * Sets the Toolbar width in pixels at which responsive behavior is enabled. When enabled, the ButtonGroup with the views is replaced by a `select` element.
6298
6473
  *
6299
6474
  * @default 1024
6300
6475
  */
@@ -6433,12 +6608,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
6433
6608
 
6434
6609
  const iconsMap = { caretAltLeftIcon, caretAltRightIcon, calendarIcon };
6435
6610
  /**
6436
- * A toolbar component which contains the controls for date navigation
6437
- * ([see example]({% slug toolbar_scheduler %}#toc-including-the-built-in-components)).
6611
+ * A toolbar component that contains controls for date navigation
6612
+ * ([see example](slug:toolbar_scheduler#toc-including-the-built-in-components)).
6438
6613
  *
6439
- * To render the **Previous**, **Today**, **Next**, and **Date picker**
6440
- * buttons, include the component in the
6441
- * [toolbar template]({% slug api_scheduler_toolbartemplatedirective %}).
6614
+ * To render the **Previous**, **Today**, **Next**, and **Date picker** buttons, include this component in the [toolbar template](slug:api_scheduler_toolbartemplatedirective).
6615
+ *
6616
+ * @example
6617
+ * ```html
6618
+ * <kendo-scheduler>
6619
+ * <ng-template kendoSchedulerToolbarTemplate>
6620
+ * <span class="custom-toolbar">
6621
+ * <div kendoSchedulerToolbarNavigation></div>
6622
+ * </span>
6623
+ * </ng-template>
6624
+ * </kendo-scheduler>
6625
+ * ```
6442
6626
  */
6443
6627
  class ToolbarNavigationComponent {
6444
6628
  popupService;
@@ -6467,13 +6651,13 @@ class ToolbarNavigationComponent {
6467
6651
  return this.localization.get('today');
6468
6652
  }
6469
6653
  /**
6470
- * Sets the [`activeView`]({% slug api_dateinputs_calendarcomponent %}#toc-activeview) of the Calendar in the navigation component.
6654
+ * Sets the [`activeView`](slug:api_dateinputs_calendarcomponent#toc-activeview) of the Calendar in the navigation component.
6471
6655
  *
6472
6656
  * @default month
6473
6657
  */
6474
6658
  activeView = 'month';
6475
6659
  /**
6476
- * Sets the [`bottomView`]({% slug api_dateinputs_calendarcomponent %}#toc-bottomview) of the Calendar in the navigation component.
6660
+ * Sets the [`bottomView`](slug:api_dateinputs_calendarcomponent#toc-bottomview) of the Calendar in the navigation component.
6477
6661
  *
6478
6662
  * @default month
6479
6663
  */
@@ -6951,346 +7135,346 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
6951
7135
  */
6952
7136
  class Messages extends ComponentMessages {
6953
7137
  /**
6954
- * The **All events** text that is displayed in the **Timeline** views when no vertical grouping is applied.
7138
+ * Sets the text for **All events** in **Timeline** views when no vertical grouping is applied.
6955
7139
  */
6956
7140
  allEvents;
6957
7141
  /**
6958
- * The **All day** text that is displayed in the *Day** and **Week** views.
7142
+ * Sets the text for **All day** in **Day** and **Week** views.
6959
7143
  */
6960
7144
  allDay;
6961
7145
  /**
6962
- * The date-header text that is displayed in the **Agenda** view.
7146
+ * Sets the date-header text in the **Agenda** view.
6963
7147
  */
6964
7148
  dateHeader;
6965
7149
  /**
6966
- * The time-header text that is displayed in the **Agenda** view.
7150
+ * Sets the time-header text in the **Agenda** view.
6967
7151
  */
6968
7152
  timeHeader;
6969
7153
  /**
6970
- * The event-header text that is displayed in the **Agenda** view.
7154
+ * Sets the event-header text in the **Agenda** view.
6971
7155
  */
6972
7156
  eventHeader;
6973
7157
  /**
6974
- * The title of the **Delete** icon.
7158
+ * Sets the title for the **Delete** icon.
6975
7159
  */
6976
7160
  deleteTitle;
6977
7161
  /**
6978
- * The title of the **Next** navigation button.
7162
+ * Sets the title for the **Next** navigation button.
6979
7163
  */
6980
7164
  nextTitle;
6981
7165
  /**
6982
- * The title of the **Previous** navigation button.
7166
+ * Sets the title for the **Previous** navigation button.
6983
7167
  */
6984
7168
  previousTitle;
6985
7169
  /**
6986
- * The text of the **Today** navigation button.
7170
+ * Sets the text for the **Today** navigation button.
6987
7171
  */
6988
7172
  today;
6989
7173
  /**
6990
- * The text of today's date in the header of the Calendar.
7174
+ * Sets the text for today's date in the header of the Calendar.
6991
7175
  */
6992
7176
  calendarToday;
6993
7177
  /**
6994
- * The text of the **Show full day** button that is displayed in the footer of the **Day**, **Week**, and **Timeline** views.
7178
+ * Sets the text for the **Show full day** button in the footer of the **Day**, **Week**, and **Timeline** views.
6995
7179
  */
6996
7180
  showFullDay;
6997
7181
  /**
6998
- * The text of the **Show work day** button that is displayed in the footer of the **Day**, **Week**, and **Timeline** views.
7182
+ * Sets the text for the **Show work day** button in the footer of the **Day**, **Week**, and **Timeline** views.
6999
7183
  */
7000
7184
  showWorkDay;
7001
7185
  /**
7002
- * The title of the **Day** view.
7186
+ * Sets the title for the **Day** view.
7003
7187
  */
7004
7188
  dayViewTitle;
7005
7189
  /**
7006
- * The title of the **Multi-Day** view.
7190
+ * Sets the title for the **Multi-Day** view.
7007
7191
  */
7008
7192
  multiDayViewTitle;
7009
7193
  /**
7010
- * The title of the **Week** view.
7194
+ * Sets the title for the **Week** view.
7011
7195
  */
7012
7196
  weekViewTitle;
7013
7197
  /**
7014
- * The title of the **Work Week** view.
7198
+ * Sets the title for the **Work Week** view.
7015
7199
  */
7016
7200
  workWeekViewTitle;
7017
7201
  /**
7018
- * The title of the **Month** view.
7202
+ * Sets the title for the **Month** view.
7019
7203
  */
7020
7204
  monthViewTitle;
7021
7205
  /**
7022
- * The title of the **Multi-Week** view.
7206
+ * Sets the title for the **Multi-Week** view.
7023
7207
  */
7024
7208
  multiWeekViewTitle;
7025
7209
  /**
7026
- * The title of the **Timeline** view.
7210
+ * Sets the title for the **Timeline** view.
7027
7211
  */
7028
7212
  timelineViewTitle;
7029
7213
  /**
7030
- * The title of the **Week** timeline view.
7214
+ * Sets the title for the **Timeline Week** view.
7031
7215
  */
7032
7216
  timelineWeekViewTitle;
7033
7217
  /**
7034
- * The title of the **Month** timeline view.
7218
+ * Sets the title for the **Timeline Month** view.
7035
7219
  */
7036
7220
  timelineMonthViewTitle;
7037
7221
  /**
7038
- * The title of the **Agenda** view.
7222
+ * Sets the title for the **Agenda** view.
7039
7223
  */
7040
7224
  agendaViewTitle;
7041
7225
  /**
7042
- * The title of the **Year** view.
7226
+ * Sets the title for the **Year** view.
7043
7227
  */
7044
7228
  yearViewTitle;
7045
7229
  /**
7046
- * The message displayed in **Year** view for any date that has no events.
7230
+ * Sets the message shown in **Year** view for dates with no events.
7047
7231
  */
7048
7232
  yearViewNoEvents;
7049
7233
  /* ********************* */
7050
7234
  /* Editing Section Start */
7051
7235
  /* ********************* */
7052
7236
  /**
7053
- * The text of the **Cancel** button displayed in the Scheduler dialogs.
7237
+ * Sets the text for the **Cancel** button in Scheduler dialogs.
7054
7238
  */
7055
7239
  cancel;
7056
7240
  /**
7057
- * The text of the **Save** button displayed in the Scheduler dialogs.
7241
+ * Sets the text for the **Save** button in Scheduler dialogs.
7058
7242
  */
7059
7243
  save;
7060
7244
  /**
7061
- * The text similar to 'Title' displayed in the Scheduler event editor.
7245
+ * Sets the label for the **Title** field in the event editor.
7062
7246
  */
7063
7247
  editorEventTitle;
7064
7248
  /**
7065
- * The text similar to 'Start' displayed in the Scheduler event editor.
7249
+ * Sets the label for the **Start** field in the event editor.
7066
7250
  */
7067
7251
  editorEventStart;
7068
7252
  /**
7069
- * The text similar to 'Start Time Zone' displayed in the Scheduler event editor.
7253
+ * Sets the label for the **Start Time Zone** field in the event editor.
7070
7254
  */
7071
7255
  editorEventStartTimeZone;
7072
7256
  /**
7073
- * The text similar to 'End' displayed in the Scheduler event editor.
7257
+ * Sets the label for the **End** field in the event editor.
7074
7258
  */
7075
7259
  editorEventEnd;
7076
7260
  /**
7077
- * The text similar to 'End Time Zone' displayed in the Scheduler event editor.
7261
+ * Sets the label for the **End Time Zone** field in the event editor.
7078
7262
  */
7079
7263
  editorEventEndTimeZone;
7080
7264
  /**
7081
- * The text similar to 'All Day Event' displayed in the Scheduler event editor.
7265
+ * Sets the label for the **All Day Event** field in the event editor.
7082
7266
  */
7083
7267
  editorEventAllDay;
7084
7268
  /**
7085
- * The text similar to 'Description' displayed in the Scheduler event editor.
7269
+ * Sets the label for the **Description** field in the event editor.
7086
7270
  */
7087
7271
  editorEventDescription;
7088
7272
  /**
7089
- * The text similar to 'Use separate Start and End Time Zones' displayed in the Scheduler event editor.
7273
+ * Sets the label for the **Use separate Start and End Time Zones** option in the event editor.
7090
7274
  */
7091
7275
  editorEventSeparateTimeZones;
7092
7276
  /**
7093
- * The text similar to 'Time Zone' displayed in the Scheduler event editor.
7277
+ * Sets the label for the **Time Zone** field in the event editor.
7094
7278
  */
7095
7279
  editorEventTimeZone;
7096
7280
  /**
7097
- * The **Today** button text in the popup of the DateTimePickers and DatePickers in the Scheduler event editor.
7281
+ * Sets the **Today** button text in the popup of the DateTimePickers and DatePickers in the event editor.
7098
7282
  */
7099
7283
  editorDateInputsToday;
7100
7284
  /**
7101
- * The title of the **Toggle** button in the popup of the DateTimePickers and DatePickers in the Scheduler event editor.
7285
+ * Sets the title for the **Toggle** button in the popup of the DateTimePickers and DatePickers in the event editor.
7102
7286
  */
7103
7287
  editorDateInputsToggle;
7104
7288
  /**
7105
- * The title of the **Parent View** button in the popup of the DateTimePickers and DatePickers in the Scheduler event editor.
7289
+ * Sets the title for the **Parent View** button in the popup of the DateTimePickers and DatePickers in the event editor.
7106
7290
  */
7107
7291
  editorDateInputsParentViewButton;
7108
7292
  /**
7109
- * The text of the **Now** button in the popup footer of the DateTimePickers and DatePickers in the Scheduler event editor.
7293
+ * Sets the text for the **Now** button in the popup footer of the DateTimePickers and DatePickers in the event editor.
7110
7294
  */
7111
7295
  editorDateInputsNow;
7112
7296
  /**
7113
- * The label of the **Now** button in the popup footer of the DateTimePickers and DatePickers in the Scheduler event editor.
7297
+ * Sets the label for the **Now** button in the popup footer of the DateTimePickers and DatePickers in the event editor.
7114
7298
  */
7115
7299
  editorDateInputsNowLabel;
7116
7300
  /**
7117
- * The text of the **Accept** button in the popup footer of the DateTimePickers and DatePickers in the Scheduler event editor.
7301
+ * Sets the text for the **Accept** button in the popup footer of the DateTimePickers and DatePickers in the event editor.
7118
7302
  */
7119
7303
  editorDateInputsAccept;
7120
7304
  /**
7121
- * The label of the **Accept** button in the popup footer of the DateTimePickers and DatePickers in the Scheduler event editor.
7305
+ * Sets the label for the **Accept** button in the popup footer of the DateTimePickers and DatePickers in the event editor.
7122
7306
  */
7123
7307
  editorDateInputsAcceptLabel;
7124
7308
  /**
7125
- * The text of the **Cancel** button in the popup footer of the DateTimePickers and DatePickers in the Scheduler event editor.
7309
+ * Sets the text for the **Cancel** button in the popup footer of the DateTimePickers and DatePickers in the event editor.
7126
7310
  */
7127
7311
  editorDateInputsCancel;
7128
7312
  /**
7129
- * The label of the **Cancel** button in the popup footer of the DateTimePickers and DatePickers in the Scheduler event editor.
7313
+ * Sets the label for the **Cancel** button in the popup footer of the DateTimePickers and DatePickers in the event editor.
7130
7314
  */
7131
7315
  editorDateInputsCancelLabel;
7132
7316
  /**
7133
- * The text of the **Date** tab in the popup header of the DateTimePickers and DatePickers in the Scheduler event editor.
7317
+ * Sets the text for the **Date** tab in the popup header of the DateTimePickers and DatePickers in the event editor.
7134
7318
  */
7135
7319
  editorDateInputsDateTab;
7136
7320
  /**
7137
- * The label of the **Date** tab in the popup header of the DateTimePickers and DatePickers in the Scheduler event editor.
7321
+ * Sets the label for the **Date** tab in the popup header of the DateTimePickers and DatePickers in the event editor.
7138
7322
  */
7139
7323
  editorDateInputsDateTabLabel;
7140
7324
  /**
7141
- * The text of the **Time** tab in the popup header of the DateTimePickers and DatePickers in the Scheduler event editor.
7325
+ * Sets the text for the **Time** tab in the popup header of the DateTimePickers and DatePickers in the event editor.
7142
7326
  */
7143
7327
  editorDateInputsTimeTab;
7144
7328
  /**
7145
- * The label of the **Time** tab in the popup header of the DateTimePickers and DatePickers in the Scheduler event editor.
7329
+ * Sets the label for the **Time** tab in the popup header of the DateTimePickers and DatePickers in the event editor.
7146
7330
  */
7147
7331
  editorDateInputsTimeTabLabel;
7148
7332
  /**
7149
- * The **Today** button text in the popup of the DatePickers in the Scheduler recurrence editor.
7333
+ * Sets the **Today** button text in the popup of the DatePickers in the recurrence editor.
7150
7334
  */
7151
7335
  recurrenceEditorDateInputsToday;
7152
7336
  /**
7153
- * The title of the **Toggle** button in the popup of the DatePickers in the Scheduler recurrence editor.
7337
+ * Sets the title for the **Toggle** button in the popup of the DatePickers in the recurrence editor.
7154
7338
  */
7155
7339
  recurrenceEditorDateInputsToggle;
7156
7340
  /**
7157
- * The title of the **Parent View** button in the popup of the DatePickers in the Scheduler recurrence editor.
7341
+ * Sets the title for the **Parent View** button in the popup of the DatePickers in the recurrence editor.
7158
7342
  */
7159
7343
  recurrenceEditorDateInputsParentViewButton;
7160
7344
  /**
7161
- * The title of the **Increment** button of the NumericTextBox in the Scheduler recurrence editor.
7345
+ * Sets the title for the **Increment** button of the NumericTextBox in the recurrence editor.
7162
7346
  */
7163
7347
  recurrenceEditorNumericIncrement;
7164
7348
  /**
7165
- * The title of the **Decrement** button of the NumericTextBox in the Scheduler recurrence editor.
7349
+ * Sets the title for the **Decrement** button of the NumericTextBox in the recurrence editor.
7166
7350
  */
7167
7351
  recurrenceEditorNumericDecrement;
7168
7352
  /**
7169
- * The text similar to 'Repeat' displayed in the Scheduler recurrence editor.
7353
+ * Sets the label for the **Repeat** field in the recurrence editor.
7170
7354
  */
7171
7355
  recurrenceEditorRepeat;
7172
7356
  /**
7173
- * The text similar to 'day(s)' displayed in the Scheduler recurrence editor.
7357
+ * Sets the text for the **day(s)** label in the recurrence editor.
7174
7358
  */
7175
7359
  recurrenceEditorDailyInterval;
7176
7360
  /**
7177
- * The text similar to 'Repeat every' displayed in the Scheduler recurrence editor.
7361
+ * Sets the label for the **Repeat every** field in the recurrence editor (daily).
7178
7362
  */
7179
7363
  recurrenceEditorDailyRepeatEvery;
7180
7364
  /**
7181
- * The text similar to 'week(s)' displayed in the Scheduler recurrence editor.
7365
+ * Sets the text for the **week(s)** label in the recurrence editor.
7182
7366
  */
7183
7367
  recurrenceEditorWeeklyInterval;
7184
7368
  /**
7185
- * The text similar to 'Repeat every' displayed in the Scheduler recurrence editor.
7369
+ * Sets the label for the **Repeat every** field in the recurrence editor (weekly).
7186
7370
  */
7187
7371
  recurrenceEditorWeeklyRepeatEvery;
7188
7372
  /**
7189
- * The text similar to 'Repeat on' displayed in the Scheduler recurrence editor.
7373
+ * Sets the label for the **Repeat on** field in the recurrence editor (weekly).
7190
7374
  */
7191
7375
  recurrenceEditorWeeklyRepeatOn;
7192
7376
  /**
7193
- * The text similar to 'Day' displayed in the Scheduler recurrence editor.
7377
+ * Sets the label for the **Day** field in the recurrence editor (monthly).
7194
7378
  */
7195
7379
  recurrenceEditorMonthlyDay;
7196
7380
  /**
7197
- * The text similar to 'month(s)' displayed in the Scheduler recurrence editor.
7381
+ * Sets the text for the **month(s)** label in the recurrence editor.
7198
7382
  */
7199
7383
  recurrenceEditorMonthlyInterval;
7200
7384
  /**
7201
- * The text similar to 'Repeat every' displayed in the Scheduler recurrence editor.
7385
+ * Sets the label for the **Repeat every** field in the recurrence editor (monthly).
7202
7386
  */
7203
7387
  recurrenceEditorMonthlyRepeatEvery;
7204
7388
  /**
7205
- * The text similar to 'Repeat on' displayed in the Scheduler recurrence editor.
7389
+ * Sets the label for the **Repeat on** field in the recurrence editor (monthly).
7206
7390
  */
7207
7391
  recurrenceEditorMonthlyRepeatOn;
7208
7392
  /**
7209
- * The text similar to 'of' displayed in the Scheduler recurrence editor.
7393
+ * Sets the label for the **of** text in the recurrence editor (yearly).
7210
7394
  */
7211
7395
  recurrenceEditorYearlyOf;
7212
7396
  /**
7213
- * The text similar to 'Repeat every' displayed in the Scheduler recurrence editor.
7397
+ * Sets the label for the **Repeat every** field in the recurrence editor (yearly).
7214
7398
  */
7215
7399
  recurrenceEditorYearlyRepeatEvery;
7216
7400
  /**
7217
- * The text similar to 'Repeat on' displayed in the Scheduler recurrence editor.
7401
+ * Sets the label for the **Repeat on** field in the recurrence editor (yearly).
7218
7402
  */
7219
7403
  recurrenceEditorYearlyRepeatOn;
7220
7404
  /**
7221
- * The text similar to 'year(s)' displayed in the Scheduler recurrence editor.
7405
+ * Sets the text for the **year(s)** label in the recurrence editor.
7222
7406
  */
7223
7407
  recurrenceEditorYearlyInterval;
7224
7408
  /**
7225
- * The text similar to 'Daily' displayed in the Scheduler recurrence editor.
7409
+ * Sets the label for the **Daily** frequency in the recurrence editor.
7226
7410
  */
7227
7411
  recurrenceEditorFrequenciesDaily;
7228
7412
  /**
7229
- * The text similar to 'Monthly' displayed in the Scheduler recurrence editor.
7413
+ * Sets the label for the **Monthly** frequency in the recurrence editor.
7230
7414
  */
7231
7415
  recurrenceEditorFrequenciesMonthly;
7232
7416
  /**
7233
- * The text similar to 'Never' displayed in the Scheduler recurrence editor.
7417
+ * Sets the label for the **Never** frequency in the recurrence editor.
7234
7418
  */
7235
7419
  recurrenceEditorFrequenciesNever;
7236
7420
  /**
7237
- * The text similar to 'Weekly' displayed in the Scheduler recurrence editor.
7421
+ * Sets the label for the **Weekly** frequency in the recurrence editor.
7238
7422
  */
7239
7423
  recurrenceEditorFrequenciesWeekly;
7240
7424
  /**
7241
- * The text similar to 'Yearly' displayed in the Scheduler recurrence editor.
7425
+ * Sets the label for the **Yearly** frequency in the recurrence editor.
7242
7426
  */
7243
7427
  recurrenceEditorFrequenciesYearly;
7244
7428
  /**
7245
- * The text similar to 'First' displayed in the Scheduler recurrence editor.
7429
+ * Sets the label for the **First** offset position in the recurrence editor.
7246
7430
  */
7247
7431
  recurrenceEditorOffsetPositionsFirst;
7248
7432
  /**
7249
- * The text similar to 'Second' displayed in the Scheduler recurrence editor.
7433
+ * Sets the label for the **Second** offset position in the recurrence editor.
7250
7434
  */
7251
7435
  recurrenceEditorOffsetPositionsSecond;
7252
7436
  /**
7253
- * The text similar to 'Third' displayed in the Scheduler recurrence editor.
7437
+ * Sets the label for the **Third** offset position in the recurrence editor.
7254
7438
  */
7255
7439
  recurrenceEditorOffsetPositionsThird;
7256
7440
  /**
7257
- * The text similar to 'Fourth' displayed in the Scheduler recurrence editor.
7441
+ * Sets the label for the **Fourth** offset position in the recurrence editor.
7258
7442
  */
7259
7443
  recurrenceEditorOffsetPositionsFourth;
7260
7444
  /**
7261
- * The text similar to 'Last' displayed in the Scheduler recurrence editor.
7445
+ * Sets the label for the **Last** offset position in the recurrence editor.
7262
7446
  */
7263
7447
  recurrenceEditorOffsetPositionsLast;
7264
7448
  /**
7265
- * The text similar to 'Day' displayed in the repeat by section of the monthly recurrence pattern.
7449
+ * Sets the label for the **Day** option in the repeat by section of the monthly recurrence pattern.
7266
7450
  */
7267
7451
  recurrenceEditorWeekdaysDay;
7268
7452
  /**
7269
- * The text similar to 'Weekday' displayed in the repeat by section of the monthly recurrence pattern.
7453
+ * Sets the label for the **Weekday** option in the repeat by section of the monthly recurrence pattern.
7270
7454
  */
7271
7455
  recurrenceEditorWeekdaysWeekday;
7272
7456
  /**
7273
- * The text similar to 'Weekend Day' displayed in the repeat by section of the monthly recurrence pattern.
7457
+ * Sets the label for the **Weekend Day** option in the repeat by section of the monthly recurrence pattern.
7274
7458
  */
7275
7459
  recurrenceEditorWeekdaysWeekendday;
7276
7460
  /**
7277
- * The text similar to 'After' displayed in the Scheduler recurrence editor.
7461
+ * Sets the label for the **After** option in the recurrence editor.
7278
7462
  */
7279
7463
  recurrenceEditorEndAfter;
7280
7464
  /**
7281
- * The text similar to 'occurrence(s)' displayed in the Scheduler recurrence editor.
7465
+ * Sets the text for the **occurrence(s)** label in the recurrence editor.
7282
7466
  */
7283
7467
  recurrenceEditorEndOccurrence;
7284
7468
  /**
7285
- * The text similar to 'End' displayed in the Scheduler recurrence editor.
7469
+ * Sets the label for the **End** field in the recurrence editor.
7286
7470
  */
7287
7471
  recurrenceEditorEndLabel;
7288
7472
  /**
7289
- * The text similar to 'Never' displayed in the Scheduler recurrence editor.
7473
+ * Sets the label for the **Never** option in the recurrence editor.
7290
7474
  */
7291
7475
  recurrenceEditorEndNever;
7292
7476
  /**
7293
- * The text similar to 'On' displayed in the Scheduler recurrence editor.
7477
+ * Sets the label for the **On** option in the recurrence editor.
7294
7478
  */
7295
7479
  recurrenceEditorEndOn;
7296
7480
  /* ******************* */
@@ -7300,55 +7484,55 @@ class Messages extends ComponentMessages {
7300
7484
  /* Dialogs Section Start */
7301
7485
  /* ********************* */
7302
7486
  /**
7303
- * The text similar to **Event** displayed as title of the Scheduler event editor.
7487
+ * Sets the label for the **Event** title in the event editor dialog.
7304
7488
  */
7305
7489
  editorTitle;
7306
7490
  /**
7307
- * The text of the **Delete** button displayed in the Scheduler remove confirmation dialog.
7491
+ * Sets the text for the **Delete** button in the remove confirmation dialog.
7308
7492
  */
7309
7493
  destroy;
7310
7494
  /**
7311
- * The text similar to **Are you sure you want to delete this event?** displayed in Scheduler remove confirmation dialog.
7495
+ * Sets the confirmation message for deleting an event.
7312
7496
  */
7313
7497
  deleteConfirmation;
7314
7498
  /**
7315
- * The text similar to **Do you want to edit only this event occurrence or the whole series?** displayed in the Scheduler recurring confirmation dialog.
7499
+ * Sets the confirmation message for editing a recurring event.
7316
7500
  */
7317
7501
  editRecurringConfirmation;
7318
7502
  /**
7319
- * The text of the **Edit current occurrence** button displayed in the Scheduler recurring confirmation dialog.
7503
+ * Sets the text for the **Edit current occurrence** button in the recurring confirmation dialog.
7320
7504
  */
7321
7505
  editOccurrence;
7322
7506
  /**
7323
- * The text of the **Edit the series** button displayed in the Scheduler recurring confirmation dialog.
7507
+ * Sets the text for the **Edit the series** button in the recurring confirmation dialog.
7324
7508
  */
7325
7509
  editSeries;
7326
7510
  /**
7327
- * The text similar to **Do you want to delete only this event occurrence or the whole series?** displayed in the Scheduler recurring confirmation dialog.
7511
+ * Sets the confirmation message for deleting a recurring event.
7328
7512
  */
7329
7513
  deleteRecurringConfirmation;
7330
7514
  /**
7331
- * The text of the **Delete current occurrence** button displayed in the Scheduler recurring confirmation dialog.
7515
+ * Sets the text for the **Delete current occurrence** button in the recurring confirmation dialog.
7332
7516
  */
7333
7517
  deleteOccurrence;
7334
7518
  /**
7335
- * The text similar of the **Delete the series** button displayed in the Scheduler recurring confirmation dialog.
7519
+ * Sets the text for the **Delete the series** button in the recurring confirmation dialog.
7336
7520
  */
7337
7521
  deleteSeries;
7338
7522
  /**
7339
- * The title of the remove confirmation dialog, similar to **Delete event**.
7523
+ * Sets the title for the remove confirmation dialog.
7340
7524
  */
7341
7525
  deleteDialogTitle;
7342
7526
  /**
7343
- * The title of the recurring remove confirmation dialog, similar to **Delete Recurring Item**.
7527
+ * Sets the title for the recurring remove confirmation dialog.
7344
7528
  */
7345
7529
  deleteRecurringDialogTitle;
7346
7530
  /**
7347
- * The title of the recurring edit confirmation dialog, similar to **Edit Recurring Item**.
7531
+ * Sets the title for the recurring edit confirmation dialog.
7348
7532
  */
7349
7533
  editRecurringDialogTitle;
7350
7534
  /**
7351
- * The value of the aria-label attribute of the `<select>` element used for switching the Scheduler views.
7535
+ * Sets the value of the aria-label attribute for the `select` element used to switch Scheduler views.
7352
7536
  */
7353
7537
  selectView;
7354
7538
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: Messages, deps: null, target: i0.ɵɵFactoryTarget.Directive });
@@ -7588,7 +7772,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
7588
7772
  const todayDate = () => getDate(new Date());
7589
7773
  const DAYS_IN_WEEK$1 = 7;
7590
7774
  /**
7591
- * Represents the [Kendo UI Scheduler component for Angular]({% slug overview_scheduler %}).
7775
+ * Represents the [Kendo UI Scheduler component for Angular](slug:overview_scheduler).
7776
+ *
7777
+ * @example
7778
+ * ```html
7779
+ * <kendo-scheduler [kendoSchedulerBinding]="events" [selectedDate]="selectedDate">
7780
+ * <kendo-scheduler-day-view></kendo-scheduler-day-view>
7781
+ * </kendo-scheduler>
7782
+ * ```
7783
+ *
7784
+ * @remarks
7785
+ * Supported children components are: {@link AgendaViewComponent},
7786
+ * {@link WeekViewComponent}, {@link WorkWeekViewComponent}, {@link YearViewComponent},
7787
+ * {@link SchedulerCustomMessagesComponent}, {@link TimelineMonthViewComponent},
7788
+ * {@link TimelineViewComponent}, {@link TimelineWeekViewComponent}, {@link DayViewComponent},
7789
+ * {@link MonthViewComponent}, {@link MultiDayViewComponent}, {@link MultiWeekViewComponent},
7790
+ * {@link PDFComponent}, {@link TimeZoneEditorComponent}, {@link RecurrenceEditorComponent}
7592
7791
  */
7593
7792
  class SchedulerComponent {
7594
7793
  wrapper;
@@ -7611,10 +7810,8 @@ class SchedulerComponent {
7611
7810
  return this.direction;
7612
7811
  }
7613
7812
  /**
7614
- * The index of the currently selected view.
7615
- *
7616
- * By default, the selected view index is `0` and
7617
- * indicates that the first declared view is visible.
7813
+ * Sets the index of the currently selected view. The default value is `0`, which shows the first declared view.
7814
+ * @default 0
7618
7815
  */
7619
7816
  set selectedViewIndex(index) {
7620
7817
  this.viewIndex = index;
@@ -7624,76 +7821,71 @@ class SchedulerComponent {
7624
7821
  return this.viewIndex;
7625
7822
  }
7626
7823
  /**
7627
- * Specifies if the Scheduler is editable.
7824
+ * Specifies whether the Scheduler is editable. Accepts a `boolean` or `EditableSettings` object.
7825
+ * @default false
7628
7826
  */
7629
7827
  editable = false;
7630
7828
  /**
7631
- * Specifies if the Scheduler's day or time slots are selectable ([see example]({% slug slotselection_scheduler %}#toc-custom-callback)).
7632
- *
7633
- * When this input is set to `true`, the Scheduler component will emit [`slotDragStart`]({% slug api_scheduler_schedulercomponent %}#toc-slotdragstart), [`slotDrag`]({% slug api_scheduler_schedulercomponent %}#toc-slotdrag), and [`slotDragEnd`]({% slug api_scheduler_schedulercomponent %}#toc-slotdragend) events upon user interaction.
7829
+ * Specifies whether the Scheduler's day or time slots are selectable ([see example](slug:slotselection_scheduler#custom-callback)).
7830
+ * When set to `true`, the Scheduler emits [`slotDragStart`]({% slug api_scheduler_schedulercomponent %}#toc-slotdragstart), [`slotDrag`]({% slug api_scheduler_schedulercomponent %}#toc-slotdrag), and [`slotDragEnd`]({% slug api_scheduler_schedulercomponent %}#toc-slotdragend) events on user interaction.
7831
+ * @default false
7634
7832
  */
7635
7833
  selectable = false;
7636
7834
  /**
7637
- * The minimum date that can be selected by using the navigation of the Scheduler.
7835
+ * Sets the minimum date that you can select using the Scheduler navigation.
7638
7836
  */
7639
7837
  min;
7640
7838
  /**
7641
- * The maximum date that can be selected by using the navigation of the Scheduler.
7839
+ * Sets the maximum date that you can select using the Scheduler navigation.
7642
7840
  */
7643
7841
  max;
7644
7842
  /**
7645
- * The height of the events in the **Month** and **Timeline** views, and the height of the **All day** events in the **Day** and **Week** views.
7843
+ * Sets the height of events in the **Month** and **Timeline** views, and the height of **All day** events in the **Day** and **Week** views.
7646
7844
  * @default 25
7647
7845
  */
7648
7846
  eventHeight = 25;
7649
7847
  /**
7650
- * Specifies the columns width. Applicable for the **Timeline** views.
7848
+ * Sets the column width for **Timeline** views.
7651
7849
  * @default 100
7652
7850
  */
7653
7851
  columnWidth = 100;
7654
7852
  /**
7655
- * If set to `true`, the view will be initially shown in the business-hours mode.
7656
- * By default, the view is displayed in the full-day mode. Applicable for the **Day**, **Week**, and **Timeline** views.
7853
+ * Sets whether the view shows business hours on initialization. By default, the view shows full-day hours. Applies to **Day**, **Week**, and **Timeline** views.
7657
7854
  * @default false
7658
7855
  */
7659
7856
  showWorkHours;
7660
7857
  /**
7661
- * The start time of the view. The Scheduler displays events which start after the start time.
7662
- * Accepts string values in the `HH:mm` format. Applicable for the **Day**, **Week**, and **Timeline** views.
7858
+ * Sets the start time of the view. Accepts a string in `HH:mm` format. Applies to **Day**, **Week**, and **Timeline** views.
7663
7859
  * @default '00:00'
7664
7860
  */
7665
7861
  startTime = '00:00';
7666
7862
  /**
7667
- * The end time of the view. The Scheduler displays events which end before the end time.
7668
- * Accepts string values in the `HH:mm` format. Applicable for the **Day**, **Week**, and **Timeline** views.
7863
+ * Sets the end time of the view. Accepts a string in `HH:mm` format. Applies to **Day**, **Week**, and **Timeline** views.
7669
7864
  * @default '00:00'
7670
7865
  */
7671
7866
  endTime = '00:00';
7672
7867
  /**
7673
- * The start time of the view when `showWorkHours` is set to `true`.
7674
- * Accepts string values in the `HH:mm` format. Applicable for the **Day**, **Week**, and **Timeline** views.
7868
+ * Sets the start time of the view when `showWorkHours` is `true`. Accepts a string in `HH:mm` format. Applies to **Day**, **Week**, and **Timeline** views.
7675
7869
  * @default '08:00'
7676
7870
  */
7677
7871
  workDayStart = '08:00';
7678
7872
  /**
7679
- * The end time of the view when `showWorkHours` is set to `true`.
7680
- * Accepts string values in the `HH:mm` format. Applicable for the **Day**, **Week**, and **Timeline** views.
7873
+ * Sets the end time of the view when `showWorkHours` is `true`. Accepts a string in `HH:mm` format. Applies to **Day**, **Week**, and **Timeline** views.
7681
7874
  * @default '17:00'
7682
7875
  */
7683
7876
  workDayEnd = '17:00';
7684
7877
  /**
7685
- * The start of the work week. Applicable for the **Day**, **Week**, and **Timeline** views.
7878
+ * Sets the start of the work week. Applies to **Day**, **Week**, and **Timeline** views.
7686
7879
  * @default 1
7687
7880
  */
7688
7881
  workWeekStart;
7689
7882
  /**
7690
- * The end of the work week. Applicable for the **Day**, **Week**, and **Timeline** views.
7883
+ * Sets the end of the work week. Applies to **Day**, **Week**, and **Timeline** views.
7691
7884
  * @default 5
7692
7885
  */
7693
7886
  workWeekEnd;
7694
7887
  /**
7695
- * The first day of the week. Applicable to **Week**, **Month** and **TimelineWeek** views.
7696
- * Defaults to the locale settings.
7888
+ * Sets the first day of the week. Applies to **Week**, **Month**, and **TimelineWeek** views. Defaults to the locale settings.
7697
7889
  */
7698
7890
  set weekStart(value) {
7699
7891
  this._weekStart = value;
@@ -7705,35 +7897,32 @@ class SchedulerComponent {
7705
7897
  return this.intlService.firstDay();
7706
7898
  }
7707
7899
  /**
7708
- * The duration (in minutes) of the time slots. Applicable for the day, week and timeline views.
7900
+ * Sets the duration (in minutes) of the time slots. Applies to **Day**, **Week**, and **Timeline** views.
7709
7901
  * @default 60
7710
7902
  */
7711
7903
  slotDuration = 60;
7712
7904
  /**
7713
- * The number of divisions of the time slots. Applicable for the **Day**, **Week**, and **Timeline** views.
7905
+ * Sets the number of divisions for the time slots. Applies to **Day**, **Week**, and **Timeline** views.
7714
7906
  * @default 2
7715
7907
  */
7716
7908
  slotDivisions = 2;
7717
7909
  /**
7718
- * A numeric value between 0 and 1 that specifies what percentage of the slot will be filled by the events.
7719
- * Applicable for the **Day** and **Week** views.
7910
+ * Sets the percentage of the slot filled by events. Accepts a value between 0 and 1. Applies to **Day** and **Week** views.
7720
7911
  * @default 0.9
7721
7912
  */
7722
7913
  slotFill = 0.9;
7723
7914
  /**
7724
- * Toggles the visibility of the all-day slot.
7725
- * Applicable for the **Day**, **Multi-Day**, **Week**, and **Work-Week** views.
7915
+ * Toggles the visibility of the all-day slot. Applies to **Day**, **Multi-Day**, **Week**, and **Work-Week** views.
7726
7916
  * @default true
7727
7917
  */
7728
7918
  allDaySlot = true;
7729
7919
  /**
7730
- * The time to which the view will initially be scrolled.
7731
- * Accepts string values in the `HH:mm` format or a JavaScript `Date`. Applicable for the **Day**, **Week**, and **Timeline** views.
7920
+ * Sets the time to which the view initially scrolls. Accepts a string in `HH:mm` format or a JavaScript `Date` object. Applies to **Day**, **Week**, and **Timeline** views.
7732
7921
  * @default '08:00'
7733
7922
  */
7734
7923
  scrollTime = this.workDayStart;
7735
7924
  /**
7736
- * Specifies the groups of the Scheduler.
7925
+ * Defines the Scheduler groups.
7737
7926
  */
7738
7927
  group;
7739
7928
  /**
@@ -7741,13 +7930,12 @@ class SchedulerComponent {
7741
7930
  */
7742
7931
  resources;
7743
7932
  /**
7744
- * Specifies if the Scheduler will display a loading indicator.
7933
+ * Specifies whether the Scheduler displays a loading indicator.
7745
7934
  * @default false
7746
7935
  */
7747
7936
  loading;
7748
7937
  /**
7749
- * Specifies the id of the timezone that will be displayed in the Scheduler.
7750
- * For example, `Europe/Sofia`.
7938
+ * Sets the timezone ID displayed in the Scheduler. For example, `Europe/Sofia`.
7751
7939
  * @default 'Etc/UTC'
7752
7940
  */
7753
7941
  set timezone(value) {
@@ -7762,7 +7950,7 @@ class SchedulerComponent {
7762
7950
  */
7763
7951
  selectedView;
7764
7952
  /**
7765
- * An array of event instances which will be shown by the Scheduler.
7953
+ * Sets the array of event instances shown by the Scheduler.
7766
7954
  */
7767
7955
  set events(value) {
7768
7956
  this._events = value;
@@ -7772,8 +7960,7 @@ class SchedulerComponent {
7772
7960
  return this._events;
7773
7961
  }
7774
7962
  /**
7775
- * The currently selected date of the Scheduler.
7776
- * Determines the period which is displayed.
7963
+ * Sets the currently selected date of the Scheduler. Determines the displayed period.
7777
7964
  */
7778
7965
  set selectedDate(value) {
7779
7966
  if (!value) {
@@ -7786,8 +7973,7 @@ class SchedulerComponent {
7786
7973
  return this._selectedDate;
7787
7974
  }
7788
7975
  /**
7789
- * The names of the model fields from which the Scheduler will read its data
7790
- * ([see example]({% slug databinding_scheduler %}#toc-binding-to-models)).
7976
+ * Sets the names of the model fields from which the Scheduler reads its data ([see example](slug:databinding_scheduler#binding-to-models).
7791
7977
  */
7792
7978
  set modelFields(value) {
7793
7979
  this._modelFields = { ...defaultModelFields, ...value };
@@ -7796,42 +7982,42 @@ class SchedulerComponent {
7796
7982
  return this._modelFields;
7797
7983
  }
7798
7984
  /**
7799
- * Specifies the Scheduler current time marker settings.
7985
+ * Sets the Scheduler current time marker settings.
7800
7986
  * @default true
7801
7987
  */
7802
7988
  currentTimeMarker = true;
7803
7989
  /**
7804
- * Specifies the settings for the ongoing events highlight of the Scheduler.
7990
+ * Defines the settings for highlighting ongoing events in the Scheduler.
7805
7991
  * @default true
7806
7992
  */
7807
7993
  highlightOngoingEvents = true;
7808
7994
  /**
7809
- * Specifies whether to display the toolbar of the Scheduler.
7995
+ * Specifies whether to display the Scheduler toolbar.
7810
7996
  * @default true
7811
7997
  */
7812
7998
  showToolbar = true;
7813
7999
  /**
7814
- * Specifies whether to display the footer of the Scheduler.
8000
+ * Specifies whether to display the Scheduler footer.
7815
8001
  * @default true
7816
8002
  */
7817
8003
  showFooter = true;
7818
8004
  /**
7819
8005
  * Defines a function that is executed for every slot in the view.
7820
- * The function returns a value which is supported by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
8006
+ * The function returns a value supported by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
7821
8007
  */
7822
8008
  slotClass;
7823
8009
  /**
7824
8010
  * Defines a function that is executed for every event in the view.
7825
- * The function returns a value which is supported by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
8011
+ * The function returns a value supported by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
7826
8012
  */
7827
8013
  eventClass;
7828
8014
  /**
7829
8015
  * Defines a function that is executed for every event in the view.
7830
- * The function returns a value which is supported by [`ngStyle`](link:site.data.urls.angular['ngstyleapi']).
8016
+ * The function returns a value supported by [`ngStyle`](link:site.data.urls.angular['ngstyleapi']).
7831
8017
  */
7832
8018
  eventStyles;
7833
8019
  /**
7834
- * A callback that executes for each slot of the Scheduler view.
8020
+ * A callback that is executed for each slot of the Scheduler view.
7835
8021
  * If it returns `true`, the `k-selected` CSS class will be added to the cell, making it visibly selected.
7836
8022
  * @default () => false
7837
8023
  */
@@ -7841,16 +8027,15 @@ class SchedulerComponent {
7841
8027
  */
7842
8028
  selectedViewIndexChange = new EventEmitter();
7843
8029
  /**
7844
- * Fires when the Scheduler is about to execute a navigation action
7845
- * (a view, date, or focus change).
8030
+ * Emits when the Scheduler is about to perform a navigation action, such as changing the view, date, or focus.
7846
8031
  */
7847
8032
  navigate = new EventEmitter();
7848
8033
  /**
7849
- * Fires when the date range that is displayed in the Scheduler changes.
8034
+ * Emits when the displayed date range in the Scheduler changes.
7850
8035
  */
7851
8036
  dateChange = new EventEmitter();
7852
8037
  /**
7853
- * Fires when a Scheduler view slot is clicked.
8038
+ * Emits when a Scheduler view slot is clicked.
7854
8039
  */
7855
8040
  slotClick = new EventEmitter();
7856
8041
  /**
@@ -7858,8 +8043,7 @@ class SchedulerComponent {
7858
8043
  */
7859
8044
  slotDblClick = new EventEmitter();
7860
8045
  /**
7861
- * Fires when the user creates a new event using the `'c'` key.
7862
- * ([see example]({% slug keyboard_navigation_scheduler %})).
8046
+ * Emits when the user creates a new event using the `'c'` key ([see example](slug:keyboard_navigation_scheduler)).
7863
8047
  */
7864
8048
  create = new EventEmitter();
7865
8049
  /**
@@ -7871,7 +8055,7 @@ class SchedulerComponent {
7871
8055
  */
7872
8056
  eventDblClick = new EventEmitter();
7873
8057
  /**
7874
- * Fires when a key is pressed on a focused Scheduler event.
8058
+ * Emits when you press a key on a focused Scheduler event.
7875
8059
  */
7876
8060
  eventKeydown = new EventEmitter();
7877
8061
  /**
@@ -7891,7 +8075,7 @@ class SchedulerComponent {
7891
8075
  */
7892
8076
  resizeStart = new EventEmitter();
7893
8077
  /**
7894
- * Fires when the user is resizing a Scheduler event.
8078
+ * Emits while the user is resizing a Scheduler event.
7895
8079
  */
7896
8080
  resize = new EventEmitter();
7897
8081
  /**
@@ -7903,7 +8087,7 @@ class SchedulerComponent {
7903
8087
  */
7904
8088
  dragStart = new EventEmitter();
7905
8089
  /**
7906
- * Fires when the user is dragging a Scheduler event.
8090
+ * Fires while the user is dragging a Scheduler event.
7907
8091
  */
7908
8092
  drag = new EventEmitter();
7909
8093
  /**
@@ -7915,7 +8099,7 @@ class SchedulerComponent {
7915
8099
  */
7916
8100
  slotDragStart = new EventEmitter();
7917
8101
  /**
7918
- * Fires when the user is drag-selecting a Scheduler slot range.
8102
+ * Fires while the user is drag-selecting a Scheduler slot range.
7919
8103
  */
7920
8104
  slotDrag = new EventEmitter();
7921
8105
  /**
@@ -9520,10 +9704,19 @@ const occurrences = (item, fields, range, timezone, weekStart) => {
9520
9704
  return [item, ...expanded];
9521
9705
  };
9522
9706
  /**
9523
- * A directive that processes Scheduler events in-memory ([see example](slug:databinding_scheduler#toc-using-the-built-in-directive)).
9707
+ * A directive that processes Scheduler events in memory ([see example](slug:databinding_scheduler#toc-using-the-built-in-directive)).
9524
9708
  *
9525
- * Processing includes the expanding of recurring events and the filtering of data for
9709
+ * Processing includes expanding of recurring events and filtering data for
9526
9710
  * the currently active period.
9711
+ *
9712
+ * @example
9713
+ * ```html
9714
+ * <kendo-scheduler [kendoSchedulerBinding]="data">
9715
+ * </kendo-scheduler>
9716
+ * ```
9717
+ *
9718
+ * @remarks
9719
+ * Applied to: {@link SchedulerComponent}
9527
9720
  */
9528
9721
  class DataBindingDirective {
9529
9722
  scheduler;
@@ -9531,7 +9724,7 @@ class DataBindingDirective {
9531
9724
  intl;
9532
9725
  localDataChangesService;
9533
9726
  /**
9534
- * The array of data which will populate the Scheduler.
9727
+ * Sets the data array for the Scheduler.
9535
9728
  */
9536
9729
  set data(value) {
9537
9730
  this.originalData = value || [];
@@ -9617,7 +9810,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
9617
9810
  }] } });
9618
9811
 
9619
9812
  /**
9620
- * Custom component messages override default component messages.
9813
+ * Represents the custom messages component of the Scheduler.
9814
+ *
9815
+ * Use this component to override default messages for the Scheduler.
9816
+ *
9817
+ * @example
9818
+ * ```html
9819
+ * <kendo-scheduler>
9820
+ * <kendo-scheduler-messages
9821
+ * allDay="Custom All Day"
9822
+ * today="Custom Today"
9823
+ * weekViewTitle="Custom Week View Title">
9824
+ * </kendo-scheduler-messages>
9825
+ * </kendo-scheduler>
9826
+ * ```
9621
9827
  */
9622
9828
  class SchedulerCustomMessagesComponent extends Messages {
9623
9829
  service;
@@ -9652,20 +9858,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
9652
9858
  }], ctorParameters: function () { return [{ type: i1$1.LocalizationService }]; } });
9653
9859
 
9654
9860
  /**
9655
- * Represents the `export-to-PDF` command of the Scheduler.
9656
- * You can apply this directive to any `button` element inside a
9657
- * [`ToolbarTemplate`]({% slug toolbar_scheduler %}).
9658
- * When the user clicks a button that is associated with the directive, the
9659
- * [`pdfExport`]({% slug api_scheduler_schedulercomponent %}#toc-pdfexport) event
9660
- * fires ([see example]({% slug pdfexport_scheduler %})).
9861
+ * Represents the `export-to-PDF` command for the Scheduler.
9661
9862
  *
9863
+ * You can apply this directive to any `button` element inside a [`ToolbarTemplate`](slug:toolbar_scheduler).
9864
+ * When a user clicks a button associated with this directive, the [`pdfExport`](slug:api_scheduler_schedulercomponent#toc-pdfexport) event fires
9865
+ * ([see example](slug:pdfexport_scheduler)).
9866
+ *
9867
+ * @example
9662
9868
  * ```html
9663
9869
  * <kendo-scheduler>
9664
- * <ng-template kendoSchedulerToolbarTemplate>
9665
- * <button kendoSchedulerPDFCommand>Export PDF</button>
9666
- * </ng-template>
9667
- * <kendo-scheduler-pdf fileName="Scheduler.pdf">
9668
- * </kendo-scheduler-pdf>
9870
+ * <ng-template kendoSchedulerToolbarTemplate>
9871
+ * <button kendoSchedulerPDFCommand>Export to PDF</button>
9872
+ * </ng-template>
9873
+ * <kendo-scheduler-pdf fileName="Scheduler.pdf">
9874
+ * </kendo-scheduler-pdf>
9669
9875
  * </kendo-scheduler>
9670
9876
  * ```
9671
9877
  */
@@ -9733,7 +9939,15 @@ const createElement = (tagName, className) => {
9733
9939
  };
9734
9940
  const createDiv = (className) => createElement('div', className);
9735
9941
  /**
9736
- * Configures the settings for the export of Scheduler in PDF ([see example]({% slug pdfexport_scheduler %})).
9942
+ * Configures the settings for exporting the Scheduler to PDF
9943
+ * ([see example](slug:pdfexport_scheduler)).
9944
+ *
9945
+ * @example
9946
+ * ```html
9947
+ * <kendo-scheduler >
9948
+ * <kendo-scheduler-pdf fileName="Scheduler.pdf"> </kendo-scheduler-pdf>
9949
+ * </kendo-scheduler>
9950
+ * ```
9737
9951
  */
9738
9952
  class PDFComponent {
9739
9953
  pdfService;
@@ -9748,16 +9962,19 @@ class PDFComponent {
9748
9962
  */
9749
9963
  avoidLinks;
9750
9964
  /**
9751
- * The creator of the PDF document.
9965
+ * Sets the creator of the PDF document.
9966
+ *
9752
9967
  * @default 'Kendo UI PDF Generator'
9753
9968
  */
9754
9969
  creator = 'Kendo UI PDF Generator';
9755
9970
  /**
9756
- * The date when the PDF document is created. Defaults to `new Date()`.
9971
+ * Sets the date when the PDF document is created.
9972
+ *
9973
+ * @default 'new Date()'
9757
9974
  */
9758
9975
  date;
9759
9976
  /**
9760
- * The forced resolution of the images in the exported PDF document.
9977
+ * Sets the forced resolution of the images in the exported PDF document.
9761
9978
  * By default, the images are exported at their full resolution.
9762
9979
  */
9763
9980
  imageResolution;
@@ -9780,8 +9997,8 @@ class PDFComponent {
9780
9997
  */
9781
9998
  margin;
9782
9999
  /**
9783
- * A scale factor. The text size on the screen might be too big for printing.
9784
- * To scale down the output in PDF, use this option.
10000
+ * Sets the scale factor for the output in PDF. Use this option when the text size on the screen is too big for printing.
10001
+ *
9785
10002
  * @default 1
9786
10003
  */
9787
10004
  scale;
@@ -9804,11 +10021,11 @@ class PDFComponent {
9804
10021
  */
9805
10022
  proxyURL;
9806
10023
  /**
9807
- * A name or keyword which indicates where to display the document that is
9808
- * returned from the proxy.
10024
+ * Sets the name or keyword that indicates where to display the document returned from the proxy.
9809
10025
  *
9810
10026
  * To display the document in a new window or iframe, the proxy has to have the
9811
10027
  * `"Content-Disposition"` header set to `inline; filename="<fileName.pdf>"`.
10028
+ *
9812
10029
  * @default '_self'
9813
10030
  */
9814
10031
  proxyTarget;
@@ -9946,18 +10163,30 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
9946
10163
  }] } });
9947
10164
 
9948
10165
  /**
9949
- * A directive which manages the in-memory selection state of the Scheduler slots
9950
- * ([see example]({% slug slotselection_scheduler %}#toc-built-in-directive)).
10166
+ * Represents a directive that manages the built-in slot selection in the Scheduler.
10167
+ *
10168
+ * Add the `kendoSchedulerSlotSelectable` directive to a `<kendo-scheduler>` instance to allow users to select time slots by clicking or dragging.
10169
+ *
10170
+ * The directive keeps track of the selected slot range and emits changes when the selection is updated by user interaction.
10171
+ *
10172
+ * @example
10173
+ * ```html
10174
+ * <kendo-scheduler kendoSchedulerSlotSelectable [(slotSelection)]="selectedSlot">
10175
+ * </kendo-scheduler>
10176
+ * ```
10177
+ *
10178
+ * @remarks
10179
+ * Applied to: {@link SchedulerComponent}
9951
10180
  */
9952
10181
  class SlotSelectableDirective {
9953
10182
  scheduler;
9954
10183
  cdr;
9955
10184
  /**
9956
- * The currently selected slot range.
10185
+ * Represents the currently selected slot range.
9957
10186
  */
9958
10187
  slotSelection;
9959
10188
  /**
9960
- * Fires when the currently selected slot range has changed through user interaction.
10189
+ * Fires when the user changes the currently selected slot range.
9961
10190
  */
9962
10191
  slotSelectionChange = new EventEmitter();
9963
10192
  /**
@@ -10062,16 +10291,26 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
10062
10291
  // eslint-disable no-input-rename
10063
10292
  /**
10064
10293
  * A directive selector for a custom Scheduler view.
10294
+ *
10295
+ * @example
10296
+ * ```html
10297
+ * <kendo-scheduler [kendoSchedulerBinding]="events">
10298
+ * <kendo-scheduler-day-view></kendo-scheduler-day-view>
10299
+ * <kendo-scheduler-week-view></kendo-scheduler-week-view>
10300
+ * <ng-template kendoSchedulerView="My Scheduler View">
10301
+ * <app-custom-view></app-custom-view>
10302
+ * </ng-template>
10303
+ * </kendo-scheduler>
10304
+ * ```
10065
10305
  */
10066
10306
  class SchedulerViewDirective extends SchedulerView {
10067
10307
  template;
10068
10308
  /**
10069
- * The user-friendly name of this view.
10309
+ * Sets the user-friendly name for this view.
10070
10310
  */
10071
10311
  title;
10072
10312
  /**
10073
- * The invariant name for this view. For example, `day`.
10074
- * If not set, the name will be the same as the title.
10313
+ * Sets the invariant name for this view. If not set, uses the defined user-friendly name.
10075
10314
  */
10076
10315
  get name() {
10077
10316
  return this._name || this.title;
@@ -11345,7 +11584,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
11345
11584
  }] } });
11346
11585
 
11347
11586
  /**
11348
- * The component for rendering the **Agenda** view.
11587
+ * Represents the component that renders the **Agenda** view in the Scheduler.
11588
+ *
11589
+ * @example
11590
+ * ```html
11591
+ * <kendo-scheduler>
11592
+ * <kendo-scheduler-agenda-view></kendo-scheduler-agenda-view>
11593
+ * </kendo-scheduler>
11594
+ * ```
11349
11595
  */
11350
11596
  class AgendaViewComponent extends ConfigurationViewBase {
11351
11597
  /**
@@ -11355,19 +11601,16 @@ class AgendaViewComponent extends ConfigurationViewBase {
11355
11601
  return this.localization.get('agendaViewTitle');
11356
11602
  }
11357
11603
  /**
11358
- * The long-date format for displaying the
11359
- * selected date in the Scheduler toolbar.
11360
- * Defaults to `{0:D} - {1:D}`,
11361
- * where `0` is the start and `1` is the end date
11362
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
11604
+ * Sets the long-date format for the selected date in the Scheduler toolbar.
11605
+ * Defaults to `'{0:D} - {1:D}'`, where `0` is the start and `1` is the end date.
11606
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
11607
+ * @default '{0:D} - {1:D}'
11363
11608
  */
11364
11609
  selectedDateFormat = '{0:D} - {1:D}';
11365
11610
  /**
11366
- * The short-date format for displaying the
11367
- * selected date in the Scheduler toolbar.
11368
- * Defaults to `{0:d} - {1:d}`,
11369
- * where `0` is the start and `1` is the end date
11370
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
11611
+ * Sets the short-date format for the selected date in the Scheduler toolbar.
11612
+ * Defaults to `'{0:d} - {1:d}'`, where `0` is the start and `1` is the end date.
11613
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
11371
11614
  * @default '{0:d} - {1:d}'
11372
11615
  */
11373
11616
  selectedShortDateFormat = '{0:d} - {1:d}';
@@ -14406,7 +14649,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
14406
14649
  }] } });
14407
14650
 
14408
14651
  /**
14409
- * The component for rendering the **Month** view.
14652
+ * Represents the component that renders the **Month** view in the Scheduler.
14653
+ *
14654
+ * @example
14655
+ * ```html
14656
+ * <kendo-scheduler>
14657
+ * <kendo-scheduler-month-view></kendo-scheduler-month-view>
14658
+ * </kendo-scheduler>
14659
+ * ```
14410
14660
  */
14411
14661
  class MonthViewComponent extends ConfigurationViewBase {
14412
14662
  intl;
@@ -14417,11 +14667,9 @@ class MonthViewComponent extends ConfigurationViewBase {
14417
14667
  return this.localization.get('monthViewTitle');
14418
14668
  }
14419
14669
  /**
14420
- * The number of events to be rendered per day. Setting this property to 'auto'
14421
- * will display all events in the respective slot
14670
+ * Sets the number of events to render per day. If set to `'auto'`, all events display in the slot. If set to `0`, it normalizes to `1`
14422
14671
  * ([see example](slug:month_views_scheduler#setting-the-number-of-events-per-day)).
14423
- * > When set to `'auto'` it will automatically set the `adaptiveSlotHeight` property to `true`.
14424
- * > If set to `0` it will be normalized internally to `1`.
14672
+ * > When set to `'auto'`, it automatically sets the `adaptiveSlotHeight` property to `true`.
14425
14673
  * @default 2
14426
14674
  */
14427
14675
  set eventsPerDay(events) {
@@ -14432,30 +14680,26 @@ class MonthViewComponent extends ConfigurationViewBase {
14432
14680
  }
14433
14681
  _eventsPerDay;
14434
14682
  /**
14435
- * The height of the rendered events. Setting this property to 'auto' will
14436
- * set the height of each event automatically based on its content
14683
+ * Sets the height of the rendered events. If set to `'auto'`, the height is based on the event content
14437
14684
  * ([see example](slug:month_views_scheduler#configuring-the-height-of-the-scheduler-events)).
14438
- * > When set to `'auto'` it will automatically set the `adaptiveSlotHeight` property to `true`.
14685
+ * > When set to `'auto'`, it automatically sets the `adaptiveSlotHeight` property to `true`.
14439
14686
  */
14440
14687
  eventHeight;
14441
14688
  /**
14442
- * Increases the slot group (row) height when containing events up to the number of displayed events
14443
- * and reduces its height if there are less events for that specific slot group (row)
14689
+ * Enables adaptive slot height in the Scheduler. Increases the slot group (row) height when containing events up to the number of displayed events and reduces its height if there are fewer events for that slot group (row)
14444
14690
  * ([see example](slug:month_views_scheduler#enabling-the-adaptive-slot-height-of-the-scheduler)).
14445
14691
  * @default false
14446
14692
  */
14447
14693
  adaptiveSlotHeight;
14448
14694
  /**
14449
- * The long-date format for displaying the
14450
- * selected date in the Scheduler toolbar.
14451
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
14695
+ * Sets the long-date format for the selected date in the Scheduler toolbar.
14696
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
14452
14697
  * @default '{0:Y}'
14453
14698
  */
14454
14699
  selectedDateFormat = '{0:Y}';
14455
14700
  /**
14456
- * The short-date format for displaying the
14457
- * selected date in the Scheduler toolbar.
14458
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
14701
+ * Sets the short-date format for the selected date in the Scheduler toolbar.
14702
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
14459
14703
  * @default '{0:y}'
14460
14704
  */
14461
14705
  selectedShortDateFormat = '{0:y}';
@@ -14576,7 +14820,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
14576
14820
  }] } });
14577
14821
 
14578
14822
  /**
14579
- * The component for rendering the **Multi-Week** view.
14823
+ * Represents the component that renders the **Multi-Week** view in the Scheduler.
14824
+ *
14825
+ * @example
14826
+ * ```html
14827
+ * <kendo-scheduler>
14828
+ * <kendo-scheduler-multi-week-view></kendo-scheduler-multi-week-view>
14829
+ * </kendo-scheduler>
14830
+ * ```
14580
14831
  */
14581
14832
  class MultiWeekViewComponent extends ConfigurationViewBase {
14582
14833
  intl;
@@ -14587,18 +14838,15 @@ class MultiWeekViewComponent extends ConfigurationViewBase {
14587
14838
  return this.localization.get('multiWeekViewTitle');
14588
14839
  }
14589
14840
  /**
14590
- * The height of the rendered events. Setting this property to `'auto'` will
14591
- * set the height of each event automatically based on its content
14841
+ * Sets the height of the rendered events. If set to `'auto'`, the height is based on the event content
14592
14842
  * ([see example](slug:multiweek_views_scheduler#configuring-the-height-of-the-scheduler-events)).
14593
- * > When set to `'auto'` it will automatically set the `adaptiveSlotHeight` property to `true`.
14843
+ * > When set to `'auto'`, it automatically sets the `adaptiveSlotHeight` property to `true`.
14594
14844
  */
14595
14845
  eventHeight;
14596
14846
  /**
14597
- * The number of events to be rendered per day. Setting this property to 'auto'
14598
- * will display all events in the respective slot
14847
+ * Sets the number of events to render per day. If set to `'auto'`, all events display in the slot. If set to `0`, it normalizes to `1`
14599
14848
  * ([see example](slug:multiweek_views_scheduler#setting-the-number-of-events-per-day)).
14600
- * > When set to `'auto'` it will automatically set the `adaptiveSlotHeight` property to `true`.
14601
- * > If set to `0` it will be normalized internally to `1`.
14849
+ * > When set to `'auto'`, it automatically sets the `adaptiveSlotHeight` property to `true`.
14602
14850
  * @default 2
14603
14851
  */
14604
14852
  set eventsPerDay(events) {
@@ -14609,34 +14857,32 @@ class MultiWeekViewComponent extends ConfigurationViewBase {
14609
14857
  }
14610
14858
  _eventsPerDay;
14611
14859
  /**
14612
- * Increases the slot group (row) height when containing events up to the number of displayed events
14613
- * and reduces its height if there are less events for that specific slot group (row)
14860
+ * Enables adaptive slot height. Increases the slot group (row) height when containing events up to the number of displayed events and reduces its height if there are fewer events for that slot group (row)
14614
14861
  * ([see example](slug:multiweek_views_scheduler#enabling-the-adaptive-slot-height-of-the-scheduler)).
14615
14862
  * @default false
14616
14863
  */
14617
14864
  adaptiveSlotHeight;
14618
14865
  /**
14619
- * The number of weeks to be rendered.
14866
+ * Sets the number of weeks to render in the view.
14620
14867
  * @default 6
14621
14868
  */
14622
14869
  numberOfWeeks = WEEKS_COUNT;
14623
14870
  /**
14624
- * The long-date format for displaying the
14625
- * selected date in the Scheduler toolbar.
14626
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
14871
+ * Sets the long-date format for the selected date in the Scheduler toolbar.
14872
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
14627
14873
  * @default '{0:D} - {1:D}'
14628
14874
  */
14629
14875
  selectedDateFormat = '{0:D} - {1:D}';
14630
14876
  /**
14631
- * The short-date format for displaying the
14632
- * selected date in the Scheduler toolbar.
14633
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
14877
+ * Sets the short-date format for the selected date in the Scheduler toolbar.
14878
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
14634
14879
  * @default '{0:d} - {1:d}'
14635
14880
  */
14636
14881
  selectedShortDateFormat = '{0:d} - {1:d}';
14637
14882
  multiWeekDaySlotTemplate;
14638
14883
  /**
14639
- * The invariant name for this view (`multiWeek`).
14884
+ * The invariant name for this view.
14885
+ * @default 'multiWeek'
14640
14886
  */
14641
14887
  name = 'multiWeek';
14642
14888
  get viewEventHeight() {
@@ -17333,7 +17579,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
17333
17579
  }] } });
17334
17580
 
17335
17581
  /**
17336
- * The component for rendering the **Day** view.
17582
+ * Represents the component that renders the **Day** view in the Scheduler.
17583
+ *
17584
+ * @example
17585
+ * ```html
17586
+ * <kendo-scheduler>
17587
+ * <kendo-scheduler-day-view></kendo-scheduler-day-view>
17588
+ * </kendo-scheduler>
17589
+ * ```
17337
17590
  */
17338
17591
  class DayViewComponent extends MultiDayViewBase {
17339
17592
  /**
@@ -17343,9 +17596,8 @@ class DayViewComponent extends MultiDayViewBase {
17343
17596
  return this.localization.get('dayViewTitle');
17344
17597
  }
17345
17598
  /**
17346
- * The long-date format for displaying the
17347
- * selected date in the Scheduler toolbar.
17348
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
17599
+ * Sets the long-date format for the selected date in the Scheduler toolbar.
17600
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
17349
17601
  * @default '{0:D}'
17350
17602
  */
17351
17603
  set selectedDateFormat(value) {
@@ -17355,9 +17607,8 @@ class DayViewComponent extends MultiDayViewBase {
17355
17607
  return this._selectedDateFormat;
17356
17608
  }
17357
17609
  /**
17358
- * The short-date format for displaying the
17359
- * selected date in the Scheduler toolbar.
17360
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
17610
+ * Sets the short-date format for the selected date in the Scheduler toolbar.
17611
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
17361
17612
  * @default '{0:d}'
17362
17613
  */
17363
17614
  set selectedShortDateFormat(value) {
@@ -17486,14 +17737,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
17486
17737
  }] } });
17487
17738
 
17488
17739
  /**
17489
- * The component for rendering the **Multi-Day** view.
17740
+ * Represents the component that renders the **Multi-Day** view in the Scheduler.
17741
+ *
17742
+ * @example
17743
+ * ```html
17744
+ * <kendo-scheduler>
17745
+ * <kendo-scheduler-multi-day-view></kendo-scheduler-multi-day-view>
17746
+ * </kendo-scheduler>
17747
+ * ```
17490
17748
  */
17491
17749
  class MultiDayViewComponent extends DayViewComponent {
17492
17750
  /**
17493
- * The long-date format for displaying the
17494
- * selected date in the Scheduler toolbar.
17495
- * Defaults to `{0:D} - {1:D}` for multiple days and `{0:D}` for a single day
17496
- * ([more information](slug:parsingandformatting_intl#toc-date-formatting)).
17751
+ * Sets the long-date format for the selected date in the Scheduler toolbar.
17752
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
17753
+ * The default value is `'{0:D} - {1:D}'` for multiple days and `'{0:D}'` for a single day.
17497
17754
  * @default '{0:D} - {1:D}'
17498
17755
  */
17499
17756
  set selectedDateFormat(value) {
@@ -17503,10 +17760,9 @@ class MultiDayViewComponent extends DayViewComponent {
17503
17760
  return this.dateFormat || this.defaultDateFormat;
17504
17761
  }
17505
17762
  /**
17506
- * The short date format for displaying the
17507
- * selected date in the Scheduler toolbar.
17508
- * Defaults to `{0:d} - {1:d}` for multiple days and `{0:d}` for a single day
17509
- * ([more information](slug:parsingandformatting_intl#toc-date-formatting)).
17763
+ * Sets the short-date format for the selected date in the Scheduler toolbar.
17764
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
17765
+ * The default value is `'{0:d} - {1:d}'` for multiple days and `'{0:d}'` for a single day.
17510
17766
  * @default '{0:d} - {1:d}'
17511
17767
  */
17512
17768
  set selectedShortDateFormat(value) {
@@ -17516,7 +17772,7 @@ class MultiDayViewComponent extends DayViewComponent {
17516
17772
  return this.shortDateFormat || this.defaultShortDateFormat;
17517
17773
  }
17518
17774
  /**
17519
- * Specifies the number of days that the view will render.
17775
+ * Sets the number of days to render in the view.
17520
17776
  * @default 1
17521
17777
  */
17522
17778
  numberOfDays = 1;
@@ -17528,7 +17784,7 @@ class MultiDayViewComponent extends DayViewComponent {
17528
17784
  }
17529
17785
  /**
17530
17786
  * The invariant name for this view.
17531
- * @default 'multi-day'
17787
+ * @default 'multiDay'
17532
17788
  */
17533
17789
  name = 'multiDay';
17534
17790
  get defaultDateFormat() {
@@ -17644,7 +17900,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
17644
17900
  }] } });
17645
17901
 
17646
17902
  /**
17647
- * The component for rendering the **Week** view.
17903
+ * Represents the component that renders the **Week** view in the Scheduler.
17904
+ *
17905
+ * @example
17906
+ * ```html
17907
+ * <kendo-scheduler>
17908
+ * <kendo-scheduler-week-view></kendo-scheduler-week-view>
17909
+ * </kendo-scheduler>
17910
+ * ```
17648
17911
  */
17649
17912
  class WeekViewComponent extends MultiDayViewBase {
17650
17913
  intl;
@@ -17655,20 +17918,16 @@ class WeekViewComponent extends MultiDayViewBase {
17655
17918
  return this.localization.get('weekViewTitle');
17656
17919
  }
17657
17920
  /**
17658
- * The long-date format for displaying the
17659
- * selected date in the Scheduler toolbar.
17660
- * Defaults to `{0:D} - {1:D}`,
17661
- * where `0` is the start and `1` is the end date
17662
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting).
17921
+ * Sets the long-date format for the selected date in the Scheduler toolbar.
17922
+ * Defaults to `'{0:D} - {1:D}'`, where `0` is the start and `1` is the end date.
17923
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
17663
17924
  * @default '{0:D} - {1:D}'
17664
17925
  */
17665
17926
  selectedDateFormat = '{0:D} - {1:D}';
17666
17927
  /**
17667
- * The short date format for displaying the
17668
- * selected date in the Scheduler toolbar.
17669
- * Defaults to `{0:d} - {1:d}`,
17670
- * where `0` is the start and `1` is the end date
17671
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting).
17928
+ * Sets the short-date format for the selected date in the Scheduler toolbar.
17929
+ * Defaults to `'{0:d} - {1:d}'`, where `0` is the start and `1` is the end date.
17930
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
17672
17931
  * @default '{0:d} - {1:d}'
17673
17932
  */
17674
17933
  selectedShortDateFormat = '{0:d} - {1:d}';
@@ -17805,7 +18064,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
17805
18064
 
17806
18065
  const DAYS_IN_WEEK = 7;
17807
18066
  /**
17808
- * The component for rendering the **Work Week** view.
18067
+ * Represents the component that renders the **Work Week** view in the Scheduler.
18068
+ *
18069
+ * @example
18070
+ * ```html
18071
+ * <kendo-scheduler>
18072
+ * <kendo-scheduler-work-week-view></kendo-scheduler-work-week-view>
18073
+ * </kendo-scheduler>
18074
+ * ```
17809
18075
  */
17810
18076
  class WorkWeekViewComponent extends WeekViewComponent {
17811
18077
  /**
@@ -18539,7 +18805,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
18539
18805
  }] } });
18540
18806
 
18541
18807
  /**
18542
- * The component for rendering the **Month** timeline view.
18808
+ * Represents the component that renders the **Timeline Month** view in the Scheduler.
18809
+ *
18810
+ * @example
18811
+ * ```html
18812
+ * <kendo-scheduler>
18813
+ * <kendo-scheduler-timeline-month-view></kendo-scheduler-timeline-month-view>
18814
+ * </kendo-scheduler>
18815
+ * ```
18543
18816
  */
18544
18817
  class TimelineMonthViewComponent extends TimelineBase {
18545
18818
  /**
@@ -18549,10 +18822,9 @@ class TimelineMonthViewComponent extends TimelineBase {
18549
18822
  return this.localization.get('timelineMonthViewTitle');
18550
18823
  }
18551
18824
  /**
18552
- * The long-date format for displaying the
18553
- * selected date in the Scheduler toolbar.
18554
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
18555
- * > Note: If [numberOfMonths](#toc-numberofmonths) > 1, the default format value shows a range - `'{0:Y} - {1:Y}'`, where `0` is the start and `1` is the end date.
18825
+ * Sets the long-date format for the selected date in the Scheduler toolbar.
18826
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
18827
+ * If `numberOfMonths` is greater than 1, the default format displays a range: `'{0:Y} - {1:Y}'`, where `0` is the start and `1` is the end date.
18556
18828
  * @default '{0:Y}'
18557
18829
  */
18558
18830
  set selectedDateFormat(format) {
@@ -18566,10 +18838,9 @@ class TimelineMonthViewComponent extends TimelineBase {
18566
18838
  }
18567
18839
  _selectedDateFormat;
18568
18840
  /**
18569
- * The short-date format for displaying the
18570
- * selected date in the Scheduler toolbar.
18571
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
18572
- * > Note: If [numberOfMonths](#toc-numberofmonths) > 1, the default format value shows a range - `'{0:y} - {1:y}'`, where `0` is the start and `1` is the end date.
18841
+ * Sets the short-date format for the selected date in the Scheduler toolbar.
18842
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
18843
+ * If `numberOfMonths` is greater than 1, the default format displays a range: `'{0:y} - {1:y}'`, where `0` is the start and `1` is the end date.
18573
18844
  * @default '{0:y}'
18574
18845
  */
18575
18846
  set selectedShortDateFormat(format) {
@@ -18583,8 +18854,8 @@ class TimelineMonthViewComponent extends TimelineBase {
18583
18854
  }
18584
18855
  _selectedShortDateFormat;
18585
18856
  /**
18586
- * Specifies the number of months that the view will render.
18587
- * > Normalized to `1` if the provided value is <= 0.
18857
+ * Sets the number of months to render in the view.
18858
+ * If the value is less than or equal to 0, it defaults to 1.
18588
18859
  * @default 1
18589
18860
  */
18590
18861
  set numberOfMonths(months) {
@@ -18720,7 +18991,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
18720
18991
  }] } });
18721
18992
 
18722
18993
  /**
18723
- * The component for rendering the **Timeline** view.
18994
+ * Represents the component that renders the **Timeline** view in the Scheduler.
18995
+ *
18996
+ * @example
18997
+ * ```html
18998
+ * <kendo-scheduler>
18999
+ * <kendo-scheduler-timeline-view></kendo-scheduler-timeline-view>
19000
+ * </kendo-scheduler>
19001
+ * ```
18724
19002
  */
18725
19003
  class TimelineViewComponent extends TimelineBase {
18726
19004
  /**
@@ -18730,10 +19008,9 @@ class TimelineViewComponent extends TimelineBase {
18730
19008
  return this.localization.get('timelineViewTitle');
18731
19009
  }
18732
19010
  /**
18733
- * The long-date format for displaying the
18734
- * selected date in the Scheduler toolbar.
18735
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
18736
- * > Note: If [numberOfDays](#toc-numberofdays) > 1, the default format value shows a range - `'{0:D} - {1:D}'`, where `0` is the start and `1` is the end date.
19011
+ * Sets the long-date format for the selected date in the Scheduler toolbar.
19012
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
19013
+ * If `numberOfDays` is greater than 1, the default format displays a range: `'{0:D} - {1:D}'`, where `0` is the start and `1` is the end date.
18737
19014
  * @default '{0:D}'
18738
19015
  */
18739
19016
  set selectedDateFormat(format) {
@@ -18747,10 +19024,9 @@ class TimelineViewComponent extends TimelineBase {
18747
19024
  }
18748
19025
  _selectedDateFormat;
18749
19026
  /**
18750
- * The short-date format for displaying the
18751
- * selected date in the Scheduler toolbar.
18752
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
18753
- * > Note: If [numberOfDays](#toc-numberofdays) > 1, the default format value shows a range - `'{0:d} - {1:d}'`, where `0` is the start and `1` is the end date.
19027
+ * Sets the short-date format for the selected date in the Scheduler toolbar.
19028
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
19029
+ * If `numberOfDays` is greater than 1, the default format displays a range: `'{0:d} - {1:d}'`, where `0` is the start and `1` is the end date.
18754
19030
  * @default '{0:d}'
18755
19031
  */
18756
19032
  set selectedShortDateFormat(format) {
@@ -18764,8 +19040,8 @@ class TimelineViewComponent extends TimelineBase {
18764
19040
  }
18765
19041
  _selectedShortDateFormat;
18766
19042
  /**
18767
- * Specifies the number of days that the view will render.
18768
- * > Normalized to `1` if the provided value is <= 0.
19043
+ * Sets the number of days to render in the view.
19044
+ * If the value is less than or equal to 0, it defaults to 1.
18769
19045
  * @default 1
18770
19046
  */
18771
19047
  set numberOfDays(days) {
@@ -18877,7 +19153,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
18877
19153
  }] } });
18878
19154
 
18879
19155
  /**
18880
- * The component for rendering the **Week** timeline view.
19156
+ * Represents the component that renders the **Timeline Week** view in the Scheduler.
19157
+ *
19158
+ * @example
19159
+ * ```html
19160
+ * <kendo-scheduler>
19161
+ * <kendo-scheduler-timeline-week-view></kendo-scheduler-timeline-week-view>
19162
+ * </kendo-scheduler>
19163
+ * ```
18881
19164
  */
18882
19165
  class TimelineWeekViewComponent extends TimelineBase {
18883
19166
  /**
@@ -18887,27 +19170,24 @@ class TimelineWeekViewComponent extends TimelineBase {
18887
19170
  return this.localization.get('timelineWeekViewTitle');
18888
19171
  }
18889
19172
  /**
18890
- * The long-date format that will be used for displaying the
18891
- * selected date in the Scheduler toolbar.
18892
- * Defaults to `{0:D} - {1:D}`
18893
- * where `0` is the start and `1` is the end date
18894
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
19173
+ * Sets the long-date format for the selected date in the Scheduler toolbar.
19174
+ * Defaults to `'{0:D} - {1:D}'`, where `0` is the start and `1` is the end date.
19175
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
18895
19176
  * @default '{0:D} - {1:D}'
18896
19177
  */
18897
19178
  selectedDateFormat = '{0:D} - {1:D}';
18898
19179
  /**
18899
- * The short date format that will be used for displaying the
18900
- * selected date in the Scheduler toolbar.
18901
- * Defaults to `{0:d} - {1:d}`
18902
- * where `0` is the start and `1` is the end date
18903
- * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
19180
+ * Sets the short-date format for the selected date in the Scheduler toolbar.
19181
+ * Defaults to `'{0:d} - {1:d}'`, where `0` is the start and `1` is the end date.
19182
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
18904
19183
  * @default '{0:d} - {1:d}'
18905
19184
  */
18906
19185
  selectedShortDateFormat = '{0:d} - {1:d}';
18907
19186
  /**
18908
- * Specifies the number of weeks that the view will render.
18909
- * @default 1
18910
- */
19187
+ * Sets the number of weeks to render in the view.
19188
+ * If the value is less than or equal to 0, it defaults to 1.
19189
+ * @default 1
19190
+ */
18911
19191
  set numberOfWeeks(weeks) {
18912
19192
  this._numberOfWeeks = weeks > 0 ? weeks : 1;
18913
19193
  }
@@ -19503,21 +19783,26 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19503
19783
  }] } });
19504
19784
 
19505
19785
  /**
19506
- * The component for rendering the **Year** view.
19786
+ * Represents the component that renders the **Year** view in the Scheduler.
19787
+ *
19788
+ * @example
19789
+ * ```html
19790
+ * <kendo-scheduler>
19791
+ * <kendo-scheduler-year-view></kendo-scheduler-year-view>
19792
+ * </kendo-scheduler>
19793
+ * ```
19507
19794
  */
19508
19795
  class YearViewComponent extends ConfigurationViewBase {
19509
19796
  intl;
19510
19797
  /**
19511
- * The long-date format for displaying the
19512
- * selected year in the Scheduler toolbar.
19513
- * For more information, see [Parsing and Formatting Dates and Numbers]({% slug parsingandformatting_intl %}#toc-date-formatting).
19798
+ * Sets the long-date format for the selected year in the Scheduler toolbar.
19799
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
19514
19800
  * @default '{0:yyy}'
19515
19801
  */
19516
19802
  selectedDateFormat = '{0:yyy}';
19517
19803
  /**
19518
- * The short-date format for displaying the
19519
- * selected year in the Scheduler toolbar.
19520
- * For more information, see [Parsing and Formatting Dates and Numbers]({% slug parsingandformatting_intl %}#toc-date-formatting).
19804
+ * Sets the short-date format for the selected year in the Scheduler toolbar.
19805
+ * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
19521
19806
  * @default '{0:yyy}'
19522
19807
  */
19523
19808
  selectedShortDateFormat = '{0:yyy}';
@@ -20050,8 +20335,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
20050
20335
  }] } });
20051
20336
 
20052
20337
  /**
20053
- * A directive which encapsulates the editing operations when the Scheduler
20054
- * uses the [Reactive Angular Forms](link:site.data.urls.angular['reactiveforms']) ([see example](slug:editing_directives_scheduler)).
20338
+ * A directive that encapsulates editing operations for the Scheduler using [Angular Reactive Forms](link:site.data.urls.angular['reactiveforms']) ([see example](slug:editing_directives_scheduler)).
20339
+ *
20340
+ * Handles event editing, saving, and form validation logic for the Scheduler component.
20341
+ * Provides integration with custom form group creation and supports recurring event editing scenarios.
20342
+ *
20343
+ * @example
20344
+ * ```html
20345
+ * <kendo-scheduler
20346
+ * [kendoSchedulerBinding]="events"
20347
+ * [kendoSchedulerReactiveEditing]="createFormGroup">
20348
+ * </kendo-scheduler>
20349
+ * ```
20350
+ *
20351
+ * @remarks
20352
+ * Applied to: {@link SchedulerComponent}
20055
20353
  */
20056
20354
  class ReactiveEditingDirective extends EditingDirectiveBase {
20057
20355
  scheduler;
@@ -20348,14 +20646,54 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
20348
20646
  }], ctorParameters: function () { return [{ type: SchedulerComponent }, { type: DomEventsService }, { type: FocusService }, { type: i0.NgZone }, { type: i0.ChangeDetectorRef }, { type: ViewStateService }, { type: DialogsService }]; } });
20349
20647
 
20350
20648
  /**
20351
- * Utility array that contains all Scheduler PDF related components and directives
20649
+ * Utility array that contains all `@progress/kendo-angular-scheduler` PDF-related components and directives.
20650
+ *
20651
+ * Use the `KENDO_SCHEDULERPDF` array to import all PDF export features for the Scheduler.
20652
+ *
20653
+ * @example
20654
+ * ```ts
20655
+ * import { KENDO_SCHEDULER, KENDO_SCHEDULERPDF } from '@progress/kendo-angular-scheduler';
20656
+ *
20657
+ * @Component({
20658
+ * standalone: true,
20659
+ * imports: [KENDO_SCHEDULER, KENDO_SCHEDULERPDF],
20660
+ * template: `
20661
+ * <kendo-scheduler [kendoSchedulerBinding]="events">
20662
+ * <ng-template kendoSchedulerToolbarTemplate>
20663
+ * <button kendoSchedulerPDFCommand>Export PDF</button>
20664
+ * </ng-template>
20665
+ * <kendo-scheduler-day-view></kendo-scheduler-day-view>
20666
+ * <kendo-scheduler-pdf fileName="scheduler.pdf"></kendo-scheduler-pdf>
20667
+ * </kendo-scheduler>
20668
+ * `
20669
+ * })
20670
+ * export class AppComponent {}
20671
+ * ```
20352
20672
  */
20353
20673
  const KENDO_SCHEDULERPDF = [
20354
20674
  PDFComponent,
20355
20675
  PDFCommandDirective
20356
20676
  ];
20357
20677
  /**
20358
- * Utility array that contains all `@progress/kendo-angular-scheduler` related components and directives
20678
+ * Utility array that contains all `@progress/kendo-angular-scheduler`-related components and directives.
20679
+ *
20680
+ * Use the `KENDO_SCHEDULER` array to import all Scheduler features in your Angular application.
20681
+ *
20682
+ * @example
20683
+ * ```ts
20684
+ * import { KENDO_SCHEDULER } from '@progress/kendo-angular-scheduler';
20685
+ *
20686
+ * @Component({
20687
+ * standalone: true,
20688
+ * imports: [KENDO_SCHEDULER],
20689
+ * template: `
20690
+ * <kendo-scheduler [kendoSchedulerBinding]="events">
20691
+ * <kendo-scheduler-day-view></kendo-scheduler-day-view>
20692
+ * </kendo-scheduler>
20693
+ * `
20694
+ * })
20695
+ * export class AppComponent {}
20696
+ * ```
20359
20697
  */
20360
20698
  const KENDO_SCHEDULER = [
20361
20699
  SchedulerComponent,
@@ -20404,21 +20742,20 @@ const KENDO_SCHEDULER = [
20404
20742
 
20405
20743
  // IMPORTANT: NgModule export kept for backwards compatibility
20406
20744
  /**
20407
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
20408
- * definition for the Scheduler component.
20745
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) definition for the Scheduler component.
20409
20746
  *
20747
+ * @example
20410
20748
  * ```ts
20411
20749
  * import { NgModule } from '@angular/core';
20412
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
20750
+ * import { BrowserModule } from '@angular/platform-browser';
20413
20751
  * import { SchedulerModule } from '@progress/kendo-angular-scheduler';
20414
20752
  * import { AppComponent } from './app.component';
20415
20753
  *
20416
20754
  * @NgModule({
20417
- * declarations: [AppComponent],
20418
- * imports: [BrowserModule, SchedulerModule],
20419
- * bootstrap: [AppComponent]
20755
+ * declarations: [AppComponent],
20756
+ * imports: [BrowserModule, SchedulerModule],
20757
+ * bootstrap: [AppComponent]
20420
20758
  * })
20421
- *
20422
20759
  * export class AppModule {}
20423
20760
  * ```
20424
20761
  */
@@ -20533,27 +20870,24 @@ const DATE_FORMATS = [
20533
20870
  "yyyyMMdd"
20534
20871
  ];
20535
20872
  /**
20536
- * A base implementation of the [edit service]({% slug api_scheduler_editservice %}) which persists data to traditional CRUD services such as OData.
20873
+ * Represents a base implementation of the [edit service](slug:api_scheduler_editservice) that persists data to CRUD services such as OData.
20537
20874
  *
20538
- * To support custom models, the `BaseEditService` class requires a [field map]({% slug api_scheduler_schedulermodelfields %}) as a constructor parameter. Subclasses require you to
20539
- * implement the `read` operation, which is not called directly by the base class, and the `save` method which persists the created,
20540
- * updated, and deleted entities.
20875
+ * To use custom models, pass a [field map](slug:api_scheduler_schedulermodelfields) as a constructor parameter in the `BaseEditService` implementation. Subclasses must implement the `read` operation (that is not called directly by the base class) and the `save` method to persist created, updated, and deleted entities.
20541
20876
  *
20542
- * The [`events`](#toc-events) observable will publish the current data which is set upon subscription by using, for example, an [async pipe](https://angular.io/api/common/AsyncPipe)
20543
- * ([more information]({% slug editing_directives_scheduler %}#toc-custom-service)).
20877
+ * The [`events`](#toc-events) observable publishes the current data when you subscribe, for example, by using an [async pipe](https://angular.io/api/common/AsyncPipe) ([more information](slug:editing_directives_scheduler#toc-custom-service)).
20544
20878
  *
20545
- * Implementations which utilize dedicated services, such as Google Calendar and Microsoft Exchange, will typically implement the
20546
- * [`EditService`]({% slug api_scheduler_editservice %}) of the Scheduler directly.
20879
+ * Implementations that utilize dedicated services, such as Google Calendar and Microsoft Exchange, typically implement the
20880
+ * [`EditService`](slug:api_scheduler_editservice) of the Scheduler directly.
20547
20881
  *
20548
- * See example in [this article]({% slug custom_reactive_editing_scheduler %}).
20882
+ * See example in [this article](slug:custom_reactive_editing_scheduler).
20549
20883
  */
20550
20884
  class BaseEditService {
20551
20885
  /**
20552
- * The model field map that will be used during the reading and updating of data items.
20886
+ * Holds the model field map used for reading and updating data items.
20553
20887
  */
20554
20888
  fields;
20555
20889
  /**
20556
- * An observable stream with the current events.
20890
+ * Emits the current events as an observable stream.
20557
20891
  */
20558
20892
  events;
20559
20893
  /**
@@ -20840,21 +21174,20 @@ class BaseEditService {
20840
21174
 
20841
21175
  // IMPORTANT: NgModule export kept for backwards compatibility
20842
21176
  /**
20843
- * Represents the [NgModule](https://angular.io/api/core/NgModule)
20844
- * definition for the Scheduler PDF component.
21177
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) definition for the Scheduler PDF component.
20845
21178
  *
20846
- * ```ts
21179
+ * @example
21180
+ * ```typescript
20847
21181
  * import { NgModule } from '@angular/core';
20848
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
21182
+ * import { BrowserModule } from '@angular/platform-browser';
20849
21183
  * import { SchedulerModule, PDFModule } from '@progress/kendo-angular-scheduler';
20850
21184
  * import { AppComponent } from './app.component';
20851
21185
  *
20852
21186
  * @NgModule({
20853
- * declarations: [AppComponent],
20854
- * imports: [BrowserModule, SchedulerModule, PDFModule],
20855
- * bootstrap: [AppComponent]
21187
+ * declarations: [AppComponent],
21188
+ * imports: [BrowserModule, SchedulerModule, PDFModule],
21189
+ * bootstrap: [AppComponent]
20856
21190
  * })
20857
- *
20858
21191
  * export class AppModule {}
20859
21192
  * ```
20860
21193
  */