@bryntum/calendar-vue-3 7.3.0 → 7.3.2

package/src/components/BryntumSchedulerBase.vue

@@ -71,6 +71,8 @@ defineProps<{
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/view/SchedulerBase#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -678,10 +680,14 @@ defineProps<{
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/view/SchedulerBase#config-insertBefore)
      */
     insertBefore ? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/view/SchedulerBase#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -934,7 +940,12 @@ defineProps<{
      * Can be omitted in favor of individual store configs or [crudManager](https://bryntum.com/products/calendar/docs/api/Scheduler/view/mixin/SchedulerStores#config-crudManager) config.
      * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/view/SchedulerBase#config-project)
      */
-    project ? : ProjectModel|ProjectModelConfig|object
+    project ? : ProjectModel|ProjectModelConfig|object|null
+    /**
+     * The project model class to use when creating the project instance. Override this to use a custom project
+     * model class. In SchedulerPro and Gantt, this is overridden to use their respective project model classes.
+     */
+    projectModelClass ? : typeof ProjectModel
     /**
      * Range used to set the length of the time axis when used as a component of a Calendar. Suitable units are
      * `'month'`, `'week'` and `'day'`.
@@ -2041,7 +2052,7 @@ const emit = defineEmits<{
      * @param {Scheduler.model.AssignmentModel[]} params.event.deselected An array of assignments that will be removed from the selection.
      * @param {Scheduler.model.AssignmentModel[]} params.event.selection The currently selected assignments, before applying `selected` and `deselected`.
      */
-    (e: 'beforeAssignmentSelectionChange', params: ((event: { source: Scheduler, action: 'select'|'deselect'|'update'|'clear', selected: AssignmentModel[], deselected: AssignmentModel[], selection: AssignmentModel[] }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeAssignmentSelectionChange', params: ((event: { source: Scheduler, action: 'select'|'deselect'|'update'|'clear', selected: AssignmentModel[], deselected: AssignmentModel[], selection: AssignmentModel[] }) => boolean|void)|string): boolean|void
     /**
      * This event fires whenever the [autoCreate gesture](https://bryntum.com/products/calendar/docs/api/Scheduler/view/SchedulerBase#config-autoCreate) is detected.
      * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/view/SchedulerBase#event-beforeAutoCreate)
@@ -2061,7 +2072,7 @@ const emit = defineEmits<{
      * @param {Grid.view.Grid} params.event.source Owner grid
      * @param {Grid.util.GridLocation} params.event.editorContext Editing context
      */
-    (e: 'beforeCancelCellEdit', params: ((event: { source: Grid, editorContext: GridLocation }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeCancelCellEdit', params: ((event: { source: Grid, editorContext: GridLocation }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Grid before the row editing is canceled, return false to signal that the value is invalid and editing should not be finalized.
      * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/view/SchedulerBase#event-beforeCancelRowEdit)
@@ -2080,7 +2091,7 @@ const emit = defineEmits<{
      * @param {Grid.view.Grid} params.event.source Owner grid
      * @param {CellEditorContext} params.event.editorContext Editing context
      */
-    (e: 'beforeCellEditStart', params: ((event: { source: Grid, editorContext: CellEditorContext }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeCellEditStart', params: ((event: { source: Grid, editorContext: CellEditorContext }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Grid before deleting a range of selected cell values by pressing <kbd>Backspace</kbd> or <kbd>Delete</kbd>
      * buttons while [autoEdit](https://bryntum.com/products/calendar/docs/api/Grid/feature/CellEdit#config-autoEdit) is set to `true`. Return `false` to prevent editing.
@@ -2090,7 +2101,7 @@ const emit = defineEmits<{
      * @param {Grid.view.Grid} params.event.source Owner grid
      * @param {(Grid.util.GridLocation|Core.data.Model)[]} params.event.gridSelection An array of cell selectors or records that will have their values deleted (the records themselves will not get deleted, only visible column values).
      */
-    (e: 'beforeCellRangeDelete', params: ((event: { source: Grid, gridSelection: (GridLocation|Model)[] }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeCellRangeDelete', params: ((event: { source: Grid, gridSelection: (GridLocation|Model)[] }) => boolean|void)|string): boolean|void
     /**
      * Fires for each selected record on the owning Grid before editing a range of selected cell values
      * @param {string} e Event name
@@ -2100,7 +2111,7 @@ const emit = defineEmits<{
      * @param {string} params.event.field The field being changed
      * @param {any} params.event.value The value being set
      */
-    (e: 'beforeCellRangeEdit', params: ((event: { record: Model, field: string, value: any }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeCellRangeEdit', params: ((event: { record: Model, field: string, value: any }) => boolean|void)|string): boolean|void
     /**
      * This event is triggered before a parent column is collapsed or expanded.
      * @param {string} e Event name
@@ -2120,7 +2131,7 @@ const emit = defineEmits<{
      * @param {Grid.column.Column} params.event.column The dragged column.
      * @param {Event} params.event.event The browser event.
      */
-    (e: 'beforeColumnDragStart', params: ((event: { source: Grid, column: Column, event: Event }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeColumnDragStart', params: ((event: { source: Grid, column: Column, event: Event }) => boolean|void)|string): boolean|void
     /**
      * This event is fired when a column is dropped, and you can return false from a listener to abort the operation.
      * @param {string} e Event name
@@ -2133,7 +2144,7 @@ const emit = defineEmits<{
      * @param {Event} params.event.event The browser event.
      * @param {string} params.event.region The region where the column was dropped.
      */
-    (e: 'beforeColumnDropFinalize', params: ((event: { source: Grid, column: Column, insertBefore: Column, newParent: Column, event: Event, region: string }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeColumnDropFinalize', params: ((event: { source: Grid, column: Column, insertBefore: Column, newParent: Column, event: Event, region: string }) => boolean|void)|string): boolean|void
     /**
      * This event is fired prior to starting a column resize gesture. The resize is canceled if a listener returns
      * `false`.
@@ -2144,7 +2155,7 @@ const emit = defineEmits<{
      * @param {Grid.column.Column} params.event.column The column
      * @param {Event} params.event.domEvent The browser event
      */
-    (e: 'beforeColumnResize', params: ((event: { source: Grid, column: Column, domEvent: Event }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeColumnResize', params: ((event: { source: Grid, column: Column, domEvent: Event }) => boolean|void)|string): boolean|void
     /**
      * This event is fired on the owning Scheduler when the context [element](https://bryntum.com/products/calendar/docs/api/Scheduler/feature/ScheduleContext#property-element) or
      * [widget](https://bryntum.com/products/calendar/docs/api/Scheduler/feature/ScheduleContext#property-widget) is about to be shown.
@@ -2161,7 +2172,7 @@ const emit = defineEmits<{
      * @param {number} params.event.position.x The x coordinate of the context element
      * @param {number} params.event.position.y The y coordinate of the context element
      */
-    (e: 'beforeContextShow', params: ((event: { source: ScheduleContext, context: TimelineContext, element: HTMLElement, position: { width: number, height: number, x: number, y: number } }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeContextShow', params: ((event: { source: ScheduleContext, context: TimelineContext, element: HTMLElement, position: { width: number, height: number, x: number, y: number } }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Grid before a copy action is performed, return `false` to prevent the action
      * @param {string} e Event name
@@ -2185,7 +2196,7 @@ const emit = defineEmits<{
      * @param {string} params.event.lineDelimiter The CSV delimiter to separate lines
      * @param {string} params.event.columnDelimiter The CSV delimiter to separate values on one line
      */
-    (e: 'beforeCSVExport', params: ((event: { config: ExportConfig, columns: Column[], rows: Model[], lineDelimiter: string, columnDelimiter: string }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeCSVExport', params: ((event: { config: ExportConfig, columns: Column[], rows: Model[], lineDelimiter: string, columnDelimiter: string }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Scheduler or Gantt widget before a dependency is added from the dependency
      * edit popup
@@ -2196,7 +2207,7 @@ const emit = defineEmits<{
      * @param {Scheduler.feature.DependencyEdit} params.event.dependencyEdit The dependency edit feature
      * @param {Scheduler.model.DependencyModel} params.event.dependencyRecord The dependency about to be added
      */
-    (e: 'beforeDependencyAdd', params: ((event: { source: Scheduler, dependencyEdit: DependencyEdit, dependencyRecord: DependencyModel }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeDependencyAdd', params: ((event: { source: Scheduler, dependencyEdit: DependencyEdit, dependencyRecord: DependencyModel }) => boolean|void)|string): boolean|void
     /**
      * Fired on the owning Scheduler/Gantt before a dependency creation drag operation starts. Return `false` to
      * prevent it
@@ -2205,7 +2216,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {Scheduler.model.TimeSpan} params.event.source The source task
      */
-    (e: 'beforeDependencyCreateDrag', params: ((event: { source: TimeSpan }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeDependencyCreateDrag', params: ((event: { source: TimeSpan }) => boolean|void)|string): boolean|void
     /**
      * Fired on the owning Scheduler/Gantt when a dependency drag creation operation is about to finalize
      * @param {string} e Event name
@@ -2260,7 +2271,7 @@ const emit = defineEmits<{
      * @param {Scheduler.model.DependencyModel} params.event.dependencyRecord The dependency about to be saved
      * @param {object} params.event.values The new values
      */
-    (e: 'beforeDependencySave', params: ((event: { source: Scheduler, dependencyRecord: DependencyModel, values: object }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeDependencySave', params: ((event: { source: Scheduler, dependencyRecord: DependencyModel, values: object }) => boolean|void)|string): boolean|void
     /**
      * Fires before an object is destroyed.
      * @param {string} e Event name
@@ -2280,7 +2291,7 @@ const emit = defineEmits<{
      * @param {Scheduler.model.ResourceModel} params.event.resourceRecord
      * @param {Date} params.event.date The datetime associated with the drag start point.
      */
-    (e: 'beforeDragCreate', params: ((event: { source: Scheduler, resourceRecord: ResourceModel, date: Date }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeDragCreate', params: ((event: { source: Scheduler, resourceRecord: ResourceModel, date: Date }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Scheduler to allow implementer to prevent immediate finalization by setting
      * `data.context.async = true` in the listener, to show a confirmation popup etc.
@@ -2309,7 +2320,7 @@ const emit = defineEmits<{
      * @param {Scheduler.model.ResourceModel[]} params.event.resourceRecords Resources that the record is assigned to
      * @param {Scheduler.model.AssignmentModel[]} params.event.assignmentRecords The assignment records
      */
-    (e: 'beforeEventAdd', params: ((event: { source: Scheduler, eventRecord: EventModel, resourceRecords: ResourceModel[], assignmentRecords: AssignmentModel[] }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeEventAdd', params: ((event: { source: Scheduler, eventRecord: EventModel, resourceRecords: ResourceModel[], assignmentRecords: AssignmentModel[] }) => boolean|void)|string): boolean|void
     /**
      * Fires before an event is removed. Can be triggered by user pressing <kbd>Delete</kbd> or <kbd>Backspace</kbd> or by the
      * event editor. Return `false` to immediately veto the removal (or a `Promise` yielding `true` or `false`
@@ -2337,7 +2348,7 @@ const emit = defineEmits<{
      * @param {Scheduler.model.AssignmentModel[]} params.event.assignmentRecords Assignment records being dragged
      * @param {MouseEvent} params.event.domEvent Browser event
      */
-    (e: 'beforeEventDrag', params: ((event: { source: Scheduler, eventRecord: EventModel, resourceRecord: ResourceModel, eventRecords: EventModel[], assignmentRecords: AssignmentModel[], domEvent: MouseEvent }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeEventDrag', params: ((event: { source: Scheduler, eventRecord: EventModel, resourceRecord: ResourceModel, eventRecords: EventModel[], assignmentRecords: AssignmentModel[], domEvent: MouseEvent }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Scheduler before drag selection starts. Return false to prevent the operation.
      * @param {string} e Event name
@@ -2346,7 +2357,7 @@ const emit = defineEmits<{
      * @param {Scheduler.view.SchedulerBase} params.event.source The Scheduler instance
      * @param {Event} params.event.event The native browser DOM event
      */
-    (e: 'beforeEventDragSelect', params: ((event: { source: SchedulerBase, event: Event }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeEventDragSelect', params: ((event: { source: SchedulerBase, event: Event }) => boolean|void)|string): boolean|void
     /**
      * This event is fired on the owning Scheduler after the event drag operation completes, but before changing any data.
      * It allows implementer to use asynchronous validation/finalization by setting `context.async = true`
@@ -2360,15 +2371,19 @@ const emit = defineEmits<{
      * @param {object} params.event.context
      * @param {DropData} params.event.context.dropData Information about the drop points for dragged events/assignments.
      * @param {boolean} params.event.context.async Set to `true` to not finalize the drag-drop operation immediately (e.g. to wait for user confirmation)
+     * @param {Scheduler.model.EventModel} params.event.context.eventRecord The primary event record being dragged
      * @param {Scheduler.model.EventModel[]} params.event.context.eventRecords Event records being dragged
      * @param {Scheduler.model.AssignmentModel[]} params.event.context.assignmentRecords Assignment records being dragged
      * @param {Scheduler.model.EventModel} params.event.context.targetEventRecord The event record (if any) where the drop happened
+     * @param {Scheduler.model.ResourceModel} params.event.context.resourceRecord Resource record the drag started from
      * @param {Scheduler.model.ResourceModel} params.event.context.newResource Resource record for drop target
+     * @param {Date} params.event.context.startDate New start date after the drop
+     * @param {Date} params.event.context.endDate New end date after the drop
      * @param {boolean} params.event.context.valid Set this to `false` to abort the drop immediately.
      * @param {Function} params.event.context.finalize Call this method after an <strong>async</strong> finalization flow, to finalize the drag-drop operation. This method accepts one argument: pass `true` to update records, or `false` to ignore changes
      * @param {MouseEvent} params.event.domEvent Browser event
      */
-    (e: 'beforeEventDropFinalize', params: ((event: { source: Scheduler, context: { dropData: DropData, async: boolean, eventRecords: EventModel[], assignmentRecords: AssignmentModel[], targetEventRecord: EventModel, newResource: ResourceModel, valid: boolean, finalize: Function }, domEvent: MouseEvent }) => void)|string): void
+    (e: 'beforeEventDropFinalize', params: ((event: { source: Scheduler, context: { dropData: DropData, async: boolean, eventRecord: EventModel, eventRecords: EventModel[], assignmentRecords: AssignmentModel[], targetEventRecord: EventModel, resourceRecord: ResourceModel, newResource: ResourceModel, startDate: Date, endDate: Date, valid: boolean, finalize: Function }, domEvent: MouseEvent }) => void)|string): void
     /**
      * Fires on the owning Scheduler before an event is displayed in an editor.
      * This may be listened for to allow an application to take over event editing duties. Returning `false`
@@ -2383,7 +2398,7 @@ const emit = defineEmits<{
      * @param {Scheduler.model.ResourceModel} params.event.resourceRecord The Resource record for the event. If the event is being created, it will not contain a resource, so this parameter specifies the resource the event is being created for.
      * @param {HTMLElement} params.event.eventElement The element which represents the event in the scheduler display.
      */
-    (e: 'beforeEventEdit', params: ((event: { source: Scheduler, eventEdit: SchedulerEventEdit, eventRecord: EventModel, resourceRecord: ResourceModel, eventElement: HTMLElement }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeEventEdit', params: ((event: { source: Scheduler, eventEdit: SchedulerEventEdit, eventRecord: EventModel, resourceRecord: ResourceModel, eventElement: HTMLElement }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Scheduler when the editor for an event is available but before it is populated with
      * data and shown. Allows manipulating fields etc.
@@ -2408,7 +2423,7 @@ const emit = defineEmits<{
      * @param {Scheduler.model.ResourceModel} params.event.resourceRecord Resource record the resize starts within
      * @param {MouseEvent} params.event.event Browser event
      */
-    (e: 'beforeEventResize', params: ((event: { source: Scheduler, eventRecord: EventModel, resourceRecord: ResourceModel, event: MouseEvent }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeEventResize', params: ((event: { source: Scheduler, eventRecord: EventModel, resourceRecord: ResourceModel, event: MouseEvent }) => boolean|void)|string): boolean|void
     /**
      * Fired on the owning Scheduler to allow implementer to prevent immediate finalization by returning a promise
      * in the listener, to show a confirmation popup etc
@@ -2457,7 +2472,7 @@ const emit = defineEmits<{
      * @param {Scheduler.model.EventModel[]} params.event.deselected An array of events that will be removed from the selection.
      * @param {Scheduler.model.EventModel[]} params.event.selection The currently selected events, before applying `selected` and `deselected`.
      */
-    (e: 'beforeEventSelectionChange', params: ((event: { source: Scheduler, action: 'select'|'deselect'|'update'|'clear', selected: EventModel[], deselected: EventModel[], selection: EventModel[] }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeEventSelectionChange', params: ((event: { source: Scheduler, action: 'select'|'deselect'|'update'|'clear', selected: EventModel[], deselected: EventModel[], selection: EventModel[] }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Grid before Excel export starts. Return `false` to cancel the export.
      * @param {string} e Event name
@@ -2467,7 +2482,7 @@ const emit = defineEmits<{
      * @param {XLSColumn[]} params.event.columns An array of columns to export
      * @param {any[][]} params.event.rows An array of records to export
      */
-    (e: 'beforeExcelExport', params: ((event: { config: ExportConfig, columns: XLSColumn[], rows: any[] }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeExcelExport', params: ((event: { config: ExportConfig, columns: XLSColumn[], rows: any[] }) => boolean|void)|string): boolean|void
     /**
      * Fired before dragging of the FillHandle starts, return `false` to prevent the drag operation.
      * @param {string} e Event name
@@ -2476,7 +2491,7 @@ const emit = defineEmits<{
      * @param {Grid.util.GridLocation} params.event.cell Information about the column / record
      * @param {MouseEvent} params.event.domEvent The raw DOM event
      */
-    (e: 'beforeFillHandleDragStart', params: ((event: { cell: GridLocation, domEvent: MouseEvent }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeFillHandleDragStart', params: ((event: { cell: GridLocation, domEvent: MouseEvent }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Grid before the cell editing is finished, return false to signal that the value is invalid and editing should not be finalized.
      * @param {string} e Event name
@@ -2503,7 +2518,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {Core.widget.Widget} params.event.source The widget being hidden.
      */
-    (e: 'beforeHide', params: ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeHide', params: ((event: { source: Widget }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Scheduler or Gantt widget before pan starts. Return `false` to prevent the operation.
      * @param {string} e Event name
@@ -2511,7 +2526,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {Event} params.event.event The native browser DOM event
      */
-    (e: 'beforePan', params: ((event: { event: Event }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforePan', params: ((event: { event: Event }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Grid before a paste action is performed, return `false` to prevent the action
      * @param {string} e Event name
@@ -2531,7 +2546,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {PdfExportConfig} params.event.config Export config
      */
-    (e: 'beforePdfExport', params: ((event: { config: PdfExportConfig }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforePdfExport', params: ((event: { config: PdfExportConfig }) => boolean|void)|string): boolean|void
     /**
      * Fired before the [viewPreset](https://bryntum.com/products/calendar/docs/api/Scheduler/view/mixin/TimelineViewPresets#config-viewPreset) is changed.
      * @param {string} e Event name
@@ -2543,7 +2558,7 @@ const emit = defineEmits<{
      * @param {Scheduler.preset.ViewPreset} params.event.from The outgoing ViewPreset.
      * @param {Scheduler.preset.ViewPreset} params.event.to The ViewPreset being switched to.
      */
-    (e: 'beforePresetChange', params: ((event: { source: Scheduler, startDate: Date, endDate: Date, from: ViewPreset, to: ViewPreset }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforePresetChange', params: ((event: { source: Scheduler, startDate: Date, endDate: Date, from: ViewPreset, to: ViewPreset }) => boolean|void)|string): boolean|void
     /**
      * Fires before a row is rendered.
      * @param {string} e Event name
@@ -2592,7 +2607,7 @@ const emit = defineEmits<{
      * @param {Scheduler.util.TimelineContext[]} params.event.selectedContexts The context objects containing information about the selected cells
      * @param {DomConfig} params.event.domConfig A [DomConfig](https://bryntum.com/products/calendar/docs/api/Core/helper/DomHelper#typedef-DomConfig) config object which is used to render the selected cell elements.
      */
-    (e: 'beforeSelectedContextsShow', params: ((event: { source: ScheduleContext, selectedContexts: TimelineContext[], domConfig: DomConfig }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeSelectedContextsShow', params: ((event: { source: ScheduleContext, selectedContexts: TimelineContext[], domConfig: DomConfig }) => boolean|void)|string): boolean|void
     /**
      * Fires before the selection changes. Returning `false` from a listener prevents the change
      * @param {string} e Event name
@@ -2608,7 +2623,7 @@ const emit = defineEmits<{
      * @param {Grid.util.GridLocation[]} params.event.selectedCells The cells to be selected in this operation.
      * @param {Grid.util.GridLocation[]} params.event.cellSelection The cells in the current selection, before applying `selectedCells` and `deselectedCells`
      */
-    (e: 'beforeSelectionChange', params: ((event: { action: string, mode: 'row'|'cell', source: Grid, deselected: Model[], selected: Model[], selection: Model[], deselectedCells: GridLocation[], selectedCells: GridLocation[], cellSelection: GridLocation[] }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeSelectionChange', params: ((event: { action: string, mode: 'row'|'cell', source: Grid, deselected: Model[], selected: Model[], selection: Model[], deselectedCells: GridLocation[], selectedCells: GridLocation[], cellSelection: GridLocation[] }) => boolean|void)|string): boolean|void
     /**
      * Fired before this container will load record values into its child fields. This is useful if you
      * want to modify the UI before data is loaded (e.g. set some input field to be readonly)
@@ -2635,7 +2650,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {Scheduler.model.TimeSpan} params.event.source The hovered task
      */
-    (e: 'beforeShowTerminals', params: ((event: { source: TimeSpan }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeShowTerminals', params: ((event: { source: TimeSpan }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Grid before editing starts, return `false` to prevent editing
      * @param {string} e Event name
@@ -2644,7 +2659,7 @@ const emit = defineEmits<{
      * @param {Grid.view.Grid} params.event.source Owner grid
      * @param {RowEditorContext} params.event.editorContext Editing context
      */
-    (e: 'beforeStartRowEdit', params: ((event: { source: Grid, editorContext: RowEditorContext }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeStartRowEdit', params: ((event: { source: Grid, editorContext: RowEditorContext }) => boolean|void)|string): boolean|void
     /**
      * Fired before state is applied to the source. Allows editing the state object or preventing the operation.
      * @param {string} e Event name
@@ -2652,7 +2667,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {SchedulerStateInfo} params.event.state State object config
      */
-    (e: 'beforeStateApply', params: ((event: { state: SchedulerStateInfo }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeStateApply', params: ((event: { state: SchedulerStateInfo }) => boolean|void)|string): boolean|void
     /**
      * Fired before state is saved by the StateProvider. Allows editing the state object or preventing the operation.
      * @param {string} e Event name
@@ -2660,7 +2675,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {SchedulerStateInfo} params.event.state State object config
      */
-    (e: 'beforeStateSave', params: ((event: { state: SchedulerStateInfo }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeStateSave', params: ((event: { state: SchedulerStateInfo }) => boolean|void)|string): boolean|void
     /**
      * Fired when a group is going to be expanded or collapsed using the UI.
      * Returning `false` from a listener prevents the operation
@@ -2672,7 +2687,7 @@ const emit = defineEmits<{
      * @param {boolean} params.event.collapse Collapsed (true) or expanded (false)
      * @param {Event} params.event.domEvent The user interaction event (eg a `click` event) if the toggle request was instigated by user interaction.
      */
-    (e: 'beforeToggleGroup', params: ((event: { groupRecord: Model, groupRecords: Model[], collapse: boolean, domEvent: Event }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeToggleGroup', params: ((event: { groupRecord: Model, groupRecords: Model[], collapse: boolean, domEvent: Event }) => boolean|void)|string): boolean|void
     /**
      * Fired before a parent node record toggles its collapsed state.
      * @param {string} e Event name
@@ -2755,7 +2770,7 @@ const emit = defineEmits<{
      * @param {Grid.column.Column} params.event.column Column
      * @param {Core.data.Model} params.event.record Record
      */
-    (e: 'cellMenuBeforeShow', params: ((event: { source: Grid, menu: Menu, items: Record<string, MenuItemEntry>, column: Column, record: Model }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'cellMenuBeforeShow', params: ((event: { source: Grid, menu: Menu, items: Record<string, MenuItemEntry>, column: Column, record: Model }) => boolean|void)|string): boolean|void
     /**
      * This event fires on the owning grid when an item is selected in the cell context menu.
      * @param {string} e Event name
@@ -2908,7 +2923,7 @@ const emit = defineEmits<{
      * @param {Event} params.event.event The browser event.
      * @param {string} params.event.region The region where the column was dropped.
      */
-    (e: 'columnDrop', params: ((event: { source: Grid, column: Column, insertBefore: Column, newParent: Column, valid: boolean, event: Event, region: string }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'columnDrop', params: ((event: { source: Grid, column: Column, insertBefore: Column, newParent: Column, valid: boolean, event: Event, region: string }) => boolean|void)|string): boolean|void
     /**
      * This event is fired after a resize gesture is completed.
      * @param {string} e Event name
@@ -3067,7 +3082,7 @@ const emit = defineEmits<{
      * @param {HTMLElement} params.event.element
      * @param {MouseEvent} [params.event.event] Pointer event which triggered the context menu (if any)
      */
-    (e: 'dependencyMenuBeforeShow', params: ((event: { source: Scheduler, items: Record<string, MenuItemEntry>, dependencyRecord: DependencyModel, element: HTMLElement, event?: MouseEvent }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'dependencyMenuBeforeShow', params: ((event: { source: Scheduler, items: Record<string, MenuItemEntry>, dependencyRecord: DependencyModel, element: HTMLElement, event?: MouseEvent }) => boolean|void)|string): boolean|void
     /**
      * This event fires on the owning Scheduler when an item is selected in the context menu.
      * @param {string} e Event name
@@ -3393,7 +3408,7 @@ const emit = defineEmits<{
      * @param {HTMLElement} params.event.eventElement
      * @param {MouseEvent} [params.event.event] Pointer event which triggered the context menu (if any)
      */
-    (e: 'eventMenuBeforeShow', params: ((event: { source: Scheduler, items: Record<string, MenuItemEntry>, eventRecord: EventModel, resourceRecord: ResourceModel, assignmentRecord: AssignmentModel, eventElement: HTMLElement, event?: MouseEvent }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'eventMenuBeforeShow', params: ((event: { source: Scheduler, items: Record<string, MenuItemEntry>, eventRecord: EventModel, resourceRecord: ResourceModel, assignmentRecord: AssignmentModel, eventElement: HTMLElement, event?: MouseEvent }) => boolean|void)|string): boolean|void
     /**
      * This event fires on the owning Scheduler when an item is selected in the context menu.
      * @param {string} e Event name
@@ -3654,7 +3669,7 @@ const emit = defineEmits<{
      * @param {Grid.util.GridLocation} params.event.cell Information about the column / record
      * @param {MouseEvent} params.event.domEvent The raw DOM event
      */
-    (e: 'fillHandleDragStart', params: ((event: { cell: GridLocation, domEvent: MouseEvent }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'fillHandleDragStart', params: ((event: { cell: GridLocation, domEvent: MouseEvent }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Grid when cell editing is finished
      * @param {string} e Event name
@@ -3712,7 +3727,7 @@ const emit = defineEmits<{
      * @param {Core.data.Model[]} params.event.context.records The dragged row records
      * @param {MouseEvent,TouchEvent} params.event.event
      */
-    (e: 'gridRowBeforeDragStart', params: ((event: { source: GridBase, context: { records: Model[] }, event: MouseEvent|TouchEvent }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'gridRowBeforeDragStart', params: ((event: { source: GridBase, context: { records: Model[] }, event: MouseEvent|TouchEvent }) => boolean|void)|string): boolean|void
     /**
      * Fired before the row drop operation is finalized. You can return false to abort the drop operation, or a
      * Promise yielding `true` / `false` which allows for asynchronous abort (e.g. first show user a confirmation dialog).
@@ -3791,7 +3806,7 @@ const emit = defineEmits<{
      * @param {Event} params.event.domEvent The triggering DOM event.
      * @param {Grid.column.Column} params.event.column The column clicked on.
      */
-    (e: 'headerClick', params: ((event: { domEvent: Event, column: Column }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'headerClick', params: ((event: { domEvent: Event, column: Column }) => boolean|void)|string): boolean|void
     /**
      * This event fires on the owning Grid before the context menu is shown for a header.
      * Allows manipulation of the items to show in the same way as in the [processItems](https://bryntum.com/products/calendar/docs/api/Grid/feature/HeaderMenu#config-processItems).
@@ -3804,7 +3819,7 @@ const emit = defineEmits<{
      * @param {Record<string, MenuItemEntry>} params.event.items Menu item configs
      * @param {Grid.column.Column} params.event.column Column
      */
-    (e: 'headerMenuBeforeShow', params: ((event: { source: Grid, menu: Menu, items: Record<string, MenuItemEntry>, column: Column }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'headerMenuBeforeShow', params: ((event: { source: Grid, menu: Menu, items: Record<string, MenuItemEntry>, column: Column }) => boolean|void)|string): boolean|void
     /**
      * This event fires on the owning Grid when an item is selected in the header context menu.
      * @param {string} e Event name
@@ -3956,7 +3971,7 @@ const emit = defineEmits<{
      * @param {Scheduler.preset.ViewPreset} params.event.from The outgoing ViewPreset.
      * @param {Scheduler.preset.ViewPreset} params.event.to The ViewPreset being switched to.
      */
-    (e: 'presetChange', params: ((event: { source: Scheduler, startDate: Date, centerDate: Date, endDate: Date, from: ViewPreset, to: ViewPreset }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'presetChange', params: ((event: { source: Scheduler, startDate: Date, centerDate: Date, endDate: Date, from: ViewPreset, to: ViewPreset }) => boolean|void)|string): boolean|void
     /**
      * Fired when a Widget's read only state is toggled
      * @param {string} e Event name
@@ -4039,7 +4054,7 @@ const emit = defineEmits<{
      * @param {Scheduler.model.ResourceModel} params.event.context.resource The dragged resource
      * @param {MouseEvent,TouchEvent} params.event.event
      */
-    (e: 'resourceColumnBeforeDragStart', params: ((event: { source: Scheduler, context: { resource: ResourceModel }, event: MouseEvent|TouchEvent }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'resourceColumnBeforeDragStart', params: ((event: { source: Scheduler, context: { resource: ResourceModel }, event: MouseEvent|TouchEvent }) => boolean|void)|string): boolean|void
     /**
      * Fired before the drop is finalized. You can return `false` or a Promise that resolves to `false`
      * to cancel the drop operation.
@@ -4148,7 +4163,7 @@ const emit = defineEmits<{
      * @param {Grid.column.Column} params.event.column Column
      * @param {Scheduler.model.ResourceModel} params.event.resourceRecord Record
      */
-    (e: 'resourceMenuBeforeShow', params: ((event: { source: Scheduler, menu: Menu, items: Record<string, MenuItemEntry>, column: Column, resourceRecord: ResourceModel }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'resourceMenuBeforeShow', params: ((event: { source: Scheduler, menu: Menu, items: Record<string, MenuItemEntry>, column: Column, resourceRecord: ResourceModel }) => boolean|void)|string): boolean|void
     /**
      * This event fires on the owning scheduler when an item is selected in the context menu.
      * @param {string} e Event name
@@ -4394,7 +4409,7 @@ const emit = defineEmits<{
      * @param {Scheduler.model.AssignmentModel} params.event.assignmentRecord Assignment record, if assignments are used
      * @param {HTMLElement} params.event.eventElement
      */
-    (e: 'scheduleMenuBeforeShow', params: ((event: { source: Scheduler, items: Record<string, MenuItemEntry>, resourceRecord: ResourceModel, date: Date, assignmentRecord: AssignmentModel, eventElement: HTMLElement }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'scheduleMenuBeforeShow', params: ((event: { source: Scheduler, items: Record<string, MenuItemEntry>, resourceRecord: ResourceModel, date: Date, assignmentRecord: AssignmentModel, eventElement: HTMLElement }) => boolean|void)|string): boolean|void
     /**
      * This event fires on the owning Scheduler or Gantt widget when an item is selected in the context menu.
      * @param {string} e Event name
@@ -4508,7 +4523,7 @@ const emit = defineEmits<{
      * @param {Event} params.event.domEvent DOM event
      * @param {Scheduler.model.ResourceModel} params.event.resourceRecord The resource record
      */
-    (e: 'scrollButtonClick', params: ((event: { domEvent: Event, resourceRecord: ResourceModel }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'scrollButtonClick', params: ((event: { domEvent: Event, resourceRecord: ResourceModel }) => boolean|void)|string): boolean|void
     /**
      * The selection has been changed.
      * @param {string} e Event name
@@ -4574,7 +4589,7 @@ const emit = defineEmits<{
      * @param {Grid.view.SubGrid} params.event.subGrid The subgrid
      * @param {Event} params.event.domEvent The native DOM event
      */
-    (e: 'splitterCollapseClick', params: ((event: { source: Grid, subGrid: SubGrid, domEvent: Event }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'splitterCollapseClick', params: ((event: { source: Grid, subGrid: SubGrid, domEvent: Event }) => boolean|void)|string): boolean|void
     /**
      * Fired by the Grid after a sub-grid has been resized using the splitter
      * @param {string} e Event name
@@ -4605,7 +4620,7 @@ const emit = defineEmits<{
      * @param {Grid.view.SubGrid} params.event.subGrid The subgrid
      * @param {Event} params.event.domEvent The native DOM event
      */
-    (e: 'splitterExpandClick', params: ((event: { source: Grid, subGrid: SubGrid, domEvent: Event }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'splitterExpandClick', params: ((event: { source: Grid, subGrid: SubGrid, domEvent: Event }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Grid when editing starts
      * @param {string} e Event name
@@ -4778,7 +4793,7 @@ const emit = defineEmits<{
      * @param {Record<string, MenuItemEntry>} params.event.items Menu item configs
      * @param {Grid.column.Column} params.event.column Time axis column
      */
-    (e: 'timeAxisHeaderMenuBeforeShow', params: ((event: { source: Scheduler, menu: Menu, items: Record<string, MenuItemEntry>, column: Column }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'timeAxisHeaderMenuBeforeShow', params: ((event: { source: Scheduler, menu: Menu, items: Record<string, MenuItemEntry>, column: Column }) => boolean|void)|string): boolean|void
     /**
      * This event fires on the owning Scheduler or Gantt widget when an item is selected in the header context menu.
      * @param {string} e Event name
@@ -5043,6 +5058,7 @@ const widgetData = {
         'preserveFocusOnDatasetChange',
         'preserveScrollOnDatasetChange',
         'preventTooltipOnTouch',
+        'projectModelClass',
         'relayStoreEvents',
         'resizable',
         'resizeToFitIncludesHeader',

package/src/components/BryntumSchedulerBaseProps.ts

@@ -57,6 +57,8 @@ export declare type BryntumSchedulerBaseProps = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/view/SchedulerBase#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -664,10 +666,14 @@ export declare type BryntumSchedulerBaseProps = {
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/view/SchedulerBase#config-insertBefore)
      */
     insertBefore ? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/view/SchedulerBase#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -920,7 +926,12 @@ export declare type BryntumSchedulerBaseProps = {
      * Can be omitted in favor of individual store configs or [crudManager](https://bryntum.com/products/calendar/docs/api/Scheduler/view/mixin/SchedulerStores#config-crudManager) config.
      * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/view/SchedulerBase#config-project)
      */
-    project ? : ProjectModel|ProjectModelConfig|object
+    project ? : ProjectModel|ProjectModelConfig|object|null
+    /**
+     * The project model class to use when creating the project instance. Override this to use a custom project
+     * model class. In SchedulerPro and Gantt, this is overridden to use their respective project model classes.
+     */
+    projectModelClass ? : typeof ProjectModel
     /**
      * Range used to set the length of the time axis when used as a component of a Calendar. Suitable units are
      * `'month'`, `'week'` and `'day'`.

package/src/components/BryntumSchedulerDatePicker.vue

@@ -55,6 +55,8 @@ defineProps<{
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/widget/SchedulerDatePicker#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -415,10 +417,14 @@ defineProps<{
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/widget/SchedulerDatePicker#config-insertBefore)
      */
     insertBefore ? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/widget/SchedulerDatePicker#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -873,7 +879,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {Core.widget.Widget} params.event.source The widget being hidden.
      */
-    (e: 'beforeHide', params: ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeHide', params: ((event: { source: Widget }) => boolean|void)|string): boolean|void
     /**
      * Fires before this CalendarPanel refreshes in response to changes in its month.
      * @param {string} e Event name
@@ -907,7 +913,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {any} params.event.state State object config
      */
-    (e: 'beforeStateApply', params: ((event: { state: any }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeStateApply', params: ((event: { state: any }) => boolean|void)|string): boolean|void
     /**
      * Fired before state is saved by the StateProvider. Allows editing the state object or preventing the operation.
      * @param {string} e Event name
@@ -915,7 +921,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {any} params.event.state State object config
      */
-    (e: 'beforeStateSave', params: ((event: { state: any }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeStateSave', params: ((event: { state: any }) => boolean|void)|string): boolean|void
     /**
      * Fires when any other event is fired from the object.
      * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/widget/SchedulerDatePicker#event-catchAll)

package/src/components/BryntumSchedulerDatePickerProps.ts

@@ -41,6 +41,8 @@ export declare type BryntumSchedulerDatePickerProps = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/widget/SchedulerDatePicker#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -401,10 +403,14 @@ export declare type BryntumSchedulerDatePickerProps = {
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/widget/SchedulerDatePicker#config-insertBefore)
      */
     insertBefore ? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Scheduler/widget/SchedulerDatePicker#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**