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

package/data-binding.directive.d.ts

@@ -9,10 +9,19 @@ import { LocalDataChangesService } from './editing/local-data-changes.service';
 import { IntlService } from '@progress/kendo-angular-intl';
 import * as i0 from "@angular/core";
 /**
- * A directive that processes Scheduler events in-memory ([see example](slug:databinding_scheduler#toc-using-the-built-in-directive)).
+ * A directive that processes Scheduler events in memory ([see example](slug:databinding_scheduler#toc-using-the-built-in-directive)).
  *
- * Processing includes the expanding of recurring events and the filtering of data for
+ * Processing includes expanding of recurring events and filtering data for
  * the currently active period.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler [kendoSchedulerBinding]="data">
+ * </kendo-scheduler>
+ * ```
+ *
+ * @remarks
+ * Applied to: {@link SchedulerComponent}
  */
 export declare class DataBindingDirective implements OnInit, OnDestroy {
     protected scheduler: SchedulerComponent;
@@ -20,7 +29,7 @@ export declare class DataBindingDirective implements OnInit, OnDestroy {
     protected intl: IntlService;
     protected localDataChangesService?: LocalDataChangesService;
     /**
-     * The array of data which will populate the Scheduler.
+     * Sets the data array for the Scheduler.
      */
     set data(value: any[]);
     protected dateRange: DateRange;

package/directives.d.ts

@@ -41,10 +41,50 @@ import { MultiWeekDaySlotTemplateDirective } from './views/templates/multi-week-
 import { TimeSlotTemplateDirective } from './views/templates/time-slot-template.directive';
 import { ShortcutsDirective } from './navigation/shortcuts.directive';
 /**
- * Utility array that contains all Scheduler PDF related components and directives
+ * Utility array that contains all `@progress/kendo-angular-scheduler` PDF-related components and directives.
+ *
+ * Use the `KENDO_SCHEDULERPDF` array to import all PDF export features for the Scheduler.
+ *
+ * @example
+ * ```ts
+ * import { KENDO_SCHEDULER, KENDO_SCHEDULERPDF } from '@progress/kendo-angular-scheduler';
+ *
+ * @Component({
+ *   standalone: true,
+ *   imports: [KENDO_SCHEDULER, KENDO_SCHEDULERPDF],
+ *   template: `
+ *      <kendo-scheduler [kendoSchedulerBinding]="events">
+ *          <ng-template kendoSchedulerToolbarTemplate>
+ *              <button kendoSchedulerPDFCommand>Export PDF</button>
+ *          </ng-template>
+ *          <kendo-scheduler-day-view></kendo-scheduler-day-view>
+ *          <kendo-scheduler-pdf fileName="scheduler.pdf"></kendo-scheduler-pdf>
+ *      </kendo-scheduler>
+ *   `
+ * })
+ * export class AppComponent {}
+ * ```
  */
 export declare const KENDO_SCHEDULERPDF: readonly [typeof PDFComponent, typeof PDFCommandDirective];
 /**
- * Utility array that contains all `@progress/kendo-angular-scheduler` related components and directives
+ * Utility array that contains all `@progress/kendo-angular-scheduler`-related components and directives.
+ *
+ * Use the `KENDO_SCHEDULER` array to import all Scheduler features in your Angular application.
+ *
+ * @example
+ * ```ts
+ * import { KENDO_SCHEDULER } from '@progress/kendo-angular-scheduler';
+ *
+ * @Component({
+ *   standalone: true,
+ *   imports: [KENDO_SCHEDULER],
+ *   template: `
+ *      <kendo-scheduler [kendoSchedulerBinding]="events">
+ *          <kendo-scheduler-day-view></kendo-scheduler-day-view>
+ *      </kendo-scheduler>
+ *   `
+ * })
+ * export class AppComponent {}
+ * ```
  */
 export declare const KENDO_SCHEDULER: readonly [typeof SchedulerComponent, typeof SchedulerCustomMessagesComponent, typeof SchedulerViewDirective, typeof DataBindingDirective, typeof SlotSelectableDirective, typeof PDFComponent, typeof PDFCommandDirective, typeof ShortcutsDirective, typeof AgendaViewComponent, typeof DayViewComponent, typeof MonthViewComponent, typeof MultiDayViewComponent, typeof MultiWeekViewComponent, typeof TimelineMonthViewComponent, typeof TimelineViewComponent, typeof TimelineWeekViewComponent, typeof WeekViewComponent, typeof WorkWeekViewComponent, typeof YearViewComponent, typeof ReactiveEditingDirective, typeof RecurrenceEditorComponent, typeof TimeZoneEditorComponent, typeof ToolbarNavigationComponent, typeof ToolbarTemplateDirective, typeof ToolbarViewSelectorComponent, typeof AgendaDateTemplateDirective, typeof AgendaTimeTemplateDirective, typeof AllDayEventTemplateDirective, typeof AllDaySlotTemplateDirective, typeof DateHeaderTemplateDirective, typeof EventTemplateDirective, typeof EditDialogTemplateDirective, typeof GroupHeaderTemplateDirective, typeof MajorTimeHeaderTemplateDirective, typeof MinorTimeHeaderTemplateDirective, typeof MonthDaySlotTemplateDirective, typeof MultiWeekDaySlotTemplateDirective, typeof TimeSlotTemplateDirective];

package/editing/edit-dialog-template.directive.d.ts

@@ -5,15 +5,28 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template for the edit dialog of the Scheduler.
+ * Represents the template directive for customizing the Scheduler edit dialog.
  * To define the template, nest an `<ng-template>` tag
  * with the `kendoSchedulerEditDialogTemplate` directive inside the `<kendo-scheduler>` tag ([see example](slug:custom_reactive_editing_scheduler)).
  *
- * The template context is set to the current event and then the following additional fields are passed:
+ * The template context is set to the current event and the following additional fields are passed:
  * - `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`.
  * - `formGroup`&mdash;The current [`FormGroup`](https://angular.io/docs/ts/latest/api/forms/index/FormGroup-class.html).
  * - `editMode`&mdash;The current edit mode.
  * - `isNew`&mdash;The state of the current event.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler>
+ *  <ng-template kendoSchedulerEditDialogTemplate let-formGroup="formGroup" let-isNew="isNew"
+ *     autoFocusedElement=".title-input" let-editMode="editMode" let-event>
+ *     <div>
+ *       <label>Title:</label>
+ *       <kendo-textbox placeholder="Title" [formControl]="formGroup.get('title') />
+ *     </div>
+ *  </ng-template>
+ * </kendo-scheduler>
+ * ```
  */
 export declare class EditDialogTemplateDirective {
     templateRef: TemplateRef<any>;

package/editing/recurrence/recurrence-editor.component.d.ts

@@ -15,45 +15,64 @@ import * as i0 from "@angular/core";
  */
 export declare const RECURRENCE_VALUE_ACCESSOR: any;
 /**
- * Represents the Kendo UI Recurrence Editor component for Angular. [This example](slug:custom_reactive_editing_scheduler) demonstrates the Recurrence Editor, among other components.
+ * Represents the Kendo UI Recurrence Editor component for Angular. Use this component to let users set recurrence rules for Scheduler events.
+ *
+ * [This example](slug:custom_reactive_editing_scheduler) demonstrates the Recurrence Editor, among other components.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler
+ *   [kendoSchedulerBinding]="events"
+ *   [kendoSchedulerReactiveEditing]="createFormGroup"
+ * >
+ *   <ng-template kendoSchedulerEditDialogTemplate let-formGroup="formGroup" let-event>
+ *     <kendo-formfield>
+ *       <kendo-recurrence-editor
+ *         [start]="event.value.start"
+ *         [formControl]="formGroup.get('recurrenceRule')"
+ *       ></kendo-recurrence-editor>
+ *     </kendo-formfield>
+ *   </ng-template>
+ * </kendo-scheduler>
+ * ```
  */
 export declare class RecurrenceEditorComponent implements ControlValueAccessor, OnInit, OnDestroy {
     private recurrenceService;
     private intl;
     cssClass: boolean;
     /**
-     * Specifies the start date of the event.
+     * Sets the start date for the event.
      */
     set start(value: Date);
     get start(): Date;
     /**
-     * Specifies the id of the timezone that will be used.
+     * Sets the id of the timezone to use.
+     *
      * @default 'Etc/UTC'
      */
     timezone: string;
     /**
-     * The first day of the week. Defaults to the locale settings.
+     * Sets the first day of the week. Uses the locale settings by default.
      */
     weekStart: Day;
     /**
-     * Specifies the options of the `Repeat Every` NumericTextBox component within the recurrence `interval` editor.
+     * Sets the options for the **Repeat Every** NumericTextBox in the recurrence `interval` editor.
      */
     repeatEveryOptions: NumericTextBoxOptions;
     /**
-     * Specifies the options of the `End After` NumericTextBox component within the recurrence `count` rule editor.
+     * Sets the options for the **End After** NumericTextBox in the recurrence `count` rule editor.
      */
     endAfterOptions: NumericTextBoxOptions;
     /**
-     * Specifies the options of the `Repeat On` NumericTextBox component for choosing the day
-     * an event will occur on within the monthly and yearly sections of the recurrence editor.
+     * Sets the options for the **Repeat On** NumericTextBox for choosing the day an event occurs in the monthly and yearly sections.
      */
     repeatOnOptions: NumericTextBoxOptions;
     /**
-     * Specifies the options of the `End On` DatePicker component within the recurrence `until` rule editor.
+     * Sets the options for the **End On** DatePicker in the recurrence `until` rule editor.
      */
     endOnOptions: DatePickerOptions;
     /**
-     * Fires when the value of the component has changed.
+     * Fires when the value of the component changes.
      */
     valueChange: EventEmitter<string>;
     private _start;

package/editing/timezone-editor.component.d.ts

@@ -13,15 +13,25 @@ import * as i0 from "@angular/core";
 export declare const TIME_ZONE_VALUE_ACCESSOR: any;
 /**
  * Represents the Kendo UI TimeZone Editor component for Angular.
- * `TimeZoneEditorComponent` displays the currently loaded timezones.
- * Used for editing the `start` and `end` timezones of the `SchedulerEvent` objects.
+ *
+ * Displays a ComboBox for selecting time zone names, used for editing the `start` and `end` time zones of Scheduler events.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler>
+ *   <ng-template kendoSchedulerEditDialogTemplate>
+ *    <div> Select Time Zone:
+ *      <kendo-timezone-editor></kendo-timezone-editor>
+ *    </div>
+ *   </ng-template>
+ * </kendo-scheduler>
  */
 export declare class TimeZoneEditorComponent implements ControlValueAccessor {
     private injector;
     tzComboBox: ComboBoxComponent;
     tzComboBoxControl: ComboBoxComponent;
     /**
-     * Specifies the width of the ComboBox which contains the names of the timezones.
+     * Specifies the width of the ComboBox that contains the names of the timezones.
      * @default 260
      */
     width: number;

package/editing-directives/base-edit.service.d.ts

@@ -6,27 +6,24 @@ import { EditService } from './edit-service.interface';
 import { SchedulerModelFields } from '../types';
 import { BehaviorSubject, Observable } from 'rxjs';
 /**
- * A base implementation of the [edit service]({% slug api_scheduler_editservice %}) which persists data to traditional CRUD services such as OData.
+ * Represents a base implementation of the [edit service](slug:api_scheduler_editservice) that persists data to CRUD services such as OData.
  *
- * To support custom models, the `BaseEditService` class requires a [field map]({% slug api_scheduler_schedulermodelfields %}) as a constructor parameter. Subclasses require you to
- * implement the `read` operation, which is not called directly by the base class, and the `save` method which persists the created,
- * updated, and deleted entities.
+ * 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.
  *
- * 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)
- * ([more information]({% slug editing_directives_scheduler %}#toc-custom-service)).
+ * 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)).
  *
- * Implementations which utilize dedicated services, such as Google Calendar and Microsoft Exchange, will typically implement the
- * [`EditService`]({% slug api_scheduler_editservice %}) of the Scheduler directly.
+ * Implementations that utilize dedicated services, such as Google Calendar and Microsoft Exchange, typically implement the
+ * [`EditService`](slug:api_scheduler_editservice) of the Scheduler directly.
  *
- * See example in [this article]({% slug custom_reactive_editing_scheduler %}).
+ * See example in [this article](slug:custom_reactive_editing_scheduler).
  */
 export declare abstract class BaseEditService<TEvent> implements EditService<TEvent> {
     /**
-     * The model field map that will be used during the reading and updating of data items.
+     * Holds the model field map used for reading and updating data items.
      */
     readonly fields: SchedulerModelFields;
     /**
-     * An observable stream with the current events.
+     * Emits the current events as an observable stream.
      */
     readonly events: Observable<TEvent[]>;
     /**

package/editing-directives/edit-service.interface.d.ts

@@ -3,71 +3,69 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * A service that is used by the reactive and template editing directives of the Scheduler to persist the changes that are applied during editing.
+ * Defines the interface for a service that the reactive and template editing directives of the Scheduler use to persist changes made during editing.
  *
- * * [Custom Service]({% slug editing_directives_scheduler %}#toc-custom-service)
- * * [`BaseEditService`]({% slug api_scheduler_baseeditservice %})
+ * * [Custom Service](slug:editing_directives_scheduler#custom-service)
+ * * [`BaseEditService`](slug:api_scheduler_baseeditservice)
  */
 export interface EditService<TEvent> {
     /**
      * Creates a new event.
      *
-     * @param event - The event that will be created.
+     * @param event The event to create.
      */
     create(event: TEvent): void;
     /**
-     * Creates an exception to an existing recurring event. The `recurrenceId` field of the recurrence exception
-     * or the custom field that is set by the model map will point to the master recurring event.
+     * Creates an exception for an existing recurring event. The `recurrenceId` field of the exception or the custom field set by the model map points to the master event.
      *
-     * @param event - The instance of the occurrence that will be removed from the series.
-     * @param value - An object which contains the updated field values, for example, a form group value.
+     * @param event The occurrence to remove from the series.
+     * @param value An object with the updated field values, for example, a form group value.
      */
     createException(event: TEvent, value: any): void;
     /**
-     * Updates the specified event by copying the changed fields from the supplied `value` object.
+     * Updates the event by copying changed fields from the `value` object.
      *
-     * @param event - The event that will be updated.
-     * @param value - An object which contains the new field values, for example, a form group value.
+     * @param event The event to update.
+     * @param value An object with the new field values, for example, a form group value.
      */
     update(event: TEvent, value: any): void;
     /**
      * Removes a non-recurring event.
      *
-     * @param event - A reference to the event that will be removed.
+     * @param event The event to remove.
      */
     remove(event: TEvent): void;
     /**
-     * Removes the recurrence series and exceptions, if any.
+     * Removes the recurrence series and any exceptions.
      *
-     * @param event - Any event from the recurrence series.
+     * @param event Any event from the recurrence series.
      */
     removeSeries(event: TEvent): void;
     /**
-     * Removes a single occurrence from a series of recurring events. The `recurrenceId` field of the occurrence
-     * or the custom field which is set by a model map will point to the master recurring event.
+     * Removes a single occurrence from a recurring series. The `recurrenceId` field of the occurrence or the custom field set by a model map points to the master event.
      *
-     * @param event - A reference to the occurrence.
+     * @param event The occurrence to remove.
      */
     removeOccurrence(event: TEvent): void;
     /**
      * Returns the master recurring event for a specified recurring event.
      *
-     * @param event - An event from the recurrence series.
-     * @returns the master recurring event for the series.
+     * @param event An event from the recurrence series.
+     * @returns The master recurring event for the series.
      */
     findRecurrenceMaster(event: TEvent): TEvent;
     /**
-     * Checks if the event is part of the recurrence series.
+     * Checks if the event is part of a recurrence series.
      *
-     * @param event - The event that will be checked.
-     * @returns `true` if the event is an occurrence, an exception, or a master event. Otherwise, returns `false`.
+     * @param event The event to check.
+     * @returns `true` if the event is an occurrence, exception, or master event. Otherwise, returns `false`.
      */
     isRecurring(event: TEvent): boolean;
     /**
      * Checks if the event is a recurrence exception.
      *
-     * @param event - The event that will be checked.
-     * @returns `true` if the event is a unique event which belongs to a recurrence series. Otherwise, returns `false`.
+     * @param event The event to check.
+     * @returns `true` if the event is a unique event that belongs to a recurrence series. Otherwise, returns `false`.
      */
     isException(event: TEvent): boolean;
 }

package/editing-directives/reactive-editing.directive.d.ts

@@ -11,8 +11,21 @@ import { DialogsService } from '../editing/dialogs.service';
 import { FocusService } from "../navigation";
 import * as i0 from "@angular/core";
 /**
- * A directive which encapsulates the editing operations when the Scheduler
- * uses the [Reactive Angular Forms](link:site.data.urls.angular['reactiveforms']) ([see example](slug:editing_directives_scheduler)).
+ * 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)).
+ *
+ * Handles event editing, saving, and form validation logic for the Scheduler component.
+ * Provides integration with custom form group creation and supports recurring event editing scenarios.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler
+ *      [kendoSchedulerBinding]="events"
+ *      [kendoSchedulerReactiveEditing]="createFormGroup">
+ * </kendo-scheduler>
+ * ```
+ *
+ * @remarks
+ * Applied to: {@link SchedulerComponent}
  */
 export declare class ReactiveEditingDirective extends EditingDirectiveBase {
     protected scheduler: SchedulerComponent;

package/esm2022/data-binding.directive.mjs

@@ -56,10 +56,19 @@ const occurrences = (item, fields, range, timezone, weekStart) => {
     return [item, ...expanded];
 };
 /**
- * A directive that processes Scheduler events in-memory ([see example](slug:databinding_scheduler#toc-using-the-built-in-directive)).
+ * A directive that processes Scheduler events in memory ([see example](slug:databinding_scheduler#toc-using-the-built-in-directive)).
  *
- * Processing includes the expanding of recurring events and the filtering of data for
+ * Processing includes expanding of recurring events and filtering data for
  * the currently active period.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler [kendoSchedulerBinding]="data">
+ * </kendo-scheduler>
+ * ```
+ *
+ * @remarks
+ * Applied to: {@link SchedulerComponent}
  */
 export class DataBindingDirective {
     scheduler;
@@ -67,7 +76,7 @@ export class DataBindingDirective {
     intl;
     localDataChangesService;
     /**
-     * The array of data which will populate the Scheduler.
+     * Sets the data array for the Scheduler.
      */
     set data(value) {
         this.originalData = value || [];

package/esm2022/directives.mjs

@@ -41,14 +41,54 @@ import { MultiWeekDaySlotTemplateDirective } from './views/templates/multi-week-
 import { TimeSlotTemplateDirective } from './views/templates/time-slot-template.directive';
 import { ShortcutsDirective } from './navigation/shortcuts.directive';
 /**
- * Utility array that contains all Scheduler PDF related components and directives
+ * Utility array that contains all `@progress/kendo-angular-scheduler` PDF-related components and directives.
+ *
+ * Use the `KENDO_SCHEDULERPDF` array to import all PDF export features for the Scheduler.
+ *
+ * @example
+ * ```ts
+ * import { KENDO_SCHEDULER, KENDO_SCHEDULERPDF } from '@progress/kendo-angular-scheduler';
+ *
+ * @Component({
+ *   standalone: true,
+ *   imports: [KENDO_SCHEDULER, KENDO_SCHEDULERPDF],
+ *   template: `
+ *      <kendo-scheduler [kendoSchedulerBinding]="events">
+ *          <ng-template kendoSchedulerToolbarTemplate>
+ *              <button kendoSchedulerPDFCommand>Export PDF</button>
+ *          </ng-template>
+ *          <kendo-scheduler-day-view></kendo-scheduler-day-view>
+ *          <kendo-scheduler-pdf fileName="scheduler.pdf"></kendo-scheduler-pdf>
+ *      </kendo-scheduler>
+ *   `
+ * })
+ * export class AppComponent {}
+ * ```
  */
 export const KENDO_SCHEDULERPDF = [
     PDFComponent,
     PDFCommandDirective
 ];
 /**
- * Utility array that contains all `@progress/kendo-angular-scheduler` related components and directives
+ * Utility array that contains all `@progress/kendo-angular-scheduler`-related components and directives.
+ *
+ * Use the `KENDO_SCHEDULER` array to import all Scheduler features in your Angular application.
+ *
+ * @example
+ * ```ts
+ * import { KENDO_SCHEDULER } from '@progress/kendo-angular-scheduler';
+ *
+ * @Component({
+ *   standalone: true,
+ *   imports: [KENDO_SCHEDULER],
+ *   template: `
+ *      <kendo-scheduler [kendoSchedulerBinding]="events">
+ *          <kendo-scheduler-day-view></kendo-scheduler-day-view>
+ *      </kendo-scheduler>
+ *   `
+ * })
+ * export class AppComponent {}
+ * ```
  */
 export const KENDO_SCHEDULER = [
     SchedulerComponent,

package/esm2022/editing/edit-dialog-template.directive.mjs

@@ -5,15 +5,28 @@
 import { Directive, TemplateRef, Optional, Input } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the template for the edit dialog of the Scheduler.
+ * Represents the template directive for customizing the Scheduler edit dialog.
  * To define the template, nest an `<ng-template>` tag
  * with the `kendoSchedulerEditDialogTemplate` directive inside the `<kendo-scheduler>` tag ([see example](slug:custom_reactive_editing_scheduler)).
  *
- * The template context is set to the current event and then the following additional fields are passed:
+ * The template context is set to the current event and the following additional fields are passed:
  * - `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`.
  * - `formGroup`&mdash;The current [`FormGroup`](https://angular.io/docs/ts/latest/api/forms/index/FormGroup-class.html).
  * - `editMode`&mdash;The current edit mode.
  * - `isNew`&mdash;The state of the current event.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler>
+ *  <ng-template kendoSchedulerEditDialogTemplate let-formGroup="formGroup" let-isNew="isNew"
+ *     autoFocusedElement=".title-input" let-editMode="editMode" let-event>
+ *     <div>
+ *       <label>Title:</label>
+ *       <kendo-textbox placeholder="Title" [formControl]="formGroup.get('title') />
+ *     </div>
+ *  </ng-template>
+ * </kendo-scheduler>
+ * ```
  */
 export class EditDialogTemplateDirective {
     templateRef;

package/esm2022/editing/recurrence/recurrence-editor.component.mjs

@@ -30,14 +30,33 @@ export const RECURRENCE_VALUE_ACCESSOR = {
     useExisting: forwardRef(() => RecurrenceEditorComponent)
 };
 /**
- * Represents the Kendo UI Recurrence Editor component for Angular. [This example](slug:custom_reactive_editing_scheduler) demonstrates the Recurrence Editor, among other components.
+ * Represents the Kendo UI Recurrence Editor component for Angular. Use this component to let users set recurrence rules for Scheduler events.
+ *
+ * [This example](slug:custom_reactive_editing_scheduler) demonstrates the Recurrence Editor, among other components.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler
+ *   [kendoSchedulerBinding]="events"
+ *   [kendoSchedulerReactiveEditing]="createFormGroup"
+ * >
+ *   <ng-template kendoSchedulerEditDialogTemplate let-formGroup="formGroup" let-event>
+ *     <kendo-formfield>
+ *       <kendo-recurrence-editor
+ *         [start]="event.value.start"
+ *         [formControl]="formGroup.get('recurrenceRule')"
+ *       ></kendo-recurrence-editor>
+ *     </kendo-formfield>
+ *   </ng-template>
+ * </kendo-scheduler>
+ * ```
  */
 export class RecurrenceEditorComponent {
     recurrenceService;
     intl;
     cssClass = true;
     /**
-     * Specifies the start date of the event.
+     * Sets the start date for the event.
      */
     set start(value) {
         this._start = value;
@@ -46,33 +65,33 @@ export class RecurrenceEditorComponent {
         return isPresent(this._start) ? this._start : getDate(new Date());
     }
     /**
-     * Specifies the id of the timezone that will be used.
+     * Sets the id of the timezone to use.
+     *
      * @default 'Etc/UTC'
      */
     timezone = 'Etc/UTC';
     /**
-     * The first day of the week. Defaults to the locale settings.
+     * Sets the first day of the week. Uses the locale settings by default.
      */
     weekStart;
     /**
-     * Specifies the options of the `Repeat Every` NumericTextBox component within the recurrence `interval` editor.
+     * Sets the options for the **Repeat Every** NumericTextBox in the recurrence `interval` editor.
      */
     repeatEveryOptions;
     /**
-     * Specifies the options of the `End After` NumericTextBox component within the recurrence `count` rule editor.
+     * Sets the options for the **End After** NumericTextBox in the recurrence `count` rule editor.
      */
     endAfterOptions;
     /**
-     * Specifies the options of the `Repeat On` NumericTextBox component for choosing the day
-     * an event will occur on within the monthly and yearly sections of the recurrence editor.
+     * Sets the options for the **Repeat On** NumericTextBox for choosing the day an event occurs in the monthly and yearly sections.
      */
     repeatOnOptions;
     /**
-     * Specifies the options of the `End On` DatePicker component within the recurrence `until` rule editor.
+     * Sets the options for the **End On** DatePicker in the recurrence `until` rule editor.
      */
     endOnOptions;
     /**
-     * Fires when the value of the component has changed.
+     * Fires when the value of the component changes.
      */
     valueChange = new EventEmitter();
     _start;

package/esm2022/editing/timezone-editor.component.mjs

@@ -20,15 +20,25 @@ export const TIME_ZONE_VALUE_ACCESSOR = {
 };
 /**
  * Represents the Kendo UI TimeZone Editor component for Angular.
- * `TimeZoneEditorComponent` displays the currently loaded timezones.
- * Used for editing the `start` and `end` timezones of the `SchedulerEvent` objects.
+ *
+ * Displays a ComboBox for selecting time zone names, used for editing the `start` and `end` time zones of Scheduler events.
+ *
+ * @example
+ * ```html
+ * <kendo-scheduler>
+ *   <ng-template kendoSchedulerEditDialogTemplate>
+ *    <div> Select Time Zone:
+ *      <kendo-timezone-editor></kendo-timezone-editor>
+ *    </div>
+ *   </ng-template>
+ * </kendo-scheduler>
  */
 export class TimeZoneEditorComponent {
     injector;
     tzComboBox;
     tzComboBoxControl;
     /**
-     * Specifies the width of the ComboBox which contains the names of the timezones.
+     * Specifies the width of the ComboBox that contains the names of the timezones.
      * @default 260
      */
     width = 260;

package/esm2022/editing-directives/base-edit.service.mjs

@@ -18,27 +18,24 @@ const DATE_FORMATS = [
     "yyyyMMdd"
 ];
 /**
- * A base implementation of the [edit service]({% slug api_scheduler_editservice %}) which persists data to traditional CRUD services such as OData.
+ * Represents a base implementation of the [edit service](slug:api_scheduler_editservice) that persists data to CRUD services such as OData.
  *
- * To support custom models, the `BaseEditService` class requires a [field map]({% slug api_scheduler_schedulermodelfields %}) as a constructor parameter. Subclasses require you to
- * implement the `read` operation, which is not called directly by the base class, and the `save` method which persists the created,
- * updated, and deleted entities.
+ * 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.
  *
- * 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)
- * ([more information]({% slug editing_directives_scheduler %}#toc-custom-service)).
+ * 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)).
  *
- * Implementations which utilize dedicated services, such as Google Calendar and Microsoft Exchange, will typically implement the
- * [`EditService`]({% slug api_scheduler_editservice %}) of the Scheduler directly.
+ * Implementations that utilize dedicated services, such as Google Calendar and Microsoft Exchange, typically implement the
+ * [`EditService`](slug:api_scheduler_editservice) of the Scheduler directly.
  *
- * See example in [this article]({% slug custom_reactive_editing_scheduler %}).
+ * See example in [this article](slug:custom_reactive_editing_scheduler).
  */
 export class BaseEditService {
     /**
-     * The model field map that will be used during the reading and updating of data items.
+     * Holds the model field map used for reading and updating data items.
      */
     fields;
     /**
-     * An observable stream with the current events.
+     * Emits the current events as an observable stream.
      */
     events;
     /**