@bryntum/calendar-vue-3 7.3.0 → 7.3.2

package/src/components/BryntumCalendar.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/Calendar/view/Calendar#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -239,7 +241,7 @@ defineProps<{
      * or [drag-create](https://bryntum.com/products/calendar/docs/api/Calendar/feature/CalendarDrag), or [dragging in](#Calendar/feature/ExternalEventSource).
      * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/view/Calendar#config-defaultCalendar)
      */
-    defaultCalendar ? : string|ResourceModel
+    defaultCalendar ? : string|number|ResourceModel
     /**
      * A [query](https://bryntum.com/products/calendar/docs/api/Core/widget/Container#function-query) selector function which can identify the descendant widget to which
      * focus should be directed by default.
@@ -444,10 +446,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/Calendar/view/Calendar#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/Calendar/view/Calendar#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -675,7 +681,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/Calendar/view/Calendar#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
     /**
      * The names of properties which are propagated down from the Calendar to child views
      * unless the view has its own value for that property.
@@ -1126,7 +1137,7 @@ const emit = defineEmits<{
      * @param {CalendarView} params.event.prevActiveItem The previously active view.
      * @param {CalendarView} params.event.activeItem The new active view.
      */
-    (e: 'beforeActiveItemChange', params: ((event: { source: Calendar, prevActiveItem: CalendarView, activeItem: CalendarView }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeActiveItemChange', params: ((event: { source: Calendar, prevActiveItem: CalendarView, activeItem: CalendarView }) => boolean|void)|string): boolean|void
     /**
      * Fires before an assignment is removed. Can be triggered by user pressing <kbd>Delete</kbd> or <kbd>Backspace</kbd> or
      * by the event editor. Can for example be used to display a custom dialog to confirm deletion, in which
@@ -1154,7 +1165,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 a child view's [autoCreate gesture](https://bryntum.com/products/calendar/docs/api/Calendar/widget/mixin/CalendarMixin#config-autoCreate) is detected and also when a [drag-create](#Calendar/feature/CalendarDrag) gesture is detected.
      * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/view/Calendar#event-beforeAutoCreate)
@@ -1168,7 +1179,7 @@ const emit = defineEmits<{
      * @param {Date} params.event.endDate The ending time of the event to be created.
      * @param {Scheduler.model.ResourceModel} params.event.resourceRecord The resource if the UI includes a resource.
      */
-    (e: 'beforeAutoCreate', params: ((event: { source: CalendarView, domEvent: Event, date: Date, startDate: Date, endDate: Date, resourceRecord: ResourceModel }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeAutoCreate', params: ((event: { source: CalendarView, domEvent: Event, date: Date, startDate: Date, endDate: Date, resourceRecord: ResourceModel }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Scheduler before a copy action is performed, return `false` to prevent the action
      * @param {string} e Event name
@@ -1189,7 +1200,7 @@ const emit = defineEmits<{
      * @param {Calendar.view.Calendar} params.event.source This Calendar
      * @param {AgendaViewConfig,DayResourceViewConfig,DayViewConfig,EventListConfig,MonthViewConfig,ResourceViewConfig,WeekViewConfig,YearViewConfig,DayAgendaViewConfig,MonthAgendaViewConfig,ContainerItemConfig} params.event.config The configuration block of the mode about to be created. Any property, including the `type` may be changed.
      */
-    (e: 'beforeCreateMode', params: ((event: { source: Calendar, config: AgendaViewConfig|DayResourceViewConfig|DayViewConfig|EventListConfig|MonthViewConfig|ResourceViewConfig|WeekViewConfig|YearViewConfig|DayAgendaViewConfig|MonthAgendaViewConfig|ContainerItemConfig }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeCreateMode', params: ((event: { source: Calendar, config: AgendaViewConfig|DayResourceViewConfig|DayViewConfig|EventListConfig|MonthViewConfig|ResourceViewConfig|WeekViewConfig|YearViewConfig|DayAgendaViewConfig|MonthAgendaViewConfig|ContainerItemConfig }) => boolean|void)|string): boolean|void
     /**
      * Fires on the owning Grid before CSV export starts. Return `false` to cancel the export.
      * @param {string} e Event name
@@ -1201,7 +1212,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 before an object is destroyed.
      * @param {string} e Event name
@@ -1224,7 +1235,7 @@ const emit = defineEmits<{
      * @param {Calendar.feature.CalendarDrag} params.event.feature The Calendar drag feature instance.
      * @param {CalendarView} params.event.view The Calendar widget in which the drag is being started.
      */
-    (e: 'beforeDragCreate', params: ((event: { source: Calendar, drag: DragContext, domEvent: Event, date: Date, resourceRecord?: ResourceModel, feature: CalendarDrag, view: CalendarView }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeDragCreate', params: ((event: { source: Calendar, drag: DragContext, domEvent: Event, date: Date, resourceRecord?: ResourceModel, feature: CalendarDrag, view: CalendarView }) => boolean|void)|string): boolean|void
     /**
      * This event fires on the owning Calendar before a drag creation gesture is completed. Return `false` to
      * immediately veto the operation or a Promise yielding `true` or `false` for async vetoing.
@@ -1258,7 +1269,7 @@ const emit = defineEmits<{
      * @param {Calendar.feature.CalendarDrag} params.event.feature The Calendar drag feature instance.
      * @param {CalendarView} params.event.view The Calendar widget in which the drag is being started.
      */
-    (e: 'beforeDragMove', params: ((event: { source: Calendar, drag: DragContext, domEvent: Event, eventRecord: EventModel, date: Date, resourceRecord?: ResourceModel, feature: CalendarDrag, view: CalendarView }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeDragMove', params: ((event: { source: Calendar, drag: DragContext, domEvent: Event, eventRecord: EventModel, date: Date, resourceRecord?: ResourceModel, feature: CalendarDrag, view: CalendarView }) => boolean|void)|string): boolean|void
     /**
      * This event fires on the owning Calendar before a drag move gesture is completed. Return `false` to immediately veto the operation
      * or a Promise yielding `true` or `false` for async vetoing.
@@ -1293,7 +1304,7 @@ const emit = defineEmits<{
      * @param {Calendar.feature.CalendarDrag} params.event.feature The Calendar drag feature instance.
      * @param {CalendarView} params.event.view The Calendar widget in which the drag is being started.
      */
-    (e: 'beforeDragResize', params: ((event: { source: Calendar, drag: DragContext, domEvent: Event, eventRecord: EventModel, date: Date, resourceRecord?: ResourceModel, feature: CalendarDrag, view: CalendarView }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeDragResize', params: ((event: { source: Calendar, drag: DragContext, domEvent: Event, eventRecord: EventModel, date: Date, resourceRecord?: ResourceModel, feature: CalendarDrag, view: CalendarView }) => boolean|void)|string): boolean|void
     /**
      * This event fires on the owning Calendar before a drag resize gesture is completed. Return `false` to immediately veto the operation
      * or a Promise yielding `true` or `false` for async vetoing.
@@ -1333,7 +1344,7 @@ const emit = defineEmits<{
      * @param {boolean} params.event.metaKey `true` if the Meta key was down when the last event was processed.
      * @param {boolean} params.event.shiftKey `true` if the Shift key was down when the last event was processed.
      */
-    (e: 'beforeDropExternal', params: ((event: { eventRecord: EventModel, dropOnCalendar: boolean, itemElement: HTMLElement, targetElement: HTMLElement, domEvent: Event, overIndex: number, overRecord: Model, isAbove: boolean, altKey: boolean, ctrlKey: boolean, metaKey: boolean, shiftKey: boolean }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeDropExternal', params: ((event: { eventRecord: EventModel, dropOnCalendar: boolean, itemElement: HTMLElement, targetElement: HTMLElement, domEvent: Event, overIndex: number, overRecord: Model, isAbove: boolean, altKey: boolean, ctrlKey: boolean, metaKey: boolean, shiftKey: boolean }) => 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. Can for example be used to display a custom dialog to confirm deletion, in which case
@@ -1348,7 +1359,7 @@ const emit = defineEmits<{
      * @param {Function} params.event.context.finalize Function to call to finalize the removal. Used to asynchronously decide to remove the records or not. Provide `false` to the function to prevent the removal.
      * @param {boolean} [params.event.context.finalize.removeRecords] Provide `false` to the function to prevent the removal.
      */
-    (e: 'beforeEventDelete', params: ((event: { source: Calendar, eventRecords: EventModel[], context: { finalize: { removeRecords?: boolean } } }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeEventDelete', params: ((event: { source: Calendar, eventRecords: EventModel[], context: { finalize: { removeRecords?: boolean } } }) => boolean|void)|string): boolean|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`
@@ -1363,7 +1374,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.
@@ -1406,7 +1417,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
@@ -1416,7 +1427,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
     /**
      * Triggered before a widget is hidden. Return `false` to prevent the action.
      * @param {string} e Event name
@@ -1424,7 +1435,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 before a paste action is performed, return `false` to prevent the action.
      * Depending on if the EventStore is using [singleAssignment](https://bryntum.com/products/calendar/docs/api/Scheduler/data/EventStore#config-singleAssignment) or the
@@ -1452,7 +1463,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {object} params.event.config Print config
      */
-    (e: 'beforePrint', params: ((event: { config: object }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforePrint', params: ((event: { config: object }) => boolean|void)|string): boolean|void
     /**
      * Triggered before a new [responsiveState](https://bryntum.com/products/calendar/docs/api/Core/widget/mixin/Responsive#config-responsiveState) is applied.
      * @param {string} e Event name
@@ -1488,7 +1499,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
@@ -1496,7 +1507,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/Calendar/view/Calendar#event-catchAll)
@@ -1682,7 +1693,7 @@ const emit = defineEmits<{
      * @param {DayCell} params.event.cellData An object that contains data about the calendar cell for the date.
      * @param {boolean} params.event.fromOverflowPopup `true` if the interaction was through the source view's [overflowPopup](https://bryntum.com/products/calendar/docs/api/Calendar/widget/mixin/DayCellRenderer#property-overflowPopup).
      */
-    (e: 'dayNumberClick', params: ((event: { source: CalendarView, domEvent: Event, date: Date, cellData: DayCell, fromOverflowPopup: boolean }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'dayNumberClick', params: ((event: { source: CalendarView, domEvent: Event, date: Date, cellData: DayCell, fromOverflowPopup: boolean }) => boolean|void)|string): boolean|void
     /**
      * Fires when an object is destroyed.
      * @param {string} e Event name
@@ -1897,7 +1908,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
@@ -2093,7 +2104,7 @@ const emit = defineEmits<{
      * @param {number} params.event.month The month index *(zero based)* clicked on.
      * @param {Date} params.event.date The date of the first of the month clicked on.
      */
-    (e: 'monthNameClick', params: ((event: { source: CalendarView, domEvent: Event, month: number, date: Date }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'monthNameClick', params: ((event: { source: CalendarView, domEvent: Event, month: number, date: Date }) => boolean|void)|string): boolean|void
     /**
      * Fired when a user gesture causes the active item to change.
      * @param {string} e Event name
@@ -2260,7 +2271,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
@@ -2441,7 +2452,7 @@ const emit = defineEmits<{
      * @param {number[]} params.event.week The `[year, week]` clicked on.
      * @param {Date} params.event.date The date clicked on.
      */
-    (e: 'weekNumberClick', params: ((event: { source: CalendarView, domEvent: Event, week: number[], date: Date }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'weekNumberClick', params: ((event: { source: CalendarView, domEvent: Event, week: number[], date: Date }) => boolean|void)|string): boolean|void
 }>();
 
 const widgetData = {
@@ -2499,7 +2510,6 @@ const widgetData = {
         'dataField',
         'datePicker',
         'defaultBindProperty',
-        'defaultCalendar',
         'defaultFocus',
         'defaults',
         'deselectOnClick',
@@ -2545,6 +2555,7 @@ const widgetData = {
         'overlaySidebar',
         'positioned',
         'preventTooltipOnTouch',
+        'projectModelClass',
         'propagatedConfigs',
         'relayStoreEvents',
         'resourceImagePath',
@@ -2597,6 +2608,7 @@ const widgetData = {
         'dataset',
         'date',
         'dateFormat',
+        'defaultCalendar',
         'deselectAllOnScheduleClick',
         'disabled',
         'events',

package/src/components/BryntumCalendarDatePicker.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/Calendar/widget/CalendarDatePicker#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -492,10 +494,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/Calendar/widget/CalendarDatePicker#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/Calendar/widget/CalendarDatePicker#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -950,7 +956,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
@@ -984,7 +990,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
@@ -992,7 +998,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/Calendar/widget/CalendarDatePicker#event-catchAll)

package/src/components/BryntumCalendarDatePickerProps.ts

@@ -41,6 +41,8 @@ export declare type BryntumCalendarDatePickerProps = {
     /**
      * 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/Calendar/widget/CalendarDatePicker#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -478,10 +480,14 @@ export declare type BryntumCalendarDatePickerProps = {
     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/Calendar/widget/CalendarDatePicker#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/Calendar/widget/CalendarDatePicker#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**

package/src/components/BryntumCalendarProps.ts

@@ -34,6 +34,8 @@ export declare type BryntumCalendarProps = {
     /**
      * 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/Calendar/view/Calendar#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -202,7 +204,7 @@ export declare type BryntumCalendarProps = {
      * or [drag-create](https://bryntum.com/products/calendar/docs/api/Calendar/feature/CalendarDrag), or [dragging in](#Calendar/feature/ExternalEventSource).
      * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/view/Calendar#config-defaultCalendar)
      */
-    defaultCalendar ? : string|ResourceModel
+    defaultCalendar ? : string|number|ResourceModel
     /**
      * A [query](https://bryntum.com/products/calendar/docs/api/Core/widget/Container#function-query) selector function which can identify the descendant widget to which
      * focus should be directed by default.
@@ -407,10 +409,14 @@ export declare type BryntumCalendarProps = {
     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/Calendar/view/Calendar#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/Calendar/view/Calendar#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -638,7 +644,12 @@ export declare type BryntumCalendarProps = {
      * 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/Calendar/view/Calendar#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
     /**
      * The names of properties which are propagated down from the Calendar to child views
      * unless the view has its own value for that property.

package/src/components/BryntumChatPanel.vue

@@ -46,6 +46,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/Core/widget/chat/ChatPanel#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -318,10 +320,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/Core/widget/chat/ChatPanel#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/Core/widget/chat/ChatPanel#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -696,7 +702,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
     /**
      * 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)
@@ -722,7 +728,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
@@ -730,7 +736,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
     /**
      * Fired when the chat bubble tool icon is clicked.
      * @param {string} e Event name

package/src/components/BryntumChatPanelProps.ts

@@ -32,6 +32,8 @@ export declare type BryntumChatPanelProps = {
     /**
      * 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/Core/widget/chat/ChatPanel#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -304,10 +306,14 @@ export declare type BryntumChatPanelProps = {
     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/Core/widget/chat/ChatPanel#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/Core/widget/chat/ChatPanel#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**

package/src/components/BryntumCheckbox.vue

@@ -42,6 +42,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/Core/widget/Checkbox#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -108,6 +110,15 @@ defineProps<{
      * A value of `undefined` will cause this widget not to include its value when checked.
      */
     checkedValue ? : any
+    /**
+     * A function (or the name of a function in the ownership hierarchy) called during field validation
+     * to perform custom validity checks. The function is called as part of the [isValid](https://bryntum.com/products/calendar/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/calendar/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Core/widget/Checkbox#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity ? : ((field: Field) => void)|string
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -296,10 +307,14 @@ defineProps<{
     inputWidth ? : string|number
     /**
      * 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/Core/widget/Checkbox#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/Core/widget/Checkbox#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -624,7 +639,7 @@ const emit = defineEmits<{
      * @param {boolean} params.event.valid True if this field is in a valid state.
      * @param {Event} params.event.event The triggering DOM event if any
      */
-    (e: 'beforeChange', params: ((event: { source: Checkbox, checked: boolean, value: boolean, oldValue: boolean, userAction: boolean, valid: boolean, event: Event }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeChange', params: ((event: { source: Checkbox, checked: boolean, value: boolean, oldValue: boolean, userAction: boolean, valid: boolean, event: Event }) => boolean|void)|string): boolean|void
     /**
      * Fires before an object is destroyed.
      * @param {string} e Event name
@@ -640,7 +655,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
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {string} e Event name
@@ -824,6 +839,7 @@ const widgetData = {
         'bubbleEvents',
         'centered',
         'checkedValue',
+        'checkValidity',
         'color',
         'config',
         'constrainTo',

package/src/components/BryntumCheckboxGroup.vue

@@ -42,6 +42,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/Core/widget/CheckboxGroup#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -305,10 +307,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/Core/widget/CheckboxGroup#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/Core/widget/CheckboxGroup#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -709,7 +715,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
     /**
      * 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)
@@ -735,7 +741,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
@@ -743,7 +749,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/Core/widget/CheckboxGroup#event-catchAll)

package/src/components/BryntumCheckboxGroupProps.ts

@@ -28,6 +28,8 @@ export declare type BryntumCheckboxGroupProps = {
     /**
      * 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/Core/widget/CheckboxGroup#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -291,10 +293,14 @@ export declare type BryntumCheckboxGroupProps = {
     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/Core/widget/CheckboxGroup#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/Core/widget/CheckboxGroup#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**