@bryntum/scheduler-vue-3-thin 7.3.0 → 7.3.2

package/src/components/BryntumSchedulerBaseProps.ts

@@ -58,6 +58,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/scheduler/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/scheduler/docs/api/Scheduler/view/SchedulerBase#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -665,10 +667,14 @@ export declare type BryntumSchedulerBaseProps = {
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/scheduler/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/scheduler/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/scheduler/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/scheduler/docs/api/Scheduler/view/SchedulerBase#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -921,7 +927,12 @@ export declare type BryntumSchedulerBaseProps = {
      * Can be omitted in favor of individual store configs or [crudManager](https://bryntum.com/products/scheduler/docs/api/Scheduler/view/mixin/SchedulerStores#config-crudManager) config.
      * [More...](https://bryntum.com/products/scheduler/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

@@ -56,6 +56,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/scheduler/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/scheduler/docs/api/Scheduler/widget/SchedulerDatePicker#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -416,10 +418,14 @@ defineProps<{
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/scheduler/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/scheduler/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/scheduler/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/scheduler/docs/api/Scheduler/widget/SchedulerDatePicker#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -863,30 +869,24 @@ const emit = defineEmits<{
      * Fires before an object is destroyed.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.Base} params.params.event.source The Object that is being destroyed.
+     * @param {object} params.event Event object
+     * @param {Core.Base} params.event.source The Object that is being destroyed.
      */
     (e: 'beforeDestroy', params: ((event: { source: Base }) => void)|string): void
     /**
      * Triggered before a widget is hidden. Return `false` to prevent the action.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.Widget} params.params.event.source The widget being hidden.
+     * @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
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.DatePicker} params.params.event.source This DatePicker.
+     * @param {object} params.event Event object
+     * @param {Core.widget.DatePicker} params.event.source This DatePicker.
      */
     (e: 'beforeRefresh', params: ((event: { source: DatePicker }) => void)|string): void
     /**
@@ -894,148 +894,122 @@ const emit = defineEmits<{
      * want to modify the UI before data is loaded (e.g. set some input field to be readonly)
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.Container} params.params.event.source The container
-     * @param {Core.data.Model} params.params.event.record The record
+     * @param {object} params.event Event object
+     * @param {Core.widget.Container} params.event.source The container
+     * @param {Core.data.Model} params.event.record The record
      */
     (e: 'beforeSetRecord', params: ((event: { source: Container, record: Model }) => void)|string): void
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.Widget,any} params.params.event.source The widget being shown
+     * @param {object} params.event Event object
+     * @param {Core.widget.Widget,any} params.event.source The widget being shown
      */
     (e: 'beforeShow', params: ((event: { source: Widget|any }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
     /**
      * Fired before state is applied to the source. Allows editing the state object or preventing the operation.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {any} params.params.event.state State object config
+     * @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
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {any} params.params.event.state State object config
+     * @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/scheduler/docs/api/Scheduler/widget/SchedulerDatePicker#event-catchAll)
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {{[key: string]: any, type: string}} params.params.event.event The Object that contains event details
-     * @param {string} params.params.event.event.type The type of the event which is caught by the listener
+     * @param {object} params.event Event object
+     * @param {{[key: string]: any, type: string}} params.event.event The Object that contains event details
+     * @param {string} params.event.event.type The type of the event which is caught by the listener
      */
     (e: 'catchAll', params: ((event: {[key: string]: any, type: string}) => void)|string): void
     /**
      * Fired when a date cell is clicked.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {HTMLElement} params.params.event.cell The clicked cell element.
-     * @param {Date} params.params.event.date The date represented by the cell.
-     * @param {number[]} params.params.event.week The week array `[year, weekNumber]`.
-     * @param {Event} params.params.event.domEvent The original DOM event.
+     * @param {object} params.event Event object
+     * @param {HTMLElement} params.event.cell The clicked cell element.
+     * @param {Date} params.event.date The date represented by the cell.
+     * @param {number[]} params.event.week The week array `[year, weekNumber]`.
+     * @param {Event} params.event.domEvent The original DOM event.
      */
     (e: 'cellClick', params: ((event: { cell: HTMLElement, date: Date, week: number[], domEvent: Event }) => void)|string): void
     /**
      * Fires when a Panel is collapsed using the [collapsible](https://bryntum.com/products/scheduler/docs/api/Core/widget/Panel#config-collapsible) setting.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.Panel} params.params.event.source This Panel.
+     * @param {object} params.event Event object
+     * @param {Core.widget.Panel} params.event.source This Panel.
      */
     (e: 'collapse', params: ((event: { source: Panel }) => void)|string): void
     /**
      * Fires when the date of this CalendarPanel is set.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Date} params.params.event.value The new date.
-     * @param {Date} params.params.event.oldValue The old date.
-     * @param {object} params.params.event.changes An object which contains properties which indicate what part of the date changed.
-     * @param {boolean} params.params.event.changes.d True if the date changed in any way.
-     * @param {boolean} params.params.event.changes.w True if the week changed (including same week in a different year).
-     * @param {boolean} params.params.event.changes.m True if the month changed (including same month in a different year).
-     * @param {boolean} params.params.event.changes.y True if the year changed.
+     * @param {object} params.event Event object
+     * @param {Date} params.event.value The new date.
+     * @param {Date} params.event.oldValue The old date.
+     * @param {object} params.event.changes An object which contains properties which indicate what part of the date changed.
+     * @param {boolean} params.event.changes.d True if the date changed in any way.
+     * @param {boolean} params.event.changes.w True if the week changed (including same week in a different year).
+     * @param {boolean} params.event.changes.m True if the month changed (including same month in a different year).
+     * @param {boolean} params.event.changes.y True if the year changed.
      */
     (e: 'dateChange', params: ((event: { value: Date, oldValue: Date, changes: { d: boolean, w: boolean, m: boolean, y: boolean } }) => void)|string): void
     /**
      * Fires when an object is destroyed.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.Base} params.params.event.source The Object that is being destroyed.
+     * @param {object} params.event Event object
+     * @param {Core.Base} params.event.source The Object that is being destroyed.
      */
     (e: 'destroy', params: ((event: { source: Base }) => void)|string): void
     /**
      * Fires when a field is mutated and the state of the [hasChanges](https://bryntum.com/products/scheduler/docs/api/Core/widget/Container#property-hasChanges) property changes
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.Container} params.params.event.source The container.
-     * @param {boolean} params.params.event.dirty The dirty state of the Container - `true` if there are any fields which have been changed since initial load.
+     * @param {object} params.event Event object
+     * @param {Core.widget.Container} params.event.source The container.
+     * @param {boolean} params.event.dirty The dirty state of the Container - `true` if there are any fields which have been changed since initial load.
      */
     (e: 'dirtyStateChange', params: ((event: { source: Container, dirty: boolean }) => void)|string): void
     /**
      * Triggered when a widget's [element](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#property-element) is available.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {HTMLElement} params.params.event.element The Widget's element.
+     * @param {object} params.event Event object
+     * @param {HTMLElement} params.event.element The Widget's element.
      */
     (e: 'elementCreated', params: ((event: { element: HTMLElement }) => void)|string): void
     /**
      * Fires when a Panel is expanded using the [collapsible](https://bryntum.com/products/scheduler/docs/api/Core/widget/Panel#config-collapsible) setting.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.Panel} params.params.event.source This Panel.
+     * @param {object} params.event Event object
+     * @param {Core.widget.Panel} params.event.source This Panel.
      */
     (e: 'expand', params: ((event: { source: Panel }) => void)|string): void
     /**
      * Fired when focus enters this Widget.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.Widget} params.params.event.source This Widget
-     * @param {HTMLElement} params.params.event.fromElement The element which lost focus.
-     * @param {HTMLElement} params.params.event.toElement The element which gained focus.
-     * @param {Core.widget.Widget} params.params.event.fromWidget The widget which lost focus.
-     * @param {Core.widget.Widget} params.params.event.toWidget The widget which gained focus.
-     * @param {boolean} params.params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
+     * @param {object} params.event Event object
+     * @param {Core.widget.Widget} params.event.source This Widget
+     * @param {HTMLElement} params.event.fromElement The element which lost focus.
+     * @param {HTMLElement} params.event.toElement The element which gained focus.
+     * @param {Core.widget.Widget} params.event.fromWidget The widget which lost focus.
+     * @param {Core.widget.Widget} params.event.toWidget The widget which gained focus.
+     * @param {boolean} params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
      */
     (e: 'focusIn', params: ((event: { source: Widget, fromElement: HTMLElement, toElement: HTMLElement, fromWidget: Widget, toWidget: Widget, backwards: boolean }) => void)|string): void
     /**
@@ -1044,25 +1018,21 @@ const emit = defineEmits<{
      * will not trigger this event. This is when focus exits this widget completely.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.Widget} params.params.event.source This Widget
-     * @param {HTMLElement} params.params.event.fromElement The element which lost focus.
-     * @param {HTMLElement} params.params.event.toElement The element which gained focus.
-     * @param {Core.widget.Widget} params.params.event.fromWidget The widget which lost focus.
-     * @param {Core.widget.Widget} params.params.event.toWidget The widget which gained focus.
-     * @param {boolean} params.params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
+     * @param {object} params.event Event object
+     * @param {Core.widget.Widget} params.event.source This Widget
+     * @param {HTMLElement} params.event.fromElement The element which lost focus.
+     * @param {HTMLElement} params.event.toElement The element which gained focus.
+     * @param {Core.widget.Widget} params.event.fromWidget The widget which lost focus.
+     * @param {Core.widget.Widget} params.event.toWidget The widget which gained focus.
+     * @param {boolean} params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
      */
     (e: 'focusOut', params: ((event: { source: Widget, fromElement: HTMLElement, toElement: HTMLElement, fromWidget: Widget, toWidget: Widget, backwards: boolean }) => void)|string): void
     /**
      * Triggered after a widget was hidden
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.Widget} params.params.event.source The widget
+     * @param {object} params.event Event object
+     * @param {Core.widget.Widget} params.event.source The widget
      */
     (e: 'hide', params: ((event: { source: Widget }) => void)|string): void
     /**
@@ -1071,21 +1041,17 @@ const emit = defineEmits<{
      * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/SchedulerDatePicker#event-paint)
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.Widget} params.params.event.source The widget being painted.
-     * @param {boolean} params.params.event.firstPaint `true` if this is the first paint.
+     * @param {object} params.event Event object
+     * @param {Core.widget.Widget} params.event.source The widget being painted.
+     * @param {boolean} params.event.firstPaint `true` if this is the first paint.
      */
     (e: 'paint', params: ((event: { source: Widget, firstPaint: boolean }) => void)|string): void
     /**
      * Fired when a Widget's read only state is toggled
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {boolean} params.params.event.readOnly Read only or not
+     * @param {object} params.event Event object
+     * @param {boolean} params.event.readOnly Read only or not
      */
     (e: 'readOnly', params: ((event: { readOnly: boolean }) => void)|string): void
     /**
@@ -1101,14 +1067,12 @@ const emit = defineEmits<{
      * Fired when the encapsulating element of a Widget resizes *only when [monitorResize](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-monitorResize) is `true`*.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.Widget} params.params.event.source This Widget
-     * @param {number} params.params.event.width The new width
-     * @param {number} params.params.event.height The new height
-     * @param {number} params.params.event.oldWidth The old width
-     * @param {number} params.params.event.oldHeight The old height
+     * @param {object} params.event Event object
+     * @param {Core.widget.Widget} params.event.source This Widget
+     * @param {number} params.event.width The new width
+     * @param {number} params.event.height The new height
+     * @param {number} params.event.oldWidth The old width
+     * @param {number} params.event.oldHeight The old height
      */
     (e: 'resize', params: ((event: { source: Widget, width: number, height: number, oldWidth: number, oldHeight: number }) => void)|string): void
     /**
@@ -1116,45 +1080,37 @@ const emit = defineEmits<{
      * this will fire upon deselection and selection of dates.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Date[]} params.params.event.selection The selected dates. If [multiSelect](https://bryntum.com/products/scheduler/docs/api/Core/widget/DatePicker#config-multiSelect) is specified this may be a two element array specifying start and end dates.
-     * @param {Date[]} params.params.event.oldSelection The previously selected dates. If [multiSelect](https://bryntum.com/products/scheduler/docs/api/Core/widget/DatePicker#config-multiSelect) is specified this may be a two element array specifying start and end dates.
-     * @param {boolean} params.params.event.userAction This will be `true` if the change was caused by user interaction as opposed to programmatic setting.
+     * @param {object} params.event Event object
+     * @param {Date[]} params.event.selection The selected dates. If [multiSelect](https://bryntum.com/products/scheduler/docs/api/Core/widget/DatePicker#config-multiSelect) is specified this may be a two element array specifying start and end dates.
+     * @param {Date[]} params.event.oldSelection The previously selected dates. If [multiSelect](https://bryntum.com/products/scheduler/docs/api/Core/widget/DatePicker#config-multiSelect) is specified this may be a two element array specifying start and end dates.
+     * @param {boolean} params.event.userAction This will be `true` if the change was caused by user interaction as opposed to programmatic setting.
      */
     (e: 'selectionChange', params: ((event: { selection: Date[], oldSelection: Date[], userAction: boolean }) => void)|string): void
     /**
      * Triggered after a widget is shown.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.Widget} params.params.event.source The widget
+     * @param {object} params.event Event object
+     * @param {Core.widget.Widget} params.event.source The widget
      */
     (e: 'show', params: ((event: { source: Widget }) => void)|string): void
     /**
      * A header [tool](https://bryntum.com/products/scheduler/docs/api/Core/widget/Panel#config-tools) has been clicked.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Core.widget.Tool} params.params.event.source This Panel.
-     * @param {Core.widget.Tool} params.params.event.tool The tool which is being clicked.
+     * @param {object} params.event Event object
+     * @param {Core.widget.Tool} params.event.source This Panel.
+     * @param {Core.widget.Tool} params.event.tool The tool which is being clicked.
      */
     (e: 'toolClick', params: ((event: { source: Tool, tool: Tool }) => void)|string): void
     /**
      * Fired when a week number cell is clicked.
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Date} params.params.event.date The start date of the week.
-     * @param {number[]} params.params.event.week The week array `[year, weekNumber]`.
-     * @param {Event} params.params.event.domEvent The original DOM event.
+     * @param {object} params.event Event object
+     * @param {Date} params.event.date The start date of the week.
+     * @param {number[]} params.event.week The week array `[year, weekNumber]`.
+     * @param {Event} params.event.domEvent The original DOM event.
      */
     (e: 'weekCellClick', params: ((event: { date: Date, week: number[], domEvent: Event }) => void)|string): void
 }>();

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/scheduler/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/scheduler/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/scheduler/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/scheduler/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/scheduler/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/scheduler/docs/api/Scheduler/widget/SchedulerDatePicker#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**

package/src/components/BryntumSchedulerProjectModel.vue

@@ -284,15 +284,13 @@ const emit = defineEmits<{
      * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/model/ProjectModel#event-change)
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Scheduler.model.ProjectModel,any} params.params.event.source This project
-     * @param {Core.data.Store} params.params.event.store Affected store
-     * @param {'remove','removeAll','add','clearchanges','filter','update','dataset','replace'} params.params.event.action Name of action which triggered the change. May be one of:  * `'remove'` * `'removeAll'` * `'add'` * `'clearchanges'` * `'filter'` * `'update'` * `'dataset'` * `'replace'`
-     * @param {Core.data.Model} params.params.event.record Changed record, for actions that affects exactly one record (`'update'`)
-     * @param {Core.data.Model[]} params.params.event.records Changed records, passed for all actions except `'removeAll'`
-     * @param {object} params.params.event.changes Passed for the `'update'` action, info on which record fields changed
+     * @param {object} params.event Event object
+     * @param {Scheduler.model.ProjectModel,any} params.event.source This project
+     * @param {Core.data.Store} params.event.store Affected store
+     * @param {'remove','removeAll','add','clearchanges','filter','update','dataset','replace'} params.event.action Name of action which triggered the change. May be one of:  * `'remove'` * `'removeAll'` * `'add'` * `'clearchanges'` * `'filter'` * `'update'` * `'dataset'` * `'replace'`
+     * @param {Core.data.Model} params.event.record Changed record, for actions that affects exactly one record (`'update'`)
+     * @param {Core.data.Model[]} params.event.records Changed records, passed for all actions except `'removeAll'`
+     * @param {object} params.event.changes Passed for the `'update'` action, info on which record fields changed
      */
     (e: 'change', params: ((event: { source: ProjectModel|any, store: Store, action: 'remove'|'removeAll'|'add'|'clearchanges'|'filter'|'update'|'dataset'|'replace', record: Model, records: Model[], changes: object }) => void)|string): void
     /**
@@ -300,12 +298,10 @@ const emit = defineEmits<{
      * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/model/ProjectModel#event-dataReady)
      * @param {string} e Event name
      * @param {object} params Event parameters
-     * @param {string} params.e Event name
-     * @param {object} params.params Event parameters
-     * @param {object} params.params.event Event object
-     * @param {Scheduler.model.ProjectModel,any} params.params.event.source The project
-     * @param {boolean} params.params.event.isInitialCommit Flag that shows if this commit is initial
-     * @param {Set<any>} params.params.event.records Set of all [Model](https://bryntum.com/products/scheduler/docs/api/Core/data/Model)s that were modified in the completed transaction. Use the [modifications](https://bryntum.com/products/scheduler/docs/api/Core/data/Model#property-modifications) property of each Model to identify modified fields.
+     * @param {object} params.event Event object
+     * @param {Scheduler.model.ProjectModel,any} params.event.source The project
+     * @param {boolean} params.event.isInitialCommit Flag that shows if this commit is initial
+     * @param {Set<any>} params.event.records Set of all [Model](https://bryntum.com/products/scheduler/docs/api/Core/data/Model)s that were modified in the completed transaction. Use the [modifications](https://bryntum.com/products/scheduler/docs/api/Core/data/Model#property-modifications) property of each Model to identify modified fields.
      */
     (e: 'dataReady', params: ((event: { source: ProjectModel|any, isInitialCommit: boolean, records: Set<any> }) => void)|string): void
 }>();

package/src/components/BryntumSchedulerProps.ts

@@ -58,6 +58,8 @@ export declare type BryntumSchedulerProps = {
     /**
      * 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/scheduler/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/scheduler/docs/api/Scheduler/view/Scheduler#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -665,10 +667,14 @@ export declare type BryntumSchedulerProps = {
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/view/Scheduler#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/scheduler/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/scheduler/docs/api/Scheduler/view/Scheduler#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -921,7 +927,12 @@ export declare type BryntumSchedulerProps = {
      * Can be omitted in favor of individual store configs or [crudManager](https://bryntum.com/products/scheduler/docs/api/Scheduler/view/mixin/SchedulerStores#config-crudManager) config.
      * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/view/Scheduler#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'`.