@bryntum/schedulerpro-vue-3 7.3.0 → 7.3.2

package/src/components/BryntumSchedulerProProjectModel.vue

@@ -10,7 +10,7 @@
 
 import { getCurrentInstance, onBeforeUnmount, onMounted, provide, ref, watch, toRaw } from 'vue';
 
-import type { AbstractCrudManager, AssignmentModel, AssignmentModelConfig, AssignmentStore, AssignmentStoreConfig, Base, CalendarManagerStore, CalendarManagerStoreConfig, CalendarModel, CalendarModelConfig, CoreStateTrackingManager, CrudManagerRequestResponse, CrudManagerStoreDescriptor, DependencyModel, DependencyModelConfig, DependencyStore, DependencyStoreConfig, DurationUnit, EventModel, EventModelConfig, EventStore, EventStoreConfig, LazyLoadCrudManagerRequestParams, Model, ModelConfig, ProjectModelListeners, ResourceAllocationInfo, ResourceModel, ResourceModelConfig, ResourceStore, ResourceStoreConfig, ResourceTimeRangeModel, ResourceTimeRangeModelConfig, ResourceTimeRangeStore, ResourceTimeRangeStoreConfig, SchedulerProjectModel, StateTrackingManagerConfig, Store, StoreConfig, TimeRangeStore, TimeSpan, TimeSpanConfig } from '@bryntum/schedulerpro';
+import type { AbstractCrudManager, AssignmentModel, AssignmentModelConfig, AssignmentStore, AssignmentStoreConfig, Base, CalendarManagerStore, CalendarManagerStoreConfig, CalendarModel, CalendarModelConfig, CoreStateTrackingManager, CrudManagerRequestResponse, CrudManagerStoreDescriptor, DependencyModel, DependencyModelConfig, DependencyStore, DependencyStoreConfig, DurationUnit, EventModel, EventModelConfig, EventStore, EventStoreConfig, FetchCredentials, HttpMethod, LazyLoadCrudManagerRequestParams, Model, ModelConfig, ProjectModelListeners, ResourceAllocationInfo, ResourceModel, ResourceModelConfig, ResourceStore, ResourceStoreConfig, ResourceTimeRangeModel, ResourceTimeRangeModelConfig, ResourceTimeRangeStore, ResourceTimeRangeStoreConfig, SchedulerProjectModel, StateTrackingManagerConfig, Store, StoreConfig, TimeRangeStore, TimeSpan, TimeSpanConfig } from '@bryntum/schedulerpro';
 import { ProjectModel } from '@bryntum/schedulerpro';
 
 import { WrapperHelper } from '../helper/WrapperHelper';
@@ -115,6 +115,7 @@ defineProps<{
     /**
      * The initial data, to fill the [calendarManagerStore](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/model/ProjectModel#property-calendarManagerStore) with.
      * Should be an array of [CalendarModel](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/model/CalendarModel) or its configuration objects.
+     * @deprecated 6.3.0 Use [calendars](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/model/ProjectModel#config-calendars) instead
      */
     calendarsData ? : CalendarModel[]
     /**
@@ -277,12 +278,11 @@ defineProps<{
      * If set to `true`, or a config object, this makes the CrudManager load records only when needed. When a record
      * or a date range that is not already loaded is requested, a load request will be made to the specified URL.
      * More more details about lazy loading, see the [guide](https://bryntum.com/products/schedulerpro/docs/api/Grid/guides/data/lazyloading.md)
-     * @param {object} lazyLoad Lazy load config
-     * @param {number} lazyLoad.chunkSize The number of records to be loaded before and after the requested index (only affects the ResourceStore).
+     * @param {number} chunkSize The number of records to be loaded before and after the requested index (only affects the ResourceStore).
      * @param {DurationUnit} bufferUnit Used together with bufferAmount to calculate the start and end dates of each load request. The value is added to the current visible start or end date. Defaults to the visible time span length (does not affect ResourceStore).
      * @param {number} bufferAmount See `bufferUnit`
      */
-    lazyLoad ? : Boolean|{ lazyLoad: { chunkSize: number }, bufferUnit: DurationUnit, bufferAmount: number }
+    lazyLoad ? : Boolean|{ chunkSize: number, bufferUnit: DurationUnit, bufferAmount: number }
     /**
      * The listener set for this object.
      * [More...](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/model/ProjectModel#config-listeners)
@@ -549,18 +549,20 @@ defineProps<{
      * [More...](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/model/ProjectModel#config-transport)
      * @property {object} [transport.load] Load requests configuration:
      * @property {string} [transport.load.url] URL to request for data loading.
-     * @property {string} [transport.load.method] HTTP method to be used for load requests.
+     * @property {HttpMethod} [transport.load.method] HTTP method to be used for load requests.
+     * @property {FetchCredentials} [transport.load.credentials] The request credentials option to use for load requests. Corresponds to the standard <a href="https://developer.mozilla.org/en-US/docs/Web/API/Request/credentials">Fetch API `credentials`</a> option.
      * @property {string} [transport.load.paramName] Name of the parameter that will contain a serialized `load` request. The value is mandatory for requests using `GET` method (default for `load`) so if the value is not provided `data` string is used as default. This value is optional for HTTP methods like `POST` and `PUT`, the request body will be used for data transferring in these cases.
      * @property {object} [transport.load.params] An object containing extra HTTP parameters to pass to the server when sending a `load` request. ```javascript transport : {     load : {         url       : 'http://mycool-server.com/load.php',         // HTTP request parameter used to pass serialized "load"-requests         paramName : 'data',         // pass extra HTTP request parameter         // so resulting URL will look like: http://mycool-server.com/load.php?userId=123456&data=...         params    : {             userId : '123456'         }     },     ... } ```
      * @property {Record<string, string>} [transport.load.headers] An object containing headers to pass to each server request. ```javascript transport : {     load : {         url       : 'http://mycool-server.com/load.php',         // HTTP request parameter used to pass serialized "load"-requests         paramName : 'data',         // specify Content-Type for "load" requests         headers   : {             'Content-Type' : 'application/json'         }     },     ... } ```
      * @property {object} [transport.sync] Sync requests (`sync` in further text) configuration:
      * @property {string} [transport.sync.url] URL to request for `sync`.
-     * @property {string} [transport.sync.method] HTTP request method to be used for `sync`.
+     * @property {HttpMethod} [transport.sync.method] HTTP request method to be used for `sync`.
+     * @property {FetchCredentials} [transport.sync.credentials] The request credentials option to use for sync requests. Corresponds to the standard <a href="https://developer.mozilla.org/en-US/docs/Web/API/Request/credentials">Fetch API `credentials`</a> option.
      * @property {string} [transport.sync.paramName] Name of the parameter in which `sync` data will be transferred. This value is optional for requests using methods like `POST` and `PUT`, the request body will be used for data transferring in this case (default for `sync`). And the value is mandatory for requests using `GET` method (if the value is not provided `data` string will be used as fallback).
      * @property {object} [transport.sync.params] HTTP parameters to pass with an HTTP request handling `sync`. ```javascript transport : {     sync : {         url    : 'http://mycool-server.com/sync.php',         // extra HTTP request parameter         params : {             userId : '123456'         }     },     ... } ```
      * @property {Record<string, string>} [transport.sync.headers] HTTP headers to pass with an HTTP request handling `sync`. ```javascript transport : {     sync : {         url     : 'http://mycool-server.com/sync.php',         // specify Content-Type for "sync" requests         headers : {             'Content-Type' : 'application/json'         }     },     ... } ```
      */
-    transport ? : { load?: { url?: string, method?: string, paramName?: string, params?: object, headers?: Record<string, string> }, sync?: { url?: string, method?: string, paramName?: string, params?: object, headers?: Record<string, string> } }
+    transport ? : { load?: { url?: string, method?: HttpMethod, credentials?: FetchCredentials, paramName?: string, params?: object, headers?: Record<string, string> }, sync?: { url?: string, method?: HttpMethod, credentials?: FetchCredentials, paramName?: string, params?: object, headers?: Record<string, string> } }
     /**
      * By default, the stores of a project use the raw data objects passed to them as the data source for their
      * records if data is loaded remotely (using an `AjaxStore` or a `CrudManager`). For data supplied inline,
@@ -604,7 +606,7 @@ const emit = defineEmits<{
      * @param {Scheduler.crud.AbstractCrudManager} params.event.source The CRUD manager.
      * @param {object} params.event.pack The data package which contains data for all stores managed by the crud manager.
      */
-    (e: 'beforeLoad', params: ((event: { source: AbstractCrudManager, pack: object }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeLoad', params: ((event: { source: AbstractCrudManager, pack: object }) => boolean|void)|string): boolean|void
     /**
      * Fires before loaded data get applied to the stores. Return `false` to prevent data applying.
      * This event can be used for server data preprocessing. To achieve it user can modify the `response` object.
@@ -615,7 +617,7 @@ const emit = defineEmits<{
      * @param {object} params.event.response The decoded server response object.
      * @param {object} params.event.options Options provided to the [load](https://bryntum.com/products/schedulerpro/docs/api/Scheduler/crud/AbstractCrudManagerMixin#function-load) method.
      */
-    (e: 'beforeLoadApply', params: ((event: { source: AbstractCrudManager, response: object, options: object }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeLoadApply', params: ((event: { source: AbstractCrudManager, response: object, options: object }) => boolean|void)|string): boolean|void
     /**
      * Fires before server response gets applied to the stores. Return `false` to prevent data applying.
      * This event can be used for server data preprocessing. To achieve it user can modify the `response` object.
@@ -626,7 +628,7 @@ const emit = defineEmits<{
      * @param {'sync','load'} params.event.requestType The request type (`sync` or `load`).
      * @param {object} params.event.response The decoded server response object.
      */
-    (e: 'beforeResponseApply', params: ((event: { source: AbstractCrudManager, requestType: 'sync'|'load', response: object }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeResponseApply', params: ((event: { source: AbstractCrudManager, requestType: 'sync'|'load', response: object }) => boolean|void)|string): boolean|void
     /**
      * Fires before a request is sent to the server.
      * [More...](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/model/ProjectModel#event-beforeSend)
@@ -658,7 +660,7 @@ const emit = defineEmits<{
      * @param {Scheduler.crud.AbstractCrudManager} params.event.source The CRUD manager.
      * @param {object} params.event.response The decoded server response object.
      */
-    (e: 'beforeSyncApply', params: ((event: { source: AbstractCrudManager, response: object }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeSyncApply', params: ((event: { source: AbstractCrudManager, response: object }) => boolean|void)|string): boolean|void
     /**
      * Fires when any other event is fired from the object.
      * [More...](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/model/ProjectModel#event-catchAll)
@@ -745,9 +747,10 @@ const emit = defineEmits<{
      * @param {object} params.event.response The decoded server response object.
      * @param {object} params.event.responseOptions [DEPRECATED] see `requestOptions`
      * @param {object} params.event.requestOptions The request options passed to the request.
+     * @param {object} params.event.options The options provided to the [load](https://bryntum.com/products/schedulerpro/docs/api/Scheduler/crud/AbstractCrudManagerMixin#function-load) method.
      * @param {Response} params.event.rawResponse The native Response object
      */
-    (e: 'load', params: ((event: { source: AbstractCrudManager, response: object, responseOptions: object, requestOptions: object, rawResponse: Response }) => void)|string): void
+    (e: 'load', params: ((event: { source: AbstractCrudManager, response: object, responseOptions: object, requestOptions: object, options: object, rawResponse: Response }) => void)|string): void
     /**
      * Fired after [load request](https://bryntum.com/products/schedulerpro/docs/api/Scheduler/crud/AbstractCrudManagerMixin#function-load) was canceled by some [beforeLoad](#Scheduler/crud/AbstractCrudManagerMixin#event-beforeLoad)
      * listener or due to incomplete prior load request.
@@ -768,9 +771,10 @@ const emit = defineEmits<{
      * @param {string} params.event.responseText The raw server response text
      * @param {object} params.event.responseOptions [DEPRECATED] see `requestOptions`
      * @param {object} params.event.requestOptions The request options passed to the request.
+     * @param {object} params.event.options The options provided to the [load](https://bryntum.com/products/schedulerpro/docs/api/Scheduler/crud/AbstractCrudManagerMixin#function-load) method.
      * @param {Response} params.event.rawResponse The native Response object
      */
-    (e: 'loadFail', params: ((event: { source: AbstractCrudManager, response: object, responseText: string, responseOptions: object, requestOptions: object, rawResponse: Response }) => void)|string): void
+    (e: 'loadFail', params: ((event: { source: AbstractCrudManager, response: object, responseText: string, responseOptions: object, requestOptions: object, options: object, rawResponse: Response }) => void)|string): void
     /**
      * Fires when registered stores get into state when they don't have any
      * not persisted change. This happens after [load](https://bryntum.com/products/schedulerpro/docs/api/Scheduler/crud/AbstractCrudManagerMixin#function-load) or [sync](#Scheduler/crud/AbstractCrudManagerMixin#function-sync) request

package/src/components/BryntumSchedulerProProjectModelProps.ts

@@ -1,4 +1,4 @@
-import type { AssignmentModel, AssignmentModelConfig, AssignmentStore, AssignmentStoreConfig, CalendarManagerStore, CalendarManagerStoreConfig, CalendarModel, CalendarModelConfig, CoreStateTrackingManager, CrudManagerRequestResponse, CrudManagerStoreDescriptor, DependencyModel, DependencyModelConfig, DependencyStore, DependencyStoreConfig, DurationUnit, EventModel, EventModelConfig, EventStore, EventStoreConfig, LazyLoadCrudManagerRequestParams, Model, ModelConfig, ProjectModelListeners, ResourceAllocationInfo, ResourceModel, ResourceModelConfig, ResourceStore, ResourceStoreConfig, ResourceTimeRangeModel, ResourceTimeRangeModelConfig, ResourceTimeRangeStore, ResourceTimeRangeStoreConfig, StateTrackingManagerConfig, Store, StoreConfig, TimeRangeStore, TimeSpan, TimeSpanConfig } from '@bryntum/schedulerpro';
+import type { AssignmentModel, AssignmentModelConfig, AssignmentStore, AssignmentStoreConfig, CalendarManagerStore, CalendarManagerStoreConfig, CalendarModel, CalendarModelConfig, CoreStateTrackingManager, CrudManagerRequestResponse, CrudManagerStoreDescriptor, DependencyModel, DependencyModelConfig, DependencyStore, DependencyStoreConfig, DurationUnit, EventModel, EventModelConfig, EventStore, EventStoreConfig, FetchCredentials, HttpMethod, LazyLoadCrudManagerRequestParams, Model, ModelConfig, ProjectModelListeners, ResourceAllocationInfo, ResourceModel, ResourceModelConfig, ResourceStore, ResourceStoreConfig, ResourceTimeRangeModel, ResourceTimeRangeModelConfig, ResourceTimeRangeStore, ResourceTimeRangeStoreConfig, StateTrackingManagerConfig, Store, StoreConfig, TimeRangeStore, TimeSpan, TimeSpanConfig } from '@bryntum/schedulerpro';
 import {  } from '@bryntum/schedulerpro';
 
 export declare type BryntumSchedulerProProjectModelProps = {
@@ -101,6 +101,7 @@ export declare type BryntumSchedulerProProjectModelProps = {
     /**
      * The initial data, to fill the [calendarManagerStore](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/model/ProjectModel#property-calendarManagerStore) with.
      * Should be an array of [CalendarModel](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/model/CalendarModel) or its configuration objects.
+     * @deprecated 6.3.0 Use [calendars](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/model/ProjectModel#config-calendars) instead
      */
     calendarsData ? : CalendarModel[]
     /**
@@ -263,12 +264,11 @@ export declare type BryntumSchedulerProProjectModelProps = {
      * If set to `true`, or a config object, this makes the CrudManager load records only when needed. When a record
      * or a date range that is not already loaded is requested, a load request will be made to the specified URL.
      * More more details about lazy loading, see the [guide](https://bryntum.com/products/schedulerpro/docs/api/Grid/guides/data/lazyloading.md)
-     * @param {object} lazyLoad Lazy load config
-     * @param {number} lazyLoad.chunkSize The number of records to be loaded before and after the requested index (only affects the ResourceStore).
+     * @param {number} chunkSize The number of records to be loaded before and after the requested index (only affects the ResourceStore).
      * @param {DurationUnit} bufferUnit Used together with bufferAmount to calculate the start and end dates of each load request. The value is added to the current visible start or end date. Defaults to the visible time span length (does not affect ResourceStore).
      * @param {number} bufferAmount See `bufferUnit`
      */
-    lazyLoad ? : Boolean|{ lazyLoad: { chunkSize: number }, bufferUnit: DurationUnit, bufferAmount: number }
+    lazyLoad ? : Boolean|{ chunkSize: number, bufferUnit: DurationUnit, bufferAmount: number }
     /**
      * The listener set for this object.
      * [More...](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/model/ProjectModel#config-listeners)
@@ -535,18 +535,20 @@ export declare type BryntumSchedulerProProjectModelProps = {
      * [More...](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/model/ProjectModel#config-transport)
      * @property {object} [transport.load] Load requests configuration:
      * @property {string} [transport.load.url] URL to request for data loading.
-     * @property {string} [transport.load.method] HTTP method to be used for load requests.
+     * @property {HttpMethod} [transport.load.method] HTTP method to be used for load requests.
+     * @property {FetchCredentials} [transport.load.credentials] The request credentials option to use for load requests. Corresponds to the standard <a href="https://developer.mozilla.org/en-US/docs/Web/API/Request/credentials">Fetch API `credentials`</a> option.
      * @property {string} [transport.load.paramName] Name of the parameter that will contain a serialized `load` request. The value is mandatory for requests using `GET` method (default for `load`) so if the value is not provided `data` string is used as default. This value is optional for HTTP methods like `POST` and `PUT`, the request body will be used for data transferring in these cases.
      * @property {object} [transport.load.params] An object containing extra HTTP parameters to pass to the server when sending a `load` request. ```javascript transport : {     load : {         url       : 'http://mycool-server.com/load.php',         // HTTP request parameter used to pass serialized "load"-requests         paramName : 'data',         // pass extra HTTP request parameter         // so resulting URL will look like: http://mycool-server.com/load.php?userId=123456&data=...         params    : {             userId : '123456'         }     },     ... } ```
      * @property {Record<string, string>} [transport.load.headers] An object containing headers to pass to each server request. ```javascript transport : {     load : {         url       : 'http://mycool-server.com/load.php',         // HTTP request parameter used to pass serialized "load"-requests         paramName : 'data',         // specify Content-Type for "load" requests         headers   : {             'Content-Type' : 'application/json'         }     },     ... } ```
      * @property {object} [transport.sync] Sync requests (`sync` in further text) configuration:
      * @property {string} [transport.sync.url] URL to request for `sync`.
-     * @property {string} [transport.sync.method] HTTP request method to be used for `sync`.
+     * @property {HttpMethod} [transport.sync.method] HTTP request method to be used for `sync`.
+     * @property {FetchCredentials} [transport.sync.credentials] The request credentials option to use for sync requests. Corresponds to the standard <a href="https://developer.mozilla.org/en-US/docs/Web/API/Request/credentials">Fetch API `credentials`</a> option.
      * @property {string} [transport.sync.paramName] Name of the parameter in which `sync` data will be transferred. This value is optional for requests using methods like `POST` and `PUT`, the request body will be used for data transferring in this case (default for `sync`). And the value is mandatory for requests using `GET` method (if the value is not provided `data` string will be used as fallback).
      * @property {object} [transport.sync.params] HTTP parameters to pass with an HTTP request handling `sync`. ```javascript transport : {     sync : {         url    : 'http://mycool-server.com/sync.php',         // extra HTTP request parameter         params : {             userId : '123456'         }     },     ... } ```
      * @property {Record<string, string>} [transport.sync.headers] HTTP headers to pass with an HTTP request handling `sync`. ```javascript transport : {     sync : {         url     : 'http://mycool-server.com/sync.php',         // specify Content-Type for "sync" requests         headers : {             'Content-Type' : 'application/json'         }     },     ... } ```
      */
-    transport ? : { load?: { url?: string, method?: string, paramName?: string, params?: object, headers?: Record<string, string> }, sync?: { url?: string, method?: string, paramName?: string, params?: object, headers?: Record<string, string> } }
+    transport ? : { load?: { url?: string, method?: HttpMethod, credentials?: FetchCredentials, paramName?: string, params?: object, headers?: Record<string, string> }, sync?: { url?: string, method?: HttpMethod, credentials?: FetchCredentials, paramName?: string, params?: object, headers?: Record<string, string> } }
     /**
      * By default, the stores of a project use the raw data objects passed to them as the data source for their
      * records if data is loaded remotely (using an `AjaxStore` or a `CrudManager`). For data supplied inline,

package/src/components/BryntumSchedulerProProps.ts

@@ -57,6 +57,8 @@ export declare type BryntumSchedulerProProps = {
     /**
      * 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/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/view/SchedulerPro#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -683,10 +685,14 @@ export declare type BryntumSchedulerProProps = {
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/view/SchedulerPro#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/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/view/SchedulerPro#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -937,7 +943,12 @@ export declare type BryntumSchedulerProProps = {
     /**
      * A [ProjectModel](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/model/ProjectModel) instance or a config object. The project holds all SchedulerPro data.
      */
-    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
     /**
      * Accepts the following values:
      * [More...](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/view/SchedulerPro#config-projectProgressReporting)

package/src/components/BryntumSchedulerProps.ts

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

package/src/components/BryntumSchedulingDirectionPicker.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/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/widget/SchedulingDirectionPicker#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -104,6 +106,15 @@ defineProps<{
      * Set to `true` to centre the Widget in browser viewport space.
      */
     centered ? : Boolean
+    /**
+     * 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/schedulerpro/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/widget/SchedulingDirectionPicker#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity ? : ((field: Field) => void)|string
     /**
      * A config object to configure the [ChipView](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/ChipView) to display the
      * selected value set when [multiSelect](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
@@ -397,10 +408,14 @@ defineProps<{
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/widget/SchedulingDirectionPicker#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/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/widget/SchedulingDirectionPicker#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -815,7 +830,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
@@ -1003,6 +1018,7 @@ const widgetData = {
         'cacheLastResult',
         'caseSensitive',
         'centered',
+        'checkValidity',
         'chipView',
         'clearable',
         'clearTextOnPickerHide',

package/src/components/BryntumSchedulingDirectionPickerProps.ts

@@ -28,6 +28,8 @@ export declare type BryntumSchedulingDirectionPickerProps = {
     /**
      * 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/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/widget/SchedulingDirectionPicker#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -90,6 +92,15 @@ export declare type BryntumSchedulingDirectionPickerProps = {
      * Set to `true` to centre the Widget in browser viewport space.
      */
     centered ? : Boolean
+    /**
+     * 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/schedulerpro/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/widget/SchedulingDirectionPicker#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity ? : ((field: Field) => void)|string
     /**
      * A config object to configure the [ChipView](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/ChipView) to display the
      * selected value set when [multiSelect](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
@@ -383,10 +394,14 @@ export declare type BryntumSchedulingDirectionPickerProps = {
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/widget/SchedulingDirectionPicker#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/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/widget/SchedulingDirectionPicker#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**

package/src/components/BryntumSchedulingModePicker.vue

@@ -48,6 +48,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/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/widget/SchedulingModePicker#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -110,6 +112,15 @@ defineProps<{
      * Set to `true` to centre the Widget in browser viewport space.
      */
     centered ? : Boolean
+    /**
+     * 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/schedulerpro/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/widget/SchedulingModePicker#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity ? : ((field: Field) => void)|string
     /**
      * A config object to configure the [ChipView](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/ChipView) to display the
      * selected value set when [multiSelect](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
@@ -403,10 +414,14 @@ defineProps<{
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/widget/SchedulingModePicker#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/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/widget/SchedulingModePicker#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -821,7 +836,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
@@ -1010,6 +1025,7 @@ const widgetData = {
         'cacheLastResult',
         'caseSensitive',
         'centered',
+        'checkValidity',
         'chipView',
         'clearable',
         'clearTextOnPickerHide',

package/src/components/BryntumSchedulingModePickerProps.ts

@@ -34,6 +34,8 @@ export declare type BryntumSchedulingModePickerProps = {
     /**
      * 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/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/widget/SchedulingModePicker#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -96,6 +98,15 @@ export declare type BryntumSchedulingModePickerProps = {
      * Set to `true` to centre the Widget in browser viewport space.
      */
     centered ? : Boolean
+    /**
+     * 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/schedulerpro/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/schedulerpro/docs/api/SchedulerPro/widget/SchedulingModePicker#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity ? : ((field: Field) => void)|string
     /**
      * A config object to configure the [ChipView](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/ChipView) to display the
      * selected value set when [multiSelect](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
@@ -389,10 +400,14 @@ export declare type BryntumSchedulingModePickerProps = {
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/widget/SchedulingModePicker#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/schedulerpro/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/schedulerpro/docs/api/SchedulerPro/widget/SchedulingModePicker#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**

package/src/components/BryntumSlideToggle.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/schedulerpro/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/schedulerpro/docs/api/Core/widget/SlideToggle#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/schedulerpro/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/SlideToggle#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/schedulerpro/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/schedulerpro/docs/api/Core/widget/SlideToggle#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/schedulerpro/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/schedulerpro/docs/api/Core/widget/SlideToggle#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/BryntumSlideToggleProps.ts

@@ -28,6 +28,8 @@ export declare type BryntumSlideToggleProps = {
     /**
      * 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/schedulerpro/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/schedulerpro/docs/api/Core/widget/SlideToggle#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -94,6 +96,15 @@ export declare type BryntumSlideToggleProps = {
      * 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/schedulerpro/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/schedulerpro/docs/api/Core/widget/SlideToggle#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
@@ -282,10 +293,14 @@ export declare type BryntumSlideToggleProps = {
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/schedulerpro/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/schedulerpro/docs/api/Core/widget/SlideToggle#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/schedulerpro/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/schedulerpro/docs/api/Core/widget/SlideToggle#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**

package/src/components/BryntumSlider.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/schedulerpro/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/schedulerpro/docs/api/Core/widget/Slider#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -213,10 +215,14 @@ defineProps<{
     ignoreParentReadOnly ? : Boolean
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/schedulerpro/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/schedulerpro/docs/api/Core/widget/Slider#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/schedulerpro/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/schedulerpro/docs/api/Core/widget/Slider#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -512,7 +518,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