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

package/views/multi-day/week-view.component.d.ts

@@ -11,7 +11,14 @@ import { ViewStateService } from '../view-state.service';
 import { AllDaySlotTemplateDirective, AllDayEventTemplateDirective } from '../templates';
 import * as i0 from "@angular/core";
 /**
- * The component for rendering the **Week** view.
+ * Represents the component that renders the **Week** view in the Scheduler.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler>
+ *      <kendo-scheduler-week-view></kendo-scheduler-week-view>
+ * </kendo-scheduler>
+ * ```
  */
 export declare class WeekViewComponent extends MultiDayViewBase {
     protected intl: IntlService;
@@ -20,20 +27,16 @@ export declare class WeekViewComponent extends MultiDayViewBase {
      */
     get title(): string;
     /**
-     * The long-date format for displaying the
-     * selected date in the Scheduler toolbar.
-     * Defaults to `{0:D} - {1:D}`,
-     * where `0` is the start and `1` is the end date
-     * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting).
+     * Sets the long-date format for the selected date in the Scheduler toolbar.
+     * Defaults to `'{0:D} - {1:D}'`, where `0` is the start and `1` is the end date.
+     * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
      * @default '{0:D} - {1:D}'
      */
     selectedDateFormat: string;
     /**
-     * The short date format for displaying the
-     * selected date in the Scheduler toolbar.
-     * Defaults to `{0:d} - {1:d}`,
-     * where `0` is the start and `1` is the end date
-     * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting).
+     * Sets the short-date format for the selected date in the Scheduler toolbar.
+     * Defaults to `'{0:d} - {1:d}'`, where `0` is the start and `1` is the end date.
+     * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
      * @default '{0:d} - {1:d}'
      */
     selectedShortDateFormat: string;

package/views/multi-day/work-week-view.component.d.ts

@@ -10,7 +10,14 @@ import { ViewContextService } from '../view-context.service';
 import { ViewStateService } from '../view-state.service';
 import * as i0 from "@angular/core";
 /**
- * The component for rendering the **Work Week** view.
+ * Represents the component that renders the **Work Week** view in the Scheduler.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler>
+ *      <kendo-scheduler-work-week-view></kendo-scheduler-work-week-view>
+ * </kendo-scheduler>
+ * ```
  */
 export declare class WorkWeekViewComponent extends WeekViewComponent {
     /**

package/views/scheduler-view.directive.d.ts

@@ -7,16 +7,26 @@ import { SchedulerView } from '../types';
 import * as i0 from "@angular/core";
 /**
  * A directive selector for a custom Scheduler view.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler [kendoSchedulerBinding]="events">
+ *   <kendo-scheduler-day-view></kendo-scheduler-day-view>
+ *   <kendo-scheduler-week-view></kendo-scheduler-week-view>
+ *   <ng-template kendoSchedulerView="My Scheduler View">
+ *       <app-custom-view></app-custom-view>
+ *   </ng-template>
+ * </kendo-scheduler>
+ * ```
  */
 export declare class SchedulerViewDirective extends SchedulerView {
     template: TemplateRef<any>;
     /**
-     * The user-friendly name of this view.
+     * Sets the user-friendly name for this view.
      */
     title: string;
     /**
-     * The invariant name for this view. For example, `day`.
-     * If not set, the name will be the same as the title.
+     * Sets the invariant name for this view. If not set, uses the defined user-friendly name.
      */
     get name(): string;
     set name(value: string);

package/views/templates/agenda-date-template.directive.d.ts

@@ -5,12 +5,22 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template which renders the date header in the **Agenda** view.
- * To define the date template, nest an `<ng-template>` tag with the `kendoSchedulerAgendaDateTemplate`
- * directive inside the `<kendo-scheduler-agenda-view>` or `<kendo-scheduler>` components ([see example](slug:templates_scheduler#toc-agenda-dates)).
+ * Use this directive to customize the date header in the **Agenda** view of the Scheduler.
+ *
+ * To define a date template, nest an `<ng-template>` tag with the `kendoSchedulerAgendaDateTemplate` directive inside the
+ * `<kendo-scheduler-agenda-view>` or `<kendo-scheduler>` component ([see example](slug:templates_scheduler#toc-agenda-dates).
  *
  * The available fields in the template context are:
  * - `date`&mdash;The header date.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler-agenda-view>
+ *   <ng-template kendoSchedulerAgendaDateTemplate let-date="date">
+ *     <!-- custom date header -->
+ *   </ng-template>
+ * </kendo-scheduler-agenda-view>
+ * ```
  */
 export declare class AgendaDateTemplateDirective {
     templateRef: TemplateRef<any>;

package/views/templates/agenda-time-template.directive.d.ts

@@ -5,9 +5,10 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template which renders the time header in the **Agenda** view.
- * To define the time template, nest an `<ng-template>` tag with the `kendoSchedulerAgendaTimeTemplate`
- * directive inside the `<kendo-scheduler>` or in the `<kendo-scheduler-agenda-view>` component ([see example](slug:templates_scheduler#toc-agenda-times)).
+ * Use this directive to customize the time header in the **Agenda** view of the Scheduler.
+ *
+ * To define a time template, nest an `<ng-template>` tag with the `kendoSchedulerAgendaTimeTemplate` directive inside the
+ * `<kendo-scheduler>` or `<kendo-scheduler-agenda-view>` component ([see example](slug:templates_scheduler#toc-agenda-times)).
  *
  * The available fields in the template context are:
  * - `start`&mdash;The start date of the event.
@@ -16,6 +17,15 @@ import * as i0 from "@angular/core";
  * - `description`&mdash;The description of the event.
  * - `isAllDay`&mdash;A Boolean value which indicates if the event is all-day.
  * - `resources`&mdash;The resources of the event.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler-agenda-view>
+ *   <ng-template kendoSchedulerAgendaTimeTemplate let-start="start" let-end="end" let-title="title" let-description="description" let-isAllDay="isAllDay" let-resources="resources">
+ *     <!-- custom time header -->
+ *   </ng-template>
+ * </kendo-scheduler-agenda-view>
+ * ```
  */
 export declare class AgendaTimeTemplateDirective {
     templateRef: TemplateRef<any>;

package/views/templates/all-day-event-template.directive.d.ts

@@ -5,13 +5,23 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template for and assists the content customization of all-day events.
- * To define the all-day event template, nest an `<ng-template>` tag with the `kendoSchedulerAllDayEventTemplate`
- * directive inside the `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, or `<kendo-scheduler-week-view>` component ([see example](slug:templates_scheduler#toc-all-day-events)).
+ * Use this directive to customize the content of all-day events in the Scheduler.
+ *
+ * To define an all-day event template, nest an `<ng-template>` tag with the `kendoSchedulerAllDayEventTemplate` directive inside the
+ * `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, or `<kendo-scheduler-week-view>` component ([see example](slug:templates_scheduler#toc-all-day-events)).
  *
  * The available fields in the template context are:
  * - `event`&mdash;The event that is associated with the item.
  * - `resources`&mdash;The resources of the event.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler-day-view>
+ *   <ng-template kendoSchedulerAllDayEventTemplate let-event="event" let-resources="resources">
+ *     <!-- custom all-day event -->
+ *   </ng-template>
+ * </kendo-scheduler-day-view>
+ * ```
  */
 export declare class AllDayEventTemplateDirective {
     templateRef: TemplateRef<any>;

package/views/templates/all-day-slot-template.directive.d.ts

@@ -5,13 +5,23 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template for and assists the content customization of all-day slots.
- * To define the all-day slot template, nest an `<ng-template>` tag with the `kendoSchedulerAllDaySlotTemplate`
- * directive inside the `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, or `<kendo-scheduler-week-view>` component ([see example](slug:templates_scheduler#toc-all-day-slots)).
+ * Use this directive to customize the content of all-day slots in the Scheduler.
+ *
+ * To define an all-dat slot template, nest an `<ng-template>` tag with the `kendoSchedulerAllDaySlotTemplate` directive inside the
+ * `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, or `<kendo-scheduler-week-view>` components ([see example](slug:templates_scheduler#toc-all-day-slots)).
  *
  * The available fields in the template context are:
  * - `date`&mdash;The date of the slot.
  * - `resources`&mdash;The resources of the slot.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler-week-view>
+ *   <ng-template kendoSchedulerAllDaySlotTemplate let-date="date" let-resources="resources">
+ *     <!-- custom all-day slot -->
+ *   </ng-template>
+ * </kendo-scheduler-week-view>
+ * ```
  */
 export declare class AllDaySlotTemplateDirective {
     templateRef: TemplateRef<any>;

package/views/templates/date-header-template.directive.d.ts

@@ -5,13 +5,23 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template which renders the date header in the **Day**, **Week**, and **Timeline** views.
- * To define the day template, nest an `<ng-template>` tag with the `kendoSchedulerDateHeaderTemplate`
- * directive inside the `<kendo-scheduler>`, or in the `<kendo-scheduler-day-view>`, `<kendo-scheduler-week-view>`,
- * `<kendo-scheduler-timeline-view>`, `<kendo-scheduler-timeline-week-view>`, and `<kendo-scheduler-timeline-month-view>` components ([see example](slug:templates_scheduler#toc-date-headers)).
+ * Use this directive to customize the date header in **Day**, **Week**, and **Timeline** views of the Scheduler.
+ *
+ * To define a date header template, nest an `<ng-template>` tag with the `kendoSchedulerDateHeaderTemplate` directive inside the
+ * `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, `<kendo-scheduler-week-view>`,
+ * `<kendo-scheduler-timeline-view>`, `<kendo-scheduler-timeline-week-view>`, or `<kendo-scheduler-timeline-month-view>` component ([see example](slug:templates_scheduler#toc-date-headers)).
  *
  * The available fields in the template context are:
  * - `date`&mdash;The header date.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler-week-view>
+ *   <ng-template kendoSchedulerDateHeaderTemplate let-date="date">
+ *     <!-- custom date header -->
+ *   </ng-template>
+ * </kendo-scheduler-week-view>
+ * ```
  */
 export declare class DateHeaderTemplateDirective {
     templateRef: TemplateRef<any>;

package/views/templates/event-template.directive.d.ts

@@ -5,13 +5,23 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template for and assists the content customization of the Scheduler events.
- * To define the event template, nest an `<ng-template>` tag with the `kendoSchedulerEventTemplate`
- * directive inside the `<kendo-scheduler>`, or in the view components ([see example](slug:templates_scheduler#toc-event-rendering)).
+ * Use this directive to customize the rendering of Scheduler events.
+ *
+ * To define an event template, nest an `<ng-template>` tag with the `kendoSchedulerEventTemplate` directive inside the
+ * `<kendo-scheduler>` or any view component ([see example](slug:templates_scheduler#toc-event-rendering)).
  *
  * The available fields in the template context are:
  * - `event`&mdash;The event that is associated with the item.
  * - `resources`&mdash;The resources of the event.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler>
+ *   <ng-template kendoSchedulerEventTemplate let-event="event" let-resources="resources">
+ *     <!-- custom event rendering -->
+ *   </ng-template>
+ * </kendo-scheduler>
+ * ```
  */
 export declare class EventTemplateDirective {
     templateRef: TemplateRef<any>;

package/views/templates/group-header-template.directive.d.ts

@@ -5,13 +5,23 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template which renders the resource group header in the **Day**, **Week**, and **Timeline** views.
- * To define the template, nest an `<ng-template>` tag with the `kendoSchedulerGroupHeaderTemplate`
- * directive inside the `<kendo-scheduler>`, or in the `<kendo-scheduler-day-view>`, `<kendo-scheduler-week-view>`,
- * `<kendo-scheduler-timeline-view>`, `<kendo-scheduler-timeline-week-view>`, and `<kendo-scheduler-timeline-month-view>` components ([see example](slug:templates_scheduler#toc-group-headers)).
+ * Use this directive to customize the resource group header in **Day**, **Week**, and **Timeline** views of the Scheduler.
+ *
+ * To defina a group header template, nest an `<ng-template>` tag with the `kendoSchedulerGroupHeaderTemplate` directive inside the
+ * `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, `<kendo-scheduler-week-view>`,
+ * `<kendo-scheduler-timeline-view>`, `<kendo-scheduler-timeline-week-view>`, or `<kendo-scheduler-timeline-month-view>` component ([see example](slug:templates_scheduler#toc-group-headers)).
  *
  * The available fields in the template context are:
  * - `resource`&mdash;The resource item.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler-timeline-view>
+ *   <ng-template kendoSchedulerGroupHeaderTemplate let-resource="resource">
+ *     <!-- custom group header -->
+ *   </ng-template>
+ * </kendo-scheduler-timeline-view>
+ * ```
  */
 export declare class GroupHeaderTemplateDirective {
     templateRef: TemplateRef<any>;

package/views/templates/major-time-header-template.directive.d.ts

@@ -5,12 +5,22 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template for the major-time headers in the **Day** and **Week** views.
- * To define the major-time header template, nest an `<ng-template>` tag with the `kendoSchedulerMajorTimeHeaderTemplate`
- * 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)).
+ * Use this directive to customize the major-time headers in **Day** and **Week** views of the Scheduler.
+ *
+ * To define a major-time header template, nest an `<ng-template>` tag with the `kendoSchedulerMajorTimeHeaderTemplate` directive inside the
+ * `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, or `<kendo-scheduler-week-view>` component ([see example](slug:templates_scheduler#toc-major-time-headers)).
  *
  * The available fields in the template context are:
  * - `date`&mdash;The date of the header.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler-day-view>
+ *   <ng-template kendoSchedulerMajorTimeHeaderTemplate let-date="date">
+ *     <!-- custom major time header -->
+ *   </ng-template>
+ * </kendo-scheduler-day-view>
+ * ```
  */
 export declare class MajorTimeHeaderTemplateDirective {
     templateRef: TemplateRef<any>;

package/views/templates/minor-time-header-template.directive.d.ts

@@ -5,12 +5,22 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template for the minor-time headers in the **Day** and **Week** views.
- * To define the minor-time header template, nest an `<ng-template>` tag with the `kendoSchedulerMinorTimeHeaderTemplate`
- * 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)).
+ * Use this directive to customize the minor-time headers in the **Day** and **Week** views of the Scheduler.
+ *
+ * To define a minor-time header template, nest an `<ng-template>` tag with the `kendoSchedulerMinorTimeHeaderTemplate` directive inside the
+ * `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, or `<kendo-scheduler-week-view>` component ([see example](slug:templates_scheduler#toc-minor-time-headers)).
  *
  * The available fields in the template context are:
  * - `date`&mdash;The date of the header.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler-week-view>
+ *   <ng-template kendoSchedulerMinorTimeHeaderTemplate let-date="date">
+ *     <!-- custom minor time header -->
+ *   </ng-template>
+ * </kendo-scheduler-week-view>
+ * ```
  */
 export declare class MinorTimeHeaderTemplateDirective {
     templateRef: TemplateRef<any>;

package/views/templates/month-day-slot-template.directive.d.ts

@@ -5,13 +5,23 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template for rendering the day slots in the **Month** view.
- * To define the day template, nest an `<ng-template>` tag with the `kendoSchedulerMonthDaySlotTemplate`
- * directive inside the `<kendo-scheduler>`, or in the `<kendo-scheduler-month-view>` component ([see example](slug:templates_scheduler#toc-month-slots)).
+ * Use this directive to customize the day slots in the **Month** view of the Scheduler.
+ *
+ * To define a day slot template, nest an `<ng-template>` tag with the `kendoSchedulerMonthDaySlotTemplate` directive inside the
+ * `<kendo-scheduler>` or `<kendo-scheduler-month-view>` component ([see example](slug:templates_scheduler#toc-month-slots)).
  *
  * The available fields in the template context are:
  * - `date`&mdash;The date of the slot.
  * - `resources`&mdash;The resources of the slot.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler-month-view>
+ *   <ng-template kendoSchedulerMonthDaySlotTemplate let-date="date" let-resources="resources">
+ *     <!-- custom month day slot -->
+ *   </ng-template>
+ * </kendo-scheduler-month-view>
+ * ```
  */
 export declare class MonthDaySlotTemplateDirective {
     templateRef: TemplateRef<any>;

package/views/templates/multi-week-day-slot-template.directive.d.ts

@@ -5,14 +5,23 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template for rendering the day slots in the **Month** view.
- * To define the day template, nest an `<ng-template>` tag with the `kendoSchedulerMultiWeekDaySlotTemplate`
- * directive inside the `<kendo-scheduler>`, or in the `<kendo-scheduler-month-view>` component ([see example](slug:templates_scheduler#toc-multi-week-slots)).
+ * Use this directive to customize the day slots in the **Multi-Week** view of the Scheduler.
+ *
+ * To defina a day slot template, nest an `<ng-template>` tag with the `kendoSchedulerMultiWeekDaySlotTemplate` directive inside the
+ * `<kendo-scheduler>` or `<kendo-scheduler-multi-week-view>` component ([see example](slug:templates_scheduler#toc-multi-week-slots)).
  *
  * The available fields in the template context are:
  * - `date`&mdash;The date of the slot.
  * - `resources`&mdash;The resources of the slot.
  *
+ * @example
+ * ```html
+ * <kendo-scheduler-multi-week-view>
+ *   <ng-template kendoSchedulerMultiWeekDaySlotTemplate let-date="date" let-resources="resources">
+ *     <!-- custom multi-week day slot -->
+ *   </ng-template>
+ * <kendo-scheduler-multi-week-view>
+ * ```
  */
 export declare class MultiWeekDaySlotTemplateDirective {
     templateRef: TemplateRef<any>;

package/views/templates/time-slot-template.directive.d.ts

@@ -5,14 +5,24 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template for the time-slot renderer in the **Day**, **Week**, and **Timeline** views.
- * To define the time-slot template, nest an `<ng-template>` tag with the `kendoSchedulerTimeSlotTemplate`
- * directive inside the `<kendo-scheduler>`, or in the `<kendo-scheduler-day-view>`, `<kendo-scheduler-week-view>`,
- * `<kendo-scheduler-timeline-view>`, `<kendo-scheduler-timeline-week-view>`, and `<kendo-scheduler-timeline-month-view>` components ([see example](slug:templates_scheduler#toc-time-slots)).
+ * Represents the template for the time-slot renderer in the ***Day**, ***Week**, and ***Timeline** views.
+ *
+ * To define a time-slot template, nest an `<ng-template>` tag with the `kendoSchedulerTimeSlotTemplate`
+ * directive inside the `<kendo-scheduler>`, `<kendo-scheduler-day-view>`, `<kendo-scheduler-week-view>`,
+ * `<kendo-scheduler-timeline-view>`, `<kendo-scheduler-timeline-week-view>`, or `<kendo-scheduler-timeline-month-view>` component ([see example](slug:templates_scheduler#toc-time-slots)).
  *
  * The available fields in the template context are:
  * - `date`&mdash;The date of the slot.
  * - `resources`&mdash;The resources of the slot.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler-week-view>
+ *   <ng-template kendoSchedulerTimeSlotTemplate let-date="date" let-resources="resources">
+ *     <!-- custom time slot -->
+ *   </ng-template>
+ * </kendo-scheduler-week-view>
+ * ```
  */
 export declare class TimeSlotTemplateDirective {
     templateRef: TemplateRef<any>;

package/views/timeline/timeline-month-view.component.d.ts

@@ -9,7 +9,14 @@ import { ViewContextService } from '../view-context.service';
 import { ViewStateService } from '../view-state.service';
 import * as i0 from "@angular/core";
 /**
- * The component for rendering the **Month** timeline view.
+ * Represents the component that renders the **Timeline Month** view in the Scheduler.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler>
+ *      <kendo-scheduler-timeline-month-view></kendo-scheduler-timeline-month-view>
+ * </kendo-scheduler>
+ * ```
  */
 export declare class TimelineMonthViewComponent extends TimelineBase {
     /**
@@ -17,28 +24,26 @@ export declare class TimelineMonthViewComponent extends TimelineBase {
      */
     get title(): string;
     /**
-     * The long-date format for displaying the
-     * selected date in the Scheduler toolbar.
-     * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
-     * > 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.
+     * Sets the long-date format for the selected date in the Scheduler toolbar.
+     * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
+     * 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.
      * @default '{0:Y}'
      */
     set selectedDateFormat(format: string);
     get selectedDateFormat(): string;
     private _selectedDateFormat;
     /**
-     * The short-date format for displaying the
-     * selected date in the Scheduler toolbar.
-     * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
-     * > 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.
+     * Sets the short-date format for the selected date in the Scheduler toolbar.
+     * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
+     * 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.
      * @default '{0:y}'
      */
     set selectedShortDateFormat(format: string);
     get selectedShortDateFormat(): string;
     private _selectedShortDateFormat;
     /**
-     * Specifies the number of months that the view will render.
-     * > Normalized to `1` if the provided value is <= 0.
+     * Sets the number of months to render in the view.
+     * If the value is less than or equal to 0, it defaults to 1.
      * @default 1
      */
     set numberOfMonths(months: number);

package/views/timeline/timeline-view.component.d.ts

@@ -9,7 +9,14 @@ import { ViewContextService } from '../view-context.service';
 import { ViewStateService } from '../view-state.service';
 import * as i0 from "@angular/core";
 /**
- * The component for rendering the **Timeline** view.
+ * Represents the component that renders the **Timeline** view in the Scheduler.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler>
+ *      <kendo-scheduler-timeline-view></kendo-scheduler-timeline-view>
+ * </kendo-scheduler>
+ * ```
  */
 export declare class TimelineViewComponent extends TimelineBase {
     /**
@@ -17,28 +24,26 @@ export declare class TimelineViewComponent extends TimelineBase {
      */
     get title(): string;
     /**
-     * The long-date format for displaying the
-     * selected date in the Scheduler toolbar.
-     * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
-     * > 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.
+     * Sets the long-date format for the selected date in the Scheduler toolbar.
+     * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
+     * 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.
      * @default '{0:D}'
      */
     set selectedDateFormat(format: string);
     get selectedDateFormat(): string;
     private _selectedDateFormat;
     /**
-     * The short-date format for displaying the
-     * selected date in the Scheduler toolbar.
-     * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
-     * > 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.
+     * Sets the short-date format for the selected date in the Scheduler toolbar.
+     * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
+     * 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.
      * @default '{0:d}'
      */
     set selectedShortDateFormat(format: string);
     get selectedShortDateFormat(): string;
     private _selectedShortDateFormat;
     /**
-     * Specifies the number of days that the view will render.
-     * > Normalized to `1` if the provided value is <= 0.
+     * Sets the number of days to render in the view.
+     * If the value is less than or equal to 0, it defaults to 1.
      * @default 1
      */
     set numberOfDays(days: number);

package/views/timeline/timeline-week-view.component.d.ts

@@ -10,7 +10,14 @@ import { ViewContextService } from '../view-context.service';
 import { ViewStateService } from '../view-state.service';
 import * as i0 from "@angular/core";
 /**
- * The component for rendering the **Week** timeline view.
+ * Represents the component that renders the **Timeline Week** view in the Scheduler.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler>
+ *      <kendo-scheduler-timeline-week-view></kendo-scheduler-timeline-week-view>
+ * </kendo-scheduler>
+ * ```
  */
 export declare class TimelineWeekViewComponent extends TimelineBase {
     /**
@@ -18,27 +25,24 @@ export declare class TimelineWeekViewComponent extends TimelineBase {
      */
     get title(): string;
     /**
-     * The long-date format that will be used for displaying the
-     * selected date in the Scheduler toolbar.
-     * Defaults to `{0:D} - {1:D}`
-     * where `0` is the start and `1` is the end date
-     * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
+     * Sets the long-date format for the selected date in the Scheduler toolbar.
+     * Defaults to `'{0:D} - {1:D}'`, where `0` is the start and `1` is the end date.
+     * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
      * @default '{0:D} - {1:D}'
      */
     selectedDateFormat: string;
     /**
-     * The short date format that will be used for displaying the
-     * selected date in the Scheduler toolbar.
-     * Defaults to `{0:d} - {1:d}`
-     * where `0` is the start and `1` is the end date
-     * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
+     * Sets the short-date format for the selected date in the Scheduler toolbar.
+     * Defaults to `'{0:d} - {1:d}'`, where `0` is the start and `1` is the end date.
+     * For more information, see [Parsing and Formatting Dates and Numbers](slug:parsingandformatting_intl#date-formatting).
      * @default '{0:d} - {1:d}'
      */
     selectedShortDateFormat: string;
     /**
-    * Specifies the number of weeks that the view will render.
-    * @default 1
-    */
+     * Sets the number of weeks to render in the view.
+     * If the value is less than or equal to 0, it defaults to 1.
+     * @default 1
+     */
     set numberOfWeeks(weeks: number);
     get numberOfWeeks(): number;
     private _numberOfWeeks;