@progress/kendo-angular-scheduler 13.4.1-develop.3 → 13.4.1-develop.4

package/fesm2020/progress-kendo-angular-scheduler.mjs

@@ -48,8 +48,8 @@ const packageMetadata = {
     name: '@progress/kendo-angular-scheduler',
     productName: 'Kendo UI for Angular',
     productCodes: ['KENDOUIANGULAR', 'KENDOUICOMPLETE'],
-    publishDate: 1693395130,
-    version: '13.4.1-develop.3',
+    publishDate: 1694174973,
+    version: '13.4.1-develop.4',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };
 
@@ -436,29 +436,35 @@ class SchedulerView {
 /**
  * The selected edit mode during the update or removal of events.
  * For non-recurring events, set to `Event`.
- *
- * The supported values are:
- * * `Event`—Edits the selected event.
- * * `Occurrence`—Edits the selected occurrence.
- * * `Series`—Edits all events in the series.
  */
 var EditMode;
 (function (EditMode) {
+    /**
+     * Edits the selected event.
+     */
     EditMode[EditMode["Event"] = 0] = "Event";
+    /**
+     * Edits the selected occurrence.
+     */
     EditMode[EditMode["Occurrence"] = 1] = "Occurrence";
+    /**
+     * Edits all events in the series.
+     */
     EditMode[EditMode["Series"] = 2] = "Series";
 })(EditMode || (EditMode = {}));
 
 /**
  * The selected CRUD operation when the user edits or removes recurring events.
- *
- * The supported values are:
- * * `Edit`
- * * `Remove`
  */
 var CrudOperation;
 (function (CrudOperation) {
+    /**
+     * The user edits the selected recurring event.
+     */
     CrudOperation[CrudOperation["Edit"] = 0] = "Edit";
+    /**
+     * The user removes the selected recurring event.
+     */
     CrudOperation[CrudOperation["Remove"] = 1] = "Remove";
 })(CrudOperation || (CrudOperation = {}));
 
@@ -2244,14 +2250,6 @@ const iconsMap = { caretAltLeftIcon, caretAltRightIcon, calendarIcon };
  * To render the **Previous**, **Today**, **Next**, and **Date picker**
  * buttons, include the component in the
  * [toolbar template]({% slug api_scheduler_toolbartemplatedirective %}).
- *
- * {% meta height:700 %}
- * {% embed_file toolbar/template/app.component.ts preview %}
- * {% embed_file toolbar/template/my-navigation.component.ts %}
- * {% embed_file toolbar/template/app.module.ts %}
- * {% embed_file shared/events-utc.ts %}
- * {% embed_file shared/main.ts %}
- * {% endmeta %}
  */
 class ToolbarNavigationComponent {
     constructor(popupService, toolbarService, localization, cd, viewContext) {
@@ -2574,14 +2572,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
  *
  * To render the view-selection buttons, include the component in the
  * [toolbar template]({% slug api_scheduler_toolbartemplatedirective %}).
- *
- * {% meta height:700 %}
- * {% embed_file toolbar/template/app.component.ts preview %}
- * {% embed_file toolbar/template/my-navigation.component.ts %}
- * {% embed_file toolbar/template/app.module.ts %}
- * {% embed_file shared/events-utc.ts %}
- * {% embed_file shared/main.ts %}
- * {% endmeta %}
  */
 class ToolbarViewSelectorComponent {
     constructor(service, localization) {
@@ -3184,6 +3174,7 @@ class TimeZoneEditorComponent {
     constructor() {
         /**
          * Specifies the width of the ComboBox which contains the names of the timezones.
+         * @default 260
          */
         this.width = 260;
         /**
@@ -4847,6 +4838,7 @@ class RecurrenceEditorComponent {
         this.cssClass = true;
         /**
          * Specifies the id of the timezone that will be used.
+         * @default 'Etc/UTC'
          */
         this.timezone = 'Etc/UTC';
         /**
@@ -6029,22 +6021,6 @@ const todayDate = () => getDate(new Date());
 const DAYS_IN_WEEK$1 = 7;
 /**
  * Represents the [Kendo UI Scheduler component for Angular]({% slug overview_scheduler %}).
- *
- * @example
- * ```ts-preview
- * _@Component({
- *    selector: 'my-app',
- *    template: `
- *        <kendo-scheduler style="height: 600px">
- *            <kendo-scheduler-day-view>
- *            </kendo-scheduler-day-view>
- *            <kendo-scheduler-week-view>
- *            </kendo-scheduler-week-view>
- *        </kendo-scheduler>
- *    `
- * })
- * class AppComponent {}
- * ```
  */
 class SchedulerComponent {
     constructor(wrapper, viewContext, viewState, editService, dialogsService, intlService, changeDetector, zone, pdfService, localization, domEvents, renderer, focusService) {
@@ -6076,62 +6052,74 @@ class SchedulerComponent {
         this.selectable = false;
         /**
          * 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.
+         * @default 25
          */
         this.eventHeight = 25;
         /**
          * Specifies the columns width. Applicable for the **Timeline** views.
+         * @default 100
          */
         this.columnWidth = 100;
         /**
          * The start time of the view. The Scheduler displays events which start after the start time.
          * Accepts string values in the `HH:mm` format. Applicable for the **Day**, **Week**, and **Timeline** views.
+         * @default '00:00'
          */
         this.startTime = '00:00';
         /**
          * The end time of the view. The Scheduler displays events which end before the end time.
          * Accepts string values in the `HH:mm` format. Applicable for the **Day**, **Week**, and **Timeline** views.
+         * @default '00:00'
          */
         this.endTime = '00:00';
         /**
          * The start time of the view when `showWorkHours` is set to `true`.
          * Accepts string values in the `HH:mm` format. Applicable for the **Day**, **Week**, and **Timeline** views.
+         * @default '08:00'
          */
         this.workDayStart = '08:00';
         /**
          * The end time of the view when `showWorkHours` is set to `true`.
          * Accepts string values in the `HH:mm` format. Applicable for the **Day**, **Week**, and **Timeline** views.
+         * @default '17:00'
          */
         this.workDayEnd = '17:00';
         /**
          * The duration (in minutes) of the time slots. Applicable for the day, week and timeline views.
+         * @default 60
          */
         this.slotDuration = 60;
         /**
          * The number of divisions of the time slots. Applicable for the **Day**, **Week**, and **Timeline** views.
+         * @default 2
          */
         this.slotDivisions = 2;
         /**
          * A numeric value between 0 and 1 that specifies what percentage of the slot will be filled by the events.
          * Applicable for the **Day** and **Week** views.
-         * Defaults to `0.9` (90% fill).
+         * @default 0.9
          */
         this.slotFill = 0.9;
         /**
          * The time to which the view will initially be scrolled.
          * Accepts string values in the `HH:mm` format or a JavaScript `Date`. Applicable for the **Day**, **Week**, and **Timeline** views.
+         * @default '08:00'
          */
         this.scrollTime = this.workDayStart;
         /**
          * Specifies the Scheduler current time marker settings.
+         * @default true
          */
         this.currentTimeMarker = true;
         /**
          * Specifies the settings for the ongoing events highlight of the Scheduler.
+         * @default true
          */
         this.highlightOngoingEvents = true;
         /**
          * A callback that executes for each slot of the Scheduler view.
          * If it returns `true`, the `k-selected` CSS class will be added to the cell, making it visibly selected.
+         * @default () => false
          */
         this.isSlotSelected = alwaysFalse;
         /**
@@ -6279,7 +6267,7 @@ class SchedulerComponent {
     /**
      * Specifies the id of the timezone that will be displayed in the Scheduler.
      * For example, `Europe/Sofia`.
-     * Defaults to `Etc/UTC`.
+     * @default 'Etc/UTC'
      */
     set timezone(value) {
         this._timezone = value;
@@ -6607,11 +6595,6 @@ class SchedulerComponent {
      * @param y - The y document position.
      *
      * @return {SchedulerSlot} - The slot.
-     *
-     * {% embed_file drag-and-drop/app.component.ts %}
-     * {% embed_file drag-and-drop/draggable.directive.ts %}
-     * {% embed_file drag-and-drop/app.module.ts %}
-     * {% embed_file shared/main.ts %}
      */
     slotByPosition(x, y) {
         return this.viewContext.executeMethod('slotByPosition', { x, y });
@@ -6638,17 +6621,9 @@ class SchedulerComponent {
     /**
      * Focuses the next event or an event at a specified relative position.
      * The `options` parameter can be used to set a positive or negative offset
-     * that is relative to the currently focused event.
+     * that is relative to the currently focused event ([see example](slug:keyboard_navigation_scheduler#toc-event-navigation-with-the-tab-key)).
      * A `nowrap` flag toggles the wrapping to the first or to the last item.
      *
-     * @example
-     * ```ts-no-run
-     * scheduler.focusNext(); // Focuses the next event.
-     * scheduler.focusNext({ offset: 1 }); // Focuses the next event.
-     * scheduler.focusNext({ offset: -1 }); // Focuses the previous event.
-     * scheduler.focusNext({ nowrap: true }); // If the focus is on the last event, does not move the focus to the first event.
-     * ```
-     *
      * @param position The relative position of the event to focus.
      * @returns `true` if the focused event changed. Otherwise, returns `false`.
      */
@@ -6660,15 +6635,9 @@ class SchedulerComponent {
     /**
      * Focuses the previous event or an event at a specified relative position.
      * The `options` parameter can be used to set a positive or negative offset
-     * that is relative to the currently focused event.
+     * that is relative to the currently focused event ([see example](slug:keyboard_navigation_scheduler#toc-event-navigation-with-the-tab-key)).
      * A `nowrap` flag toggles the wrapping to the first or to the last item.
      *
-     * @example
-     * ```ts-no-run
-     * scheduler.focusPrev(); // Focuses the previous event
-     * scheduler.focusPrev({ nowrap: true }); // Does not move the focus to the last event, if focus is on the first one.
-     * ```
-     *
      * @param position The relative position of the event to focus.
      * @returns `true` if the focused event changed. Otherwise, returns `false`.
      */
@@ -9031,15 +9000,17 @@ class AgendaViewComponent extends ConfigurationViewBase {
          * 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)).
+         * @default '{0:d} - {1:d}'
          */
         this.selectedShortDateFormat = '{0:d} - {1:d}';
         /**
          * Specifies the number of days that the view will render.
-         * Defaults to `7`.
+         * @default 7
          */
         this.numberOfDays = 7;
         /**
          * The invariant name for this view (`agenda`).
+         * @default 'agenda'
          */
         this.name = 'agenda';
     }
@@ -11746,19 +11717,20 @@ class MonthViewComponent extends ConfigurationViewBase {
         /**
          * The long-date format for displaying the
          * selected date in the Scheduler toolbar.
-         * Defaults to `{0:Y}`
          * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
+         * @default '{0:Y}'
          */
         this.selectedDateFormat = '{0:Y}';
         /**
          * The short-date format for displaying the
          * selected date in the Scheduler toolbar.
-         * Defaults to `{0:y}`
          * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting.
+         * @default '{0:y}'
          */
         this.selectedShortDateFormat = '{0:y}';
         /**
-         * The invariant name for this view (`month`).
+         * The invariant name for this view.
+         * @default 'month'
          */
         this.name = 'month';
     }
@@ -11863,21 +11835,21 @@ class MultiWeekViewComponent extends ConfigurationViewBase {
         this.intl = intl;
         /**
          * The number of weeks to be rendered.
-         * Defaults to `6`.
+         * @default 6
          */
         this.numberOfWeeks = WEEKS_COUNT;
         /**
          * The long-date format for displaying the
          * selected date in the Scheduler toolbar.
-         * Defaults to `{0:D} - {1:D}`
          * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
+         * @default '{0:D} - {1:D}'
          */
         this.selectedDateFormat = '{0:D} - {1:D}';
         /**
          * The short-date format for displaying the
          * selected date in the Scheduler toolbar.
-         * Defaults to `{0:d} - {1:d}`
          * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting.
+         * @default '{0:d} - {1:d}'
          */
         this.selectedShortDateFormat = '{0:d} - {1:d}';
         /**
@@ -14422,7 +14394,8 @@ class DayViewComponent extends MultiDayViewBase {
     constructor(localization, changeDetector, viewContext, viewState) {
         super(localization, changeDetector, viewContext, viewState);
         /**
-         * The invariant name for this view (`day`).
+         * The invariant name for this view.
+         * @default 'day'
          */
         this.name = 'day';
         this._selectedDateFormat = '{0:D}';
@@ -14437,8 +14410,8 @@ class DayViewComponent extends MultiDayViewBase {
     /**
      * The long-date format for displaying the
      * selected date in the Scheduler toolbar.
-     * Defaults to `{0:D}`
      * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
+     * @default '{0:D}'
      */
     set selectedDateFormat(value) {
         this._selectedDateFormat = value;
@@ -14450,8 +14423,8 @@ class DayViewComponent extends MultiDayViewBase {
     /**
      * The short-date format for displaying the
      * selected date in the Scheduler toolbar.
-     * Defaults to `{0:D}`
      * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
+     * @default '{0:d}'
      */
     set selectedShortDateFormat(value) {
         this._selectedShortDateFormat = value;
@@ -14571,11 +14544,12 @@ class MultiDayViewComponent extends DayViewComponent {
         super(localization, changeDetector, viewContext, viewState);
         /**
          * Specifies the number of days that the view will render.
-         * Defaults to `1`.
+         * @default 1
          */
         this.numberOfDays = 1;
         /**
-         * The invariant name for this view (`multi-day`).
+         * The invariant name for this view.
+         * @default 'multi-day'
          */
         this.name = 'multiDay';
     }
@@ -14584,6 +14558,7 @@ class MultiDayViewComponent extends DayViewComponent {
      * selected date in the Scheduler toolbar.
      * Defaults to `{0:D} - {1:D}` for multiple days and `{0:D}` for a single day
      * ([more information](slug:parsingandformatting_intl#toc-date-formatting)).
+     * @default '{0:D} - {1:D}'
      */
     set selectedDateFormat(value) {
         this.dateFormat = value;
@@ -14596,6 +14571,7 @@ class MultiDayViewComponent extends DayViewComponent {
      * selected date in the Scheduler toolbar.
      * Defaults to `{0:d} - {1:d}` for multiple days and `{0:d}` for a single day
      * ([more information](slug:parsingandformatting_intl#toc-date-formatting)).
+     * @default '{0:d} - {1:d}'
      */
     set selectedShortDateFormat(value) {
         this.shortDateFormat = value;
@@ -14725,6 +14701,7 @@ class WeekViewComponent extends MultiDayViewBase {
          * 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).
+         * @default '{0:D} - {1:D}'
          */
         this.selectedDateFormat = '{0:D} - {1:D}';
         /**
@@ -14733,10 +14710,12 @@ class WeekViewComponent extends MultiDayViewBase {
          * 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).
+         * @default '{0:d} - {1:d}'
          */
         this.selectedShortDateFormat = '{0:d} - {1:d}';
         /**
-         * The invariant name for this view (`week`).
+         * The invariant name for this view.
+         * @default 'week'
          */
         this.name = 'week';
         this.getStartDate = this.getStartDate.bind(this);
@@ -14870,7 +14849,8 @@ class WorkWeekViewComponent extends WeekViewComponent {
     constructor(intl, localization, changeDetector, viewContext, viewState) {
         super(intl, localization, changeDetector, viewContext, viewState);
         /**
-         * The invariant name for this view (`week`).
+         * The invariant name for this view.
+         * @default 'workWeek'
          */
         this.name = 'workWeek';
         this.getNextDate = this.getNextDate.bind(this);
@@ -15580,19 +15560,20 @@ class TimelineViewComponent extends TimelineBase {
         /**
          * The long-date format for displaying the
          * selected date in the Scheduler toolbar.
-         * Defaults to `{0:D}`
          * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
+         * @default '{0:D}'
          */
         this.selectedDateFormat = '{0:D}';
         /**
          * The short-date format for displaying the
          * selected date in the Scheduler toolbar.
-         * Defaults to `{0:D}`
          * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
+         * @default '{0:d}'
          */
         this.selectedShortDateFormat = '{0:d}';
         /**
-         * The invariant name for this view (`timeline`).
+         * The invariant name for this view.
+         * @default 'timeline'
          */
         this.name = 'timeline';
     }
@@ -15697,6 +15678,7 @@ class TimelineWeekViewComponent extends TimelineBase {
          * 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)).
+         * @default '{0:D} - {1:D}'
          */
         this.selectedDateFormat = '{0:D} - {1:D}';
         /**
@@ -15705,10 +15687,12 @@ class TimelineWeekViewComponent extends TimelineBase {
          * 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)).
+         * @default '{0:d} - {1:d}'
          */
         this.selectedShortDateFormat = '{0:d} - {1:d}';
         /**
-         * The invariant name for this view (`timelineWeek`).
+         * The invariant name for this view.
+         * @default 'timelineWeek'
          */
         this.name = 'timelineWeek';
         /**
@@ -15824,19 +15808,20 @@ class TimelineMonthViewComponent extends TimelineBase {
         /**
          * The long-date format for displaying the
          * selected date in the Scheduler toolbar.
-         * Defaults to `{0:Y}`
          * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
+         * @default '{0:Y}'
          */
         this.selectedDateFormat = '{0:Y}';
         /**
          * The short-date format for displaying the
          * selected date in the Scheduler toolbar.
-         * Defaults to `{0:y}`
          * ([more information]({% slug parsingandformatting_intl %}#toc-date-formatting)).
+         * @default '{0:y}'
          */
         this.selectedShortDateFormat = '{0:y}';
         /**
-         * The invariant name for this view (`timelineMonth`).
+         * The invariant name for this view.
+         * @default 'timelineMonth'
          */
         this.name = 'timelineMonth';
         /**
@@ -17300,7 +17285,7 @@ class PDFComponent {
         this.ngZone = ngZone;
         /**
          * The creator of the PDF document.
-         * Defaults to `Kendo UI PDF Generator`.
+         * @default 'Kendo UI PDF Generator'
          */
         this.creator = 'Kendo UI PDF Generator';
         this.subscriptions = this.pdfService.elementReady.subscribe(this.createElement.bind(this));

package/localization/messages.d.ts

@@ -317,7 +317,7 @@ export declare class Messages extends ComponentMessages {
      */
     editRecurringDialogTitle: string;
     /**
-     * The value of the aria-label attribute of the <select> element used for switching the Scheduler views.
+     * The value of the aria-label attribute of the `<select>` element used for switching the Scheduler views.
      */
     selectView: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<Messages, never>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-scheduler",
-  "version": "13.4.1-develop.3",
+  "version": "13.4.1-develop.4",
   "description": "Kendo UI Scheduler Angular - Outlook or Google-style angular scheduler calendar. Full-featured and customizable embedded scheduling from the creator developers trust for professional UI components.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -25,21 +25,21 @@
     "@progress/kendo-data-query": "^1.0.0",
     "@progress/kendo-drawing": "^1.17.2",
     "@progress/kendo-licensing": "^1.0.2",
-    "@progress/kendo-angular-buttons": "13.4.1-develop.3",
-    "@progress/kendo-angular-common": "13.4.1-develop.3",
-    "@progress/kendo-angular-dateinputs": "13.4.1-develop.3",
-    "@progress/kendo-angular-dialog": "13.4.1-develop.3",
-    "@progress/kendo-angular-dropdowns": "13.4.1-develop.3",
-    "@progress/kendo-angular-icons": "13.4.1-develop.3",
-    "@progress/kendo-angular-inputs": "13.4.1-develop.3",
-    "@progress/kendo-angular-intl": "13.4.1-develop.3",
-    "@progress/kendo-angular-l10n": "13.4.1-develop.3",
-    "@progress/kendo-angular-popup": "13.4.1-develop.3",
+    "@progress/kendo-angular-buttons": "13.4.1-develop.4",
+    "@progress/kendo-angular-common": "13.4.1-develop.4",
+    "@progress/kendo-angular-dateinputs": "13.4.1-develop.4",
+    "@progress/kendo-angular-dialog": "13.4.1-develop.4",
+    "@progress/kendo-angular-dropdowns": "13.4.1-develop.4",
+    "@progress/kendo-angular-icons": "13.4.1-develop.4",
+    "@progress/kendo-angular-inputs": "13.4.1-develop.4",
+    "@progress/kendo-angular-intl": "13.4.1-develop.4",
+    "@progress/kendo-angular-l10n": "13.4.1-develop.4",
+    "@progress/kendo-angular-popup": "13.4.1-develop.4",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "13.4.1-develop.3",
+    "@progress/kendo-angular-schematics": "13.4.1-develop.4",
     "@progress/kendo-date-math": "^1.3.2",
     "@progress/kendo-draggable": "^3.0.2",
     "@progress/kendo-file-saver": "^1.0.7",

package/pdf/pdf.component.d.ts

@@ -23,7 +23,7 @@ export declare class PDFComponent implements OnDestroy {
     avoidLinks: boolean | string;
     /**
      * The creator of the PDF document.
-     * Defaults to `Kendo UI PDF Generator`.
+     * @default 'Kendo UI PDF Generator'
      */
     creator: string;
     /**
@@ -50,21 +50,13 @@ export declare class PDFComponent implements OnDestroy {
     keywords: string;
     /**
      * Specifies the margins of the page.
-     *
-     * > Numbers are treated as points (`"pt"`).
-     *
-     * The supported units are:
-     * * `"mm"`
-     * * `"cm"`
-     * * `"in"`
-     * * `"pt"` (default).
-     *
+     * @default 'pt'
      */
     margin: string | number | pdf.PageMargin;
     /**
      * A scale factor. The text size on the screen might be too big for printing.
      * To scale down the output in PDF, use this option.
-     * Defaults to `1`.
+     * @default 1
      */
     scale: number;
     /**
@@ -89,10 +81,11 @@ export declare class PDFComponent implements OnDestroy {
     proxyURL: string;
     /**
      * A name or keyword which indicates where to display the document that is
-     * returned from the proxy. Defaults to `_self`.
+     * returned from the proxy.
      *
      * To display the document in a new window or iframe, the proxy has to have the
      * `"Content-Disposition"` header set to `inline; filename="<fileName.pdf>"`.
+     * @default '_self'
      */
     proxyTarget: string;
     /**