@progress/kendo-react-scheduler 12.0.1 → 12.0.2-develop.2

package/index.d.ts

@@ -342,17 +342,53 @@ export declare interface EditableProp {
  * Represents the combined object of the default and custom [modelFields]({% slug api_scheduler_schedulerprops %}#toc)
  */
 export declare interface Fields {
+    /**
+     * The field name for the unique identifier.
+     */
     id: string;
+    /**
+     * The field name for the start date and time.
+     */
     start: string;
+    /**
+     * The field name for the start timezone.
+     */
     startTimezone: string;
+    /**
+     * The field name for the original start date and time.
+     */
     originalStart: string;
+    /**
+     * The field name for the end date and time.
+     */
     end: string;
+    /**
+     * The field name for the end timezone.
+     */
     endTimezone: string;
+    /**
+     * The field name indicating if the event is an all-day event.
+     */
     isAllDay: string;
+    /**
+     * The field name for the event title.
+     */
     title: string;
+    /**
+     * The field name for the event description.
+     */
     description: string;
+    /**
+     * The field name for the recurrence rule.
+     */
     recurrenceRule: string;
+    /**
+     * The field name for the recurrence identifier.
+     */
     recurrenceId: string;
+    /**
+     * The field name for the recurrence exceptions.
+     */
     recurrenceExceptions: string;
 }
 
@@ -368,7 +404,13 @@ declare enum FORM_ITEM_ACTION {
  * Represents the Scheduler `Group` object, calculated based on the [group]({% slug api_scheduler_schedulerprops %}#toc-group) and [resources]({% slug api_scheduler_schedulerprops %}#toc-resources)
  */
 export declare interface Group {
+    /**
+     * The index of the group.
+     */
     index: number;
+    /**
+     * The array of resources that belong to this group.
+     */
     resources: SchedulerResource[];
 }
 
@@ -563,6 +605,9 @@ export declare interface MonthViewProps extends Omit<SchedulerViewProps, 'number
      * Represents component based on the DateHeaderCellProps.
      */
     dateHeaderCell?: React_2.ComponentType<DateHeaderCellProps>;
+    /**
+     * Overrides the `form` prop of the Scheduler for the specified view only.
+     */
     form?: React_2.ComponentType<SchedulerFormProps>;
 }
 
@@ -689,6 +734,9 @@ declare interface MultiDayTimelineViewProps extends SchedulerViewProps {
      * Overrides the `editSlot` prop of the Scheduler for the specified view only.
      */
     editSlot?: React_2.ComponentType<SchedulerEditSlotProps>;
+    /**
+     * Overrides the `form` prop of the Scheduler for the specified view only.
+     */
     form?: React_2.ComponentType<SchedulerFormProps>;
     /**
      * If set to `false` the "current time" marker of the scheduler would not be displayed.
@@ -823,6 +871,9 @@ declare interface MultiDayViewProps extends SchedulerViewProps {
      * Overrides the `editSlot` prop of the Scheduler for the specified view only.
      */
     editSlot?: React_2.ComponentType<SchedulerEditSlotProps>;
+    /**
+     * Overrides the `form` prop of the Scheduler for the specified view only.
+     */
     form?: React_2.ComponentType<SchedulerFormProps>;
     /**
      * If set to `false` the "current time" marker of the scheduler would not be displayed.
@@ -1049,13 +1100,22 @@ export declare const SchedulerActiveViewContext: React_2.Context<SchedulerActive
 export declare type SchedulerActiveViewContextType = [string, (activeView: string, event?: any) => void];
 
 /**
- * Called every time the user changes the provided `data`.
+ * Fires every time the user changes the provided `data`.
  *
  * For more information, refer to the [Scheduler Data Binding]({% slug data_binding_scheduler %}) article.
  */
 export declare interface SchedulerDataChangeEvent {
+    /**
+     * Contains the newly created data items.
+     */
     created: DataItem[];
+    /**
+     * Contains the updated data items.
+     */
     updated: DataItem[];
+    /**
+     * Contains the deleted data items.
+     */
     deleted: DataItem[];
 }
 
@@ -1072,12 +1132,15 @@ export declare const SchedulerDataContext: React_2.Context<SchedulerDataContextT
 export declare type SchedulerDataContextType = [DataItem[], (action: DataAction, event?: any) => void];
 
 /**
- * Called every time the user changes the selected `date`.
+ * Fires every time the user changes the selected `date`.
  * The value is a JavaScript `Date` object.
  * For more information, refer to the article on
  * [date selection]({% slug date_selection_scheduler %}).
  */
 export declare interface SchedulerDateChangeEvent {
+    /**
+     * The new date value selected by the user.
+     */
     value: Date;
 }
 
@@ -1318,7 +1381,13 @@ DataItem | null,
  * For more information about Refs, refer to the [React Refs & Dom](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) article.
  */
 export declare interface SchedulerEditItemHandle {
+    /**
+     * The HTML element of the SchedulerEditItem component.
+     */
     element: HTMLDivElement | null;
+    /**
+     * The props of the SchedulerEditItem component.
+     */
     props: SchedulerEditItemProps;
 }
 
@@ -1363,7 +1432,7 @@ export declare interface SchedulerEditItemProps extends SchedulerViewItemProps {
      */
     occurrenceDialog?: React_2.ComponentType<SchedulerOccurrenceDialogProps>;
     /**
-     * Called when the item has been removed or manipulated though dragging, resizing or an external form.
+     * Fires when the item has been removed or manipulated through dragging, resizing, or an external form.
      */
     onDataAction?: (action: DataAction, event?: any) => void;
     /**
@@ -1371,7 +1440,7 @@ export declare interface SchedulerEditItemProps extends SchedulerViewItemProps {
      */
     formItem?: DataItem | null;
     /**
-     * Called every time the `formItem` changes.
+     * Fires every time the `formItem` changes.
      */
     onFormItemChange?: (event: SchedulerEditItemStateChangeEvent<DataItem | null>) => void;
     /**
@@ -1379,7 +1448,7 @@ export declare interface SchedulerEditItemProps extends SchedulerViewItemProps {
      */
     dragItem?: DataItem | null;
     /**
-     * Called every time the `dragItem` changes.
+     * Fires every time the `dragItem` changes.
      */
     onDragItemChange?: (event: SchedulerEditItemStateChangeEvent<DataItem | null>) => void;
     /**
@@ -1387,7 +1456,7 @@ export declare interface SchedulerEditItemProps extends SchedulerViewItemProps {
      */
     resizeItem?: DataItem | null;
     /**
-     * Called every time the `resize` changes.
+     * Fires every time the `resizeItem` changes.
      */
     onResizeItemChange?: (event: SchedulerEditItemStateChangeEvent<DataItem | null>) => void;
     /**
@@ -1398,7 +1467,7 @@ export declare interface SchedulerEditItemProps extends SchedulerViewItemProps {
      */
     removeItem?: DataItem | null;
     /**
-     * Called every time the `removeItem` changes.
+     * Fires every time the `removeItem` changes.
      */
     onRemoveItemChange?: (event: SchedulerEditItemStateChangeEvent<DataItem | null>) => void;
     /**
@@ -1406,7 +1475,7 @@ export declare interface SchedulerEditItemProps extends SchedulerViewItemProps {
      */
     showOccurrenceDialog?: boolean;
     /**
-     * Called every time the `showOccurrenceDialog` changes.
+     * Fires every time the `showOccurrenceDialog` changes.
      */
     onShowOccurrenceDialogChange?: (event: SchedulerEditItemStateChangeEvent<boolean>) => void;
     /**
@@ -1414,7 +1483,7 @@ export declare interface SchedulerEditItemProps extends SchedulerViewItemProps {
      */
     showRemoveDialog?: boolean;
     /**
-     * Called every time the `showRemoveDialog` changes.
+     * Fires every time the `showRemoveDialog` changes.
      */
     onShowRemoveDialogChange?: (event: SchedulerEditItemStateChangeEvent<boolean>) => void;
     /**
@@ -1427,11 +1496,11 @@ export declare interface SchedulerEditItemProps extends SchedulerViewItemProps {
      */
     series?: boolean | null;
     /**
-     * Called every time the `series` changes.
+     * Fires every time the `series` changes.
      */
     onSeriesChange?: (event: SchedulerEditItemStateChangeEvent<boolean | null>) => void;
     /**
-     * Called whenever the `occurence` option is selected from the `OccurrenceDialog`.
+     * Fires whenever you select the `occurrence` option from the `OccurrenceDialog`.
      */
     onOccurrenceClick?: (event: SchedulerOccurrenceDialogStateChangeEvent<any>) => void;
     /**
@@ -1441,7 +1510,7 @@ export declare interface SchedulerEditItemProps extends SchedulerViewItemProps {
      */
     onOccurrenceClickAction?: (event: SchedulerOccurrenceDialogStateChangeEvent<any>, props: SchedulerEditItemProps, state: SchedulerEditItemState) => SchedulerEditItemAction | SchedulerEditItemAction[];
     /**
-     * Called whenever the `series` option is selected from the `OccurrenceDialog`.
+     * Fires whenever you select the `series` option from the `OccurrenceDialog`.
      */
     onSeriesClick?: (event: SchedulerOccurrenceDialogStateChangeEvent<any>) => void;
     /**
@@ -1451,7 +1520,7 @@ export declare interface SchedulerEditItemProps extends SchedulerViewItemProps {
      */
     onSeriesClickAction?: (event: SchedulerOccurrenceDialogStateChangeEvent<any>, props: SchedulerEditItemProps, state: SchedulerEditItemState) => SchedulerEditItemAction | SchedulerEditItemAction[];
     /**
-     * Called whenever the `confirm` option is selected from the `RemoveDialog`.
+     * Fires whenever you select the `confirm` option from the `RemoveDialog`.
      */
     onRemoveConfirm?: (event: SchedulerRemoveDialogStateChangeEvent<any>) => void;
     /**
@@ -1461,7 +1530,7 @@ export declare interface SchedulerEditItemProps extends SchedulerViewItemProps {
      */
     onRemoveConfirmAction?: (event: SchedulerRemoveDialogStateChangeEvent<any>, props: SchedulerEditItemProps, state: SchedulerEditItemState) => SchedulerEditItemAction | SchedulerEditItemAction[];
     /**
-     * Called whenever the `form` is submitted.
+     * Fires whenever you submit the `form`.
      */
     onFormSubmit?: (event: SchedulerFormStateChangeEvent<DataItem | null>) => void;
     /**
@@ -1471,7 +1540,7 @@ export declare interface SchedulerEditItemProps extends SchedulerViewItemProps {
      */
     onFormSubmitAction?: (event: SchedulerFormStateChangeEvent<DataItem | null>, props: SchedulerEditItemProps, state: SchedulerEditItemState) => SchedulerEditItemAction | SchedulerEditItemAction[];
     /**
-     * Called whenever the current edit is canceled.
+     * Fires whenever you cancel the current edit.
      */
     onCancel?: (event: SchedulerFormStateChangeEvent<null> | SchedulerOccurrenceDialogStateChangeEvent<null>) => void;
     /**
@@ -1674,17 +1743,44 @@ boolean,
  * Represents the internal `state` of the `SchedulerEditItem`.
  */
 export declare interface SchedulerEditItemState {
+    /**
+     * Whether the item is currently selected.
+     */
     selected: boolean;
+    /**
+     * Whether the action applies to a series or single occurrence.
+     */
     series: boolean | null;
+    /**
+     * The data item being edited in the form.
+     */
     formItem: DataItem | null;
+    /**
+     * The data item being dragged.
+     */
     dragItem: DataItem | null;
+    /**
+     * The data item being resized.
+     */
     resizeItem: DataItem | null;
+    /**
+     * The data item scheduled for removal.
+     */
     removeItem: DataItem | null;
+    /**
+     * The data item for which the remove dialog is shown.
+     */
     showRemoveDialog: DataItem | null;
+    /**
+     * The data item for which the occurrence dialog is shown.
+     */
     showOccurrenceDialog: DataItem | null;
 }
 
 export declare interface SchedulerEditItemStateChangeEvent<T> {
+    /**
+     * The value associated with the state change event.
+     */
     value: T;
 }
 
@@ -1718,6 +1814,9 @@ export declare type SchedulerEditSlotFormItemContextType = [DataItem | null, (ev
  * For more information about Refs, refer to the [React Refs & Dom](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) article.
  */
 export declare interface SchedulerEditSlotHandle {
+    /**
+     * The props of the SchedulerEditSlot component.
+     */
     props: SchedulerEditSlotProps;
 }
 
@@ -1742,11 +1841,11 @@ export declare interface SchedulerEditSlotProps extends SchedulerViewSlotProps {
      */
     formItem?: DataItem | null;
     /**
-     * Called every time the `formItem` changes.
+     * Fires every time the `formItem` changes.
      */
     onFormItemChange?: (event: any) => void;
     /**
-     * Called when new item has been created in the slot.
+     * Fires when a new item has been created in the slot.
      */
     onDataAction?: (action: DataAction, event: any) => void;
 }
@@ -1782,7 +1881,13 @@ export declare const schedulerEditTaskDefaultProps: {
  * For more information about Refs, refer to the [React Refs & Dom](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) article.
  */
 export declare interface SchedulerEditTaskHandle {
+    /**
+     * The HTML element of the SchedulerEditTask component.
+     */
     element: HTMLDivElement | null;
+    /**
+     * The props of the SchedulerEditTask component.
+     */
     props: SchedulerEditTaskProps;
 }
 
@@ -1807,7 +1912,7 @@ export declare interface SchedulerEditTaskProps extends SchedulerViewTaskProps {
      */
     showRemoveDialog?: boolean;
     /**
-     * Called every time the `showRemoveDialog` changes.
+     * Fires every time the `showRemoveDialog` changes.
      */
     onShowRemoveDialogChange?: (event: any) => void;
     /**
@@ -1818,7 +1923,7 @@ export declare interface SchedulerEditTaskProps extends SchedulerViewTaskProps {
      */
     removeItem?: DataItem | null;
     /**
-     * Called every time the `removeItem` changes.
+     * Fires every time the `removeItem` changes.
      */
     onRemoveItemChange?: (event: any) => void;
     /**
@@ -1832,11 +1937,11 @@ export declare interface SchedulerEditTaskProps extends SchedulerViewTaskProps {
      */
     showOccurrenceDialog?: boolean;
     /**
-     * Called every time the `showOccurrenceDialog` changes.
+     * Fires every time the `showOccurrenceDialog` changes.
      */
     onShowOccurrenceDialogChange?: (event: any) => void;
     /**
-     * Called when the item has been removed.
+     * Fires when the item has been removed.
      */
     onDataAction?: (action: DataAction, event?: any) => void;
 }
@@ -1864,7 +1969,13 @@ export declare const SchedulerFooter: React_2.ForwardRefExoticComponent<Schedule
  * For more information about Refs, refer to the [React Refs & Dom](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) article.
  */
 export declare interface SchedulerFooterHandle {
+    /**
+     * The HTML element of the SchedulerFooter component.
+     */
     element: HTMLDivElement | null;
+    /**
+     * The props of the SchedulerFooter component.
+     */
     props: SchedulerFooterProps;
 }
 
@@ -1872,6 +1983,9 @@ export declare interface SchedulerFooterHandle {
  * Represents the props of the KendoReact [SchedulerFooter]({% slug api_scheduler_schedulerfooter %}) component.
  */
 export declare interface SchedulerFooterProps extends ToolbarProps {
+    /**
+     * The content of the footer component.
+     */
     children?: React_2.ReactNode;
 }
 
@@ -2139,7 +2253,13 @@ export declare const schedulerFormEditorDefaultProps: {
  * Represents the `ref` of the SchedulerFormEditor component.
  */
 export declare interface SchedulerFormEditorHandle {
+    /**
+     * The HTML element of the SchedulerFormEditor component.
+     */
     element: any;
+    /**
+     * The props of the SchedulerFormEditor component.
+     */
     props: SchedulerFormEditorProps;
 }
 
@@ -2382,15 +2502,15 @@ export declare interface SchedulerFormProps extends Omit_2<FormProps, 'render' |
      */
     render?: (props: FormRenderProps) => any;
     /**
-     * Called when the `cancel` button is clicked.
+     * Fires when you click the `cancel` button.
      */
     onCancel?: (event: SchedulerFormStateChangeEvent<null>) => void;
     /**
-     * Called when the `close` button is clicked.
+     * Fires when you click the `close` button.
      */
     onClose?: (event: SchedulerFormStateChangeEvent<null>) => void;
     /**
-     * Called when the `submit` button is clicked.
+     * Fires when you click the `submit` button.
      */
     onSubmit: (event: SchedulerFormStateChangeEvent<any>) => void;
     /**
@@ -2410,8 +2530,17 @@ export declare interface SchedulerFormProps extends Omit_2<FormProps, 'render' |
 }
 
 export declare interface SchedulerFormStateChangeEvent<T> {
+    /**
+     * The SchedulerForm instance that triggered the event.
+     */
     target: SchedulerFormHandle;
+    /**
+     * The value associated with the event.
+     */
     value: T;
+    /**
+     * The React synthetic event object.
+     */
     syntheticEvent: React_2.SyntheticEvent;
 }
 
@@ -2445,7 +2574,13 @@ export declare type SchedulerGroupsContextType = Group[];
  * Represents the Object which is passed to the [`ref`](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) callback of the Scheduler component.
  */
 export declare interface SchedulerHandle {
+    /**
+     * The props of the Scheduler component.
+     */
     props: SchedulerProps;
+    /**
+     * The HTML element of the Scheduler component.
+     */
     element: HTMLDivElement | null;
 }
 
@@ -2460,11 +2595,20 @@ export declare const SchedulerHeader: React_2.ForwardRefExoticComponent<Schedule
  * For more information about Refs, refer to the [React Refs & Dom](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) article.
  */
 export declare interface SchedulerHeaderHandle {
+    /**
+     * The HTML element of the SchedulerHeader component.
+     */
     element: HTMLDivElement | null;
+    /**
+     * The props of the SchedulerHeader component.
+     */
     props: SchedulerHeaderProps;
 }
 
 export declare interface SchedulerHeaderProps extends ToolbarProps {
+    /**
+     * The content of the header component.
+     */
     children?: React_2.ReactNode;
 }
 
@@ -2497,7 +2641,13 @@ export declare interface SchedulerItemDragEvent {
  * Represents the object passed to the `drag-item` reducer.
  */
 export declare interface SchedulerItemDragItemAction {
+    /**
+     * The type of drag action to perform.
+     */
     type: DRAG_ITEM_ACTION;
+    /**
+     * The data item payload for the drag action.
+     */
     payload?: DataItem;
 }
 
@@ -2521,7 +2671,13 @@ declare type SchedulerItemFormItemAction = {
  * For more information about Refs, refer to the [React Refs & Dom](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) article.
  */
 export declare interface SchedulerItemHandle {
+    /**
+     * The HTML element of the SchedulerItem component.
+     */
     element: HTMLDivElement | null;
+    /**
+     * The props of the SchedulerItem component.
+     */
     props: SchedulerItemProps;
     /** @hidden */
     _maxSiblingsPerSlot?: number | null;
@@ -2558,7 +2714,7 @@ export declare interface SchedulerItemProps extends Item {
     /**
      * Specifies the `tabIndex` attribute of the wrapping element of the SchedulerItem.
      *
-     * Providing `null` will not apply any `tabIndex` to the element.
+     * Providing `null` does not apply any `tabIndex` to the element.
      */
     tabIndex?: number | null;
     /**
@@ -2588,7 +2744,7 @@ export declare interface SchedulerItemProps extends Item {
     /**
      * Specifies the `children` of the SchedulerItem.
      *
-     * Setting this property will override the default elements rendered by the SchedulerItem.
+     * Setting this property overrides the default elements rendered by the SchedulerItem.
      */
     children?: React_2.ReactNode;
     /**
@@ -2596,7 +2752,7 @@ export declare interface SchedulerItemProps extends Item {
      */
     editable?: EditableProp | boolean;
     /**
-     * Sets the selected state of the SchedulerSlot. By default the `k-selected` className is added if `props.selected` is `true`.
+     * Sets the selected state of the SchedulerItem. By default, the `k-selected` className is added if `props.selected` is `true`.
      */
     selected?: boolean;
     /**
@@ -2622,110 +2778,110 @@ export declare interface SchedulerItemProps extends Item {
      */
     format?: string;
     /**
-     * Called each time the element, or any of its child elements, receive focus.
+     * Fires each time the element, or any of its child elements, receive focus.
      */
     onFocus?: (event: SchedulerItemFocusEvent) => void;
     /**
-     * Called each time the element, or any of its child elements, lose focus.
+     * Fires each time the element, or any of its child elements, lose focus.
      */
     onBlur?: (event: SchedulerItemFocusEvent) => void;
     /**
-     * Called each time the element, or any of its child elements resceives `mousedown` event.
+     * Fires each time the element, or any of its child elements, receives a `mousedown` event.
      */
     onMouseDown?: (event: SchedulerItemMouseEvent) => void;
     /**
-     * Called each time the element, or any of its child elements resceives `mouseup` event.
+     * Fires each time the element, or any of its child elements, receives a `mouseup` event.
      */
     onMouseUp?: (event: SchedulerItemMouseEvent) => void;
     /**
-     * Called each time the element, or any of its child elements, is clicked.
+     * Fires each time the element, or any of its child elements, is clicked.
      */
     onClick?: (event: SchedulerItemMouseEvent) => void;
     /**
-     * Called each time the element, or any of its child elements receives `mouseenter` event.
+     * Fires each time the element, or any of its child elements, receives a `mouseenter` event.
      */
     onMouseEnter?: (event: SchedulerItemMouseEvent) => void;
     /**
-     * Called each time the element, or any of its child elements receives `mouseleave` event.
+     * Fires each time the element, or any of its child elements, receives a `mouseleave` event.
      */
     onMouseLeave?: (event: SchedulerItemMouseEvent) => void;
     /**
-     * Called each time the element, or any of its child elements receives `mouseover` event.
+     * Fires each time the element, or any of its child elements, receives a `mouseover` event.
      */
     onMouseOver?: (event: SchedulerItemMouseEvent) => void;
     /**
-     * Called each time the element, or any of its child elements receives `mouseout` event.
+     * Fires each time the element, or any of its child elements, receives a `mouseout` event.
      */
     onMouseOut?: (event: SchedulerItemMouseEvent) => void;
     /**
-     * Called each time the element, or any of its child elements, is double-clicked.
+     * Fires each time the element, or any of its child elements, is double-clicked.
      */
     onDoubleClick?: (event: SchedulerItemMouseEvent) => void;
     /**
-     * Called when the `delete` icon is clicked.
+     * Fires when you click the `delete` icon.
      *
-     * The `delete` icon is rendered only when `props.editable` or `props.editable.remove` is `true`
+     * The `delete` icon renders only when `props.editable` or `props.editable.remove` is `true`.
      */
     onRemoveClick?: (event: SchedulerItemMouseEvent) => void;
     /**
-     * Called each time a `keydown` event propagates to the wrapping element.
+     * Fires each time a `keydown` event propagates to the wrapping element.
      */
     onKeyDown?: (event: SchedulerItemKeyboardEvent) => void;
     /**
-     * Called each time a `keypress` event propagates to the wrapping element.
+     * Fires each time a `keypress` event propagates to the wrapping element.
      */
     onKeyPress?: (event: SchedulerItemKeyboardEvent) => void;
     /**
-     * Called each time a `keyup` event propagates to the wrapping element.
+     * Fires each time a `keyup` event propagates to the wrapping element.
      */
     onKeyUp?: (event: SchedulerItemKeyboardEvent) => void;
     /**
-     * Called each time the element receives a `press` event.
+     * Fires each time the element receives a `press` event.
      *
      * This event is used by the [`Drag & Drop`]({% slug editing_scheduler %}) functionality of the SchedulerItem.
-     * The SchedulerItem is using the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDragStart` callback.
+     * The SchedulerItem uses the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDragStart` callback.
      */
     onPress?: (event: SchedulerItemDragEvent) => void;
     /**
-     * Called each time the element is dragged.
+     * Fires each time the element is dragged.
      *
      * This event is used by the [`Drag & Drop`]({% slug editing_scheduler %}) functionality of the SchedulerItem.
-     * The SchedulerItem is using the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDrag` callback.
+     * The SchedulerItem uses the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDrag` callback.
      */
     onDrag?: (event: SchedulerItemDragEvent) => void;
     /**
-     * Called when the dragged element is being `released`.
+     * Fires when you release the dragged element.
      *
      * This event is used by the [`Drag & Drop`]({% slug editing_scheduler %}) functionality of the SchedulerItem.
-     * The SchedulerItem is using the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDragEnd` callback.
+     * The SchedulerItem uses the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDragEnd` callback.
      */
     onRelease?: (event: SchedulerItemDragEvent) => void;
     /**
-     * Called each time the any of the resize handlers receives a `press` event.
+     * Fires each time any of the resize handlers receives a `press` event.
      *
      * This event is used by the [`Resize`]({% slug editing_scheduler %}) functionality of the SchedulerItem.
-     * The SchedulerItem is using the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDragStart` callback.
+     * The SchedulerItem uses the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDragStart` callback.
      */
     onResizePress?: (event: SchedulerItemDragEvent) => void;
     /**
-     * Called each time the the resize handler responsible for the item `start` is being dragged.
+     * Fires each time the resize handler responsible for the item `start` is being dragged.
      *
      * This event is used by the [`Resize`]({% slug editing_scheduler %}) functionality of the SchedulerItem.
-     * The SchedulerItem is using the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDrag` callback.
+     * The SchedulerItem uses the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDrag` callback.
      */
     onResizeStartDrag?: (event: SchedulerItemDragEvent) => void;
     /**
-     * Called each time the the resize handler responsible for the item `end` is being dragged.
+     * Fires each time the resize handler responsible for the item `end` is being dragged.
      *
      * This event is used by the [`Resize`]({% slug editing_scheduler %}) functionality of the SchedulerItem.
-     * The SchedulerItem is using the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDrag` callback.
+     * The SchedulerItem uses the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDrag` callback.
      */
     onResizeEndDrag?: (event: SchedulerItemDragEvent) => void;
     /**
-     * Called when the dragged resize handler is being `released`
+     * Fires when you release the dragged resize handler.
      *
      * This event is used by the [`Resize`]({% slug editing_scheduler %}) functionality of the SchedulerItem.
-     * The SchedulerItem is using the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDragEnd` callback.
+     * The SchedulerItem uses the [KendoReactDraggable]({% slug draggable_drag-and-drop %}) instead of the `onDragEnd` callback.
      */
     onResizeRelease?: (event: SchedulerItemDragEvent) => void;
     /** @hidden */
@@ -2748,8 +2904,17 @@ export declare type SchedulerItemRemoveItemAction = {
  * Represents the object passed to the `resize-item` reducer.
  */
 export declare interface SchedulerItemResizeItemAction {
+    /**
+     * The type of resize action to perform.
+     */
     type: RESIZE_ITEM_ACTION;
+    /**
+     * The data item payload for the resize action.
+     */
     payload?: DataItem;
+    /**
+     * The event associated with the resize action.
+     */
     event?: any;
 }
 
@@ -2765,8 +2930,17 @@ export declare type SchedulerItemSeriesAction = {
  * Represents the object passed to the `items-focus` reducer.
  */
 export declare interface SchedulerItemsFocusAction {
+    /**
+     * The type of focus action to perform on the item.
+     */
     type: ITEMS_FOCUS_ACTION;
+    /**
+     * The reference to the scheduler item handle.
+     */
     item?: React_2.RefObject<SchedulerItemHandle | null>;
+    /**
+     * Whether to ignore the isAllDay property when performing the action.
+     */
     ignoreIsAllDay?: boolean;
 }
 
@@ -2790,8 +2964,17 @@ export declare type SchedulerItemShowRemoveDialogAction = {
  * Represents the object passed to the `items-select` reducer.
  */
 export declare interface SchedulerItemsSelectAction {
+    /**
+     * The type of action to perform on item selection.
+     */
     type: ITEMS_SELECT_ACTION;
+    /**
+     * The reference to the scheduler item handle.
+     */
     item?: React_2.RefObject<SchedulerItemHandle | null>;
+    /**
+     * Whether to ignore the isAllDay property when performing the action.
+     */
     ignoreIsAllDay?: boolean;
 }
 
@@ -2883,22 +3066,31 @@ export declare interface SchedulerOccurrenceDialogProps {
      */
     isRemove?: boolean;
     /**
-     * Called when the `close` button is clicked.
+     * Fires when you click the `close` button.
      */
     onClose: (event: SchedulerOccurrenceDialogStateChangeEvent<DataItem | null>) => void;
     /**
-     * Called when the `series` button is clicked.
+     * Fires when you click the `series` button.
      */
     onSeriesClick: (event: SchedulerOccurrenceDialogStateChangeEvent<DataItem | null>) => void;
     /**
-     * Called when the `occurrence` button is clicked.
+     * Fires when you click the `occurrence` button.
      */
     onOccurrenceClick: (event: SchedulerOccurrenceDialogStateChangeEvent<DataItem | null>) => void;
 }
 
 export declare interface SchedulerOccurrenceDialogStateChangeEvent<T> {
+    /**
+     * The SchedulerOccurrenceDialog instance that triggered the event.
+     */
     target: SchedulerOccurrenceDialogHandle;
+    /**
+     * The value associated with the event.
+     */
     value: T;
+    /**
+     * The React synthetic event object.
+     */
     syntheticEvent: React_2.SyntheticEvent;
 }
 
@@ -2941,6 +3133,8 @@ export declare interface SchedulerProps {
     /**
      * Specifies the `tabIndex` attribute of the wrapping element of the Scheduler.
      *
+     * @default -1
+     *
      * @example
      * ```jsx
      * <Scheduler tabIndex={0} />
@@ -2999,7 +3193,7 @@ export declare interface SchedulerProps {
      */
     className?: string;
     /**
-     * Overrides the default item. Specifying the `item` property of a specific view will override this property.
+     * Overrides the default item. If you specify the `item` property of a specific view, it overrides this property.
      *
      * The default component is: [SchedulerItem]({% slug api_scheduler_scheduleritem %}).
      *
@@ -3013,7 +3207,7 @@ export declare interface SchedulerProps {
      */
     item?: React_2.ComponentType<SchedulerItemProps>;
     /**
-     * Overrides the default viewItem. Specifying the `viewItem` property of a specific view will override this property.
+     * Overrides the default viewItem. If you specify the `viewItem` property of a specific view, it overrides this property.
      *
      * The default component is: [SchedulerViewItem]({% slug api_scheduler_schedulerviewitem %}).
      *
@@ -3042,7 +3236,7 @@ export declare interface SchedulerProps {
     editItem?: React_2.ComponentType<SchedulerEditItemProps>;
     /**
      * Overrides the default task. Specifying the `task` property of a specific view will override this property.
-     * Currently, the `task` is being used in the [AgendaView]({% slug agenda_view_scheduler %}) only.
+     * Currently, only the [AgendaView]({% slug agenda_view_scheduler %}) uses the `task`.
      *
      * The default component is: [SchedulerTask]({% slug api_scheduler_schedulertask %}).
      *
@@ -3057,7 +3251,7 @@ export declare interface SchedulerProps {
     task?: React_2.ComponentType<SchedulerTaskProps>;
     /**
      * Overrides the default viewTask. Specifying the `viewTask` property of a specific view will override this property.
-     * Currently, the `viewTask` is being used in the [AgendaView]({% slug agenda_view_scheduler %}) only.
+     * Currently, only the [AgendaView]({% slug agenda_view_scheduler %}) uses the `viewTask`.
      *
      * The default component is: [SchedulerViewTask]({% slug api_scheduler_schedulerviewtask %}).
      *
@@ -3072,7 +3266,7 @@ export declare interface SchedulerProps {
     viewTask?: React_2.ComponentType<SchedulerTaskProps>;
     /**
      * Overrides the default editTask. Specifying the `editTask` property of a specific view will override this property.
-     * Currently, the `editTask` is being used in the [AgendaView]({% slug agenda_view_scheduler %}) only.
+     * Currently, only the [AgendaView]({% slug agenda_view_scheduler %}) uses the `editTask`.
      *
      * The default component is: [SchedulerEditTask]({% slug api_scheduler_scheduleredittask %}).
      *
@@ -3186,6 +3380,8 @@ export declare interface SchedulerProps {
     /**
      * Sets if the Scheduler component is editable. The value can be either a `boolean` or an Object to specify different types of editing.
      *
+     * @default false
+     *
      * @example
      * ```jsx
      * <Scheduler editable={true} />
@@ -3220,7 +3416,7 @@ export declare interface SchedulerProps {
      */
     date?: Date;
     /**
-     * Sets a default selected `Date`. The `defaultDate` property is used to specify the initial rendered date, while still remaining in an uncontrolled mode.
+     * Sets a default selected `Date`. Use the `defaultDate` property to specify the initial rendered date while remaining in an uncontrolled mode.
      *
      * @example
      * ```jsx
@@ -3229,7 +3425,7 @@ export declare interface SchedulerProps {
      */
     defaultDate?: Date;
     /**
-     * Force a `rtl` mode. For more information refer to [RTL Support]({% slug globalization_scheduler %}#toc-right-to-left-support).
+     * Forces RTL mode. For more information refer to [RTL Support]({% slug globalization_scheduler %}#toc-right-to-left-support).
      *
      * @example
      * ```jsx
@@ -3240,6 +3436,8 @@ export declare interface SchedulerProps {
     /**
      * Sets the `height` of the Scheduler.
      *
+     * @default 600
+     *
      * @example
      * ```jsx
      * <Scheduler height={600} />
@@ -3247,7 +3445,7 @@ export declare interface SchedulerProps {
      */
     height?: number | string;
     /**
-     * Specify the available `view` components as `children` and the Scheduler will match the currently selected view and render it.
+     * Specifies the available `view` components as `children`. The Scheduler matches the currently selected view and renders it.
      *
      * @example
      * ```jsx
@@ -3259,10 +3457,10 @@ export declare interface SchedulerProps {
      */
     children?: SchedulerView[] | SchedulerView;
     /**
-     * Specifies the id of the timezone that will be displayed in the Scheduler.
+     * Specifies the id of the timezone that the Scheduler displays.
      * For example, `Europe/Sofia`.
      *
-     * Defaults to `Etc/UTC`.
+     * @default "Etc/UTC"
      *
      * @example
      * ```jsx
@@ -3291,7 +3489,7 @@ export declare interface SchedulerProps {
      */
     resources?: SchedulerResource[];
     /**
-     * The names of the model fields from which the Scheduler will read its data
+     * Specifies the names of the model fields from which the Scheduler reads its data
      * ([see example]({% slug data_binding_scheduler %})).
      *
      * @example
@@ -3302,7 +3500,7 @@ export declare interface SchedulerProps {
      */
     modelFields?: SchedulerModelFields;
     /**
-     * Called when new `date` is selected.
+     * Fires when the user selects a new `date`.
      *
      * @example
      * ```jsx
@@ -3312,7 +3510,7 @@ export declare interface SchedulerProps {
      */
     onDateChange?: (args: SchedulerDateChangeEvent) => void;
     /**
-     * Called when new `view` is selected. [(see example)]({% slug views_scheduler %}#toc-controlling-the-selected-view).
+     * Fires when the user selects a new `view`. [(see example)]({% slug views_scheduler %}#toc-controlling-the-selected-view).
      *
      * @example
      * ```jsx
@@ -3322,7 +3520,7 @@ export declare interface SchedulerProps {
      */
     onViewChange?: (args: SchedulerViewChangeEvent) => void;
     /**
-     * Called each time when editing occurs.
+     * Fires each time editing occurs.
      * To enable editing set the `editable` property to `true` or an [`EditableProp`]({% slug api_scheduler_editableprop %}).
      *
      * For more information refer to the [Scheduler Editing]({% slug editing_scheduler %}) article.
@@ -3380,22 +3578,31 @@ export declare interface SchedulerRemoveDialogProps {
      */
     dataItem: DataItem;
     /**
-     * Called when the `close` button is clicked.
+     * Fires when you click the `close` button.
      */
     onClose?: (event: SchedulerRemoveDialogStateChangeEvent<null>) => void;
     /**
-     * Called when the `cancel` button is clicked.
+     * Fires when you click the `cancel` button.
      */
     onCancel?: (event: SchedulerRemoveDialogStateChangeEvent<null>) => void;
     /**
-     * Called when the `confirm` button is clicked.
+     * Fires when you click the `confirm` button.
      */
     onConfirm?: (event: SchedulerRemoveDialogStateChangeEvent<DataItem | null>) => void;
 }
 
 export declare interface SchedulerRemoveDialogStateChangeEvent<T> {
+    /**
+     * The SchedulerRemoveDialog instance that triggered the event.
+     */
     target: SchedulerRemoveDialogHandle;
+    /**
+     * The value associated with the event.
+     */
     value: T;
+    /**
+     * The React synthetic event object.
+     */
     syntheticEvent: React_2.SyntheticEvent;
 }
 
@@ -3507,7 +3714,13 @@ export declare interface SchedulerSlotFocusEvent {
  * For more information about Refs, refer to the [React Refs & Dom](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) article.
  */
 export declare interface SchedulerSlotHandle {
+    /**
+     * The HTML element of the SchedulerSlot component.
+     */
     element: HTMLDivElement | null;
+    /**
+     * The props of the SchedulerSlot component.
+     */
     props: SchedulerSlotProps;
 }
 
@@ -3538,7 +3751,7 @@ export declare interface SchedulerSlotProps extends Slot {
     /**
      * Specifies the `tabIndex` attribute of the wrapping element of the SchedulerSlot.
      *
-     * Providing `null` will not apply any `tabIndex` to the element.
+     * Providing `null` does not apply any `tabIndex` to the element.
      */
     tabIndex?: number;
     /**
@@ -3567,69 +3780,69 @@ export declare interface SchedulerSlotProps extends Slot {
      */
     editable?: EditableProp | boolean;
     /**
-     * Specifies if the `day` of the SchedulerSlot(in the current timezone) is between the `workDayStart` and `workDayEnd` of the active view.
+     * Specifies if the `day` of the SchedulerSlot (in the current timezone) is between the `workDayStart` and `workDayEnd` of the active view.
      */
     isWorkDay?: boolean;
     /**
-     * Specifies if the `time` of the SchedulerSlot(in the current timezone) is between the `workDayStart` and `workDayEnd` of the active view.
+     * Specifies if the `time` of the SchedulerSlot (in the current timezone) is between the `workDayStart` and `workDayEnd` of the active view.
      */
     isWorkHour?: boolean;
     /**
-     * Sets the selected state of the SchedulerSlot. By default the `k-selected` className is added if `props.selected` is `true`.
+     * Sets the selected state of the SchedulerSlot. By default, the `k-selected` className is added if `props.selected` is `true`.
      */
     selected?: boolean;
     /**
      * Sets the `row` in the context of the current active view.
-     * This property is being used to provide keyboard navigation between the SchedulerSlot components.
+     * This property provides keyboard navigation between the SchedulerSlot components.
      */
     row: number;
     /**
      * Sets the `col` in the context of the current active view.
-     * This property is being used to provide keyboard navigation between the SchedulerSlot components.
+     * This property provides keyboard navigation between the SchedulerSlot components.
      */
     col: number;
     /**
-     * Called each time the element, or any of its child elements, receive focus.
+     * Fires each time the element, or any of its child elements, receive focus.
      */
     onFocus?: (event: SchedulerSlotFocusEvent) => void;
     /**
-     * Called each time the element, or any of its child elements, lose focus.
+     * Fires each time the element, or any of its child elements, lose focus.
      */
     onBlur?: (event: SchedulerSlotFocusEvent) => void;
     /**
-     * Called each time the element, or any of its child elements, is clicked.
+     * Fires each time the element, or any of its child elements, is clicked.
      */
     onClick?: (event: SchedulerSlotMouseEvent) => void;
     /**
-     * Called each time the element, or any of its child elements receives `mouseenter` event.
+     * Fires each time the element, or any of its child elements, receives a `mouseenter` event.
      */
     onMouseEnter?: (event: SchedulerSlotMouseEvent) => void;
     /**
-     * Called each time the element, or any of its child elements receives `mouseleave` event.
+     * Fires each time the element, or any of its child elements, receives a `mouseleave` event.
      */
     onMouseLeave?: (event: SchedulerSlotMouseEvent) => void;
     /**
-     * Called each time the element, or any of its child elements receives `mouseover` event.
+     * Fires each time the element, or any of its child elements, receives a `mouseover` event.
      */
     onMouseOver?: (event: SchedulerSlotMouseEvent) => void;
     /**
-     * Called each time the element, or any of its child elements receives `mouseout` event.
+     * Fires each time the element, or any of its child elements, receives a `mouseout` event.
      */
     onMouseOut?: (event: SchedulerSlotMouseEvent) => void;
     /**
-     * Called each time the element, or any of its child elements, is double-clicked.
+     * Fires each time the element, or any of its child elements, is double-clicked.
      */
     onDoubleClick?: (event: SchedulerSlotMouseEvent) => void;
     /**
-     * Called each time a `keydown` event propagates to the wrapping element.
+     * Fires each time a `keydown` event propagates to the wrapping element.
      */
     onKeyDown?: (event: SchedulerSlotKeyboardEvent) => void;
     /**
-     * Called each time a `keypress` event propagates to the wrapping element.
+     * Fires each time a `keypress` event propagates to the wrapping element.
      */
     onKeyPress?: (event: SchedulerSlotKeyboardEvent) => void;
     /**
-     * Called each time a `keyup` event propagates to the wrapping element.
+     * Fires each time a `keyup` event propagates to the wrapping element.
      */
     onKeyUp?: (event: SchedulerSlotKeyboardEvent) => void;
 }
@@ -3638,7 +3851,13 @@ export declare interface SchedulerSlotProps extends Slot {
  * Represents the object passed to the `slots-focus` reducer.
  */
 export declare interface SchedulerSlotsFocusAction {
+    /**
+     * The type of focus action to perform on the slot.
+     */
     type: SLOTS_FOCUS_ACTION;
+    /**
+     * The reference to the scheduler slot handle.
+     */
     slot: React_2.RefObject<SchedulerSlotHandle | null>;
 }
 
@@ -3646,7 +3865,13 @@ export declare interface SchedulerSlotsFocusAction {
  * Represents the object passed to the `slots-select` reducer.
  */
 export declare interface SchedulerSlotsSelectAction {
+    /**
+     * The type of action to perform on slot selection.
+     */
     type: SLOTS_SELECT_ACTION;
+    /**
+     * The reference to the scheduler slot handle.
+     */
     slot?: React_2.RefObject<SchedulerSlotHandle | null>;
 }
 
@@ -3661,12 +3886,24 @@ export declare const SchedulerTask: React_2.ForwardRefExoticComponent<SchedulerT
  * Represents the props of the KendoReact [SchedulerTask]({% slug api_scheduler_schedulertask %}) component.
  */
 export declare interface SchedulerTaskHandle {
+    /**
+     * The HTML element of the SchedulerTask component.
+     */
     element: HTMLDivElement | null;
+    /**
+     * The props of the SchedulerTask component.
+     */
     props: SchedulerTaskProps;
 }
 
 export declare interface SchedulerTaskMouseEvent {
+    /**
+     * The SchedulerTask instance that triggered the event.
+     */
     target: SchedulerTaskHandle;
+    /**
+     * The React mouse event object.
+     */
     syntheticEvent: React.MouseEvent;
 }
 
@@ -3706,9 +3943,9 @@ export declare interface SchedulerTaskProps extends Item {
      */
     editable?: EditableProp | boolean;
     /**
-     * Called when the `delete` icon is clicked.
+     * Fires when you click the `delete` icon.
      *
-     * The `delete` icon is rendered only when `props.editable` or `props.editable.remove` is `true`
+     * The `delete` icon renders only when `props.editable` or `props.editable.remove` is `true`.
      */
     onRemoveClick?: (event: SchedulerTaskMouseEvent) => void;
 }
@@ -3719,11 +3956,14 @@ export declare interface SchedulerTaskProps extends Item {
 export declare type SchedulerView = React.ReactElement<SchedulerViewProps>;
 
 /**
- * Called every time the user changes the active `view`.
+ * Fires every time the user changes the active `view`.
  *
  * For more information, refer to the [Scheduler Views]({% slug views_scheduler %}) article.
  */
 export declare interface SchedulerViewChangeEvent {
+    /**
+     * The name of the selected view.
+     */
     value: string;
 }
 
@@ -3731,11 +3971,29 @@ export declare interface SchedulerViewChangeEvent {
  * Represents the arguments which are passed to the [dateRange]({% slug api_scheduler_schedulerviewprops %}#toc-daterange) function.
  */
 export declare interface SchedulerViewDateRangeArgs {
+    /**
+     * The current date for the view.
+     */
     date: Date;
+    /**
+     * The internationalization service instance.
+     */
     intl: IntlService;
+    /**
+     * The timezone for the scheduler.
+     */
     timezone?: string;
+    /**
+     * The number of days to display in the view.
+     */
     numberOfDays?: number;
+    /**
+     * The start day of the work week.
+     */
     workWeekStart?: Day;
+    /**
+     * The end day of the work week.
+     */
     workWeekEnd?: Day;
 }
 
@@ -3758,7 +4016,13 @@ export declare const schedulerViewItemDefaultProps: {
  * For more information about Refs, refer to the [React Refs & Dom](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) article.
  */
 export declare interface SchedulerViewItemHandle {
+    /**
+     * The HTML element of the SchedulerViewItem component.
+     */
     element: HTMLDivElement | null;
+    /**
+     * The props of the SchedulerViewItem component.
+     */
     props: SchedulerViewItemProps;
 }
 
@@ -3863,6 +4127,9 @@ export declare const schedulerViewSlotDefaultProps: {
  * For more information about Refs, refer to the [React Refs & Dom](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) article.
  */
 export declare interface SchedulerViewSlotHandle {
+    /**
+     * The props of the SchedulerViewSlot component.
+     */
     props: SchedulerViewSlotProps;
 }
 
@@ -3877,7 +4144,7 @@ export declare interface SchedulerViewSlotProps extends SchedulerSlotProps {
      */
     slot?: React_2.ComponentType<SchedulerSlotProps>;
     /**
-     * Set to `false` will render the `slot` as is, without expanding depending on the `items` inside it.
+     * Set to `false` renders the `slot` as is, without expanding depending on the `items` inside it.
      *
      * For more information, please refer to the [Adaptive Slot Height]({% slug recurring_events_scheduler %}) article.
      */
@@ -3901,7 +4168,13 @@ export declare const schedulerViewTaskDefaultProps: {
  * For more information about Refs, refer to the [React Refs & Dom](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) article.
  */
 export declare interface SchedulerViewTaskHandle {
+    /**
+     * The HTML element of the SchedulerViewTask component.
+     */
     element: HTMLDivElement | null;
+    /**
+     * The props of the SchedulerViewTask component.
+     */
     props: SchedulerViewTaskProps;
 }